Difference between revisions of "How to modify static pages"

From EPrints Documentation
Jump to: navigation, search
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Howto]]
+
[[Category:Static Pages]]
 
The static web pages are created by combining the .xpage files from [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/static | /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/static/]] with the site template. The template can be found at [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/templates|opt/eprints3/archives/ARCHIVEID/cfg/lang/en/templates]]. This is what generate_static does.
 
The static web pages are created by combining the .xpage files from [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/static | /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/static/]] with the site template. The template can be found at [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/templates|opt/eprints3/archives/ARCHIVEID/cfg/lang/en/templates]]. This is what generate_static does.
  
Line 10: Line 10:
 
Edit the .xpage file (or other file in /static/)
 
Edit the .xpage file (or other file in /static/)
  
Run [[Bin|generate_static]] ARCHIVEID
+
Run [[Bin/|generate_static]] ARCHIVEID
 +
 
 +
===Issues===
 +
 
 +
The XML Editor encodes all extended characters, with the exception of core HTML ones (e.g. <) -- this causes issues with pages that need to include one of these symbols.  See https://github.com/eprints/eprints/blob/3.3/perl_lib/EPrints/Plugin/Screen/Admin/Config/Edit/XML.pm#L29
 +
 
 +
A set of phrases have been created for html entites to be used in static pages and phrases that can be edited through the front-end tools.  E.g:
 +
 
 +
<source lang='html4strict'>
 +
  <p>Nuts <epc:phrase ref='entity_amp'/> bolts</p>
 +
</source>
 +
 
 +
A [http://bazaar.eprints.org/id/eprint/471 bazaar package] has been created for the following phrases:
 +
 
 +
* entity_amp
 +
* entity_gt
 +
* entity_lt
 +
* entity_quot
 +
* entity_apos
 +
 
 +
See http://bazaar.eprints.org/471/

Revision as of 14:51, 20 December 2016

The static web pages are created by combining the .xpage files from /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/static/ with the site template. The template can be found at opt/eprints3/archives/ARCHIVEID/cfg/lang/en/templates. This is what generate_static does.

Generate static also copies all files which do not have the suffix .xpage from /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/static/

Non-language specific files go in the /opt/eprints3/archives/ARCHIVEID/cfg directory and appear on the website no matter what language the site is in. eg. images and the style sheet.

Obviously french source files go in cfg/lang/fr/ etc.

Edit the .xpage file (or other file in /static/)

Run generate_static ARCHIVEID

Issues

The XML Editor encodes all extended characters, with the exception of core HTML ones (e.g. <) -- this causes issues with pages that need to include one of these symbols. See https://github.com/eprints/eprints/blob/3.3/perl_lib/EPrints/Plugin/Screen/Admin/Config/Edit/XML.pm#L29

A set of phrases have been created for html entites to be used in static pages and phrases that can be edited through the front-end tools. E.g:

  <p>Nuts <epc:phrase ref='entity_amp'/> bolts</p>

A bazaar package has been created for the following phrases:

  • entity_amp
  • entity_gt
  • entity_lt
  • entity_quot
  • entity_apos

See http://bazaar.eprints.org/471/