How to modify static pages
The static web pages are created by combining the .xpage files from /opt/eprints3/archives/ARCHIVEID/cfg/lang/en/static/ with the site template; this is what generate_static does. A custom site template can be installed at opt/eprints3/archives/ARCHIVEID/cfg/lang/en/templates/ (if language-specific) or opt/eprints3/archives/ARCHIVEID/cfg/templates/ (if not); otherwise the default one at opt/eprints3/lib/templates/ will be used.
The generate_static script 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/static/ directory and appear on the website no matter what language the site is in, e.g. images and the style sheet.
Obviously cfg/lang/en/ is intended for English language source files; French source files would go in cfg/lang/fr/ and so on.
- 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
