Editing Quickstart:Customise EPrints (section)

= Site Look and Feel =
To make an EPrints Repository feel like your own, you will want to change the look and feel of different parts of the site, below we detail where different parts are controlled and link out to more in depth guides on how to achieve these customisations.
== Templates ==
=== Site Templates ===
EPrints has 'Global' templates used to wrap page content, generally these contain your header and footer and little else (you can of course add anything you want!). There is one used for public facing pages, and one for back end pages giving the option for a different interface for admin actions. Often these two templates are identical, even symlinking one to the other.

<p>Both templates can be found here:</p>
<code> /opt/eprints3/archives/ARCHIVE_ID/cfg/lang/en/templates/</code>
<p><i>(make sure to replace <code>ARCHIVE_ID</code> with your archive name, the name of the directory you created in <code>/opt/eprints3/archives/</code>)</i><br/></p>
<p><i>(if they're not, copy them from <code>/opt/eprints3/lib/templates/</code> into the directory above (which you may need to create))</i></p>

==== File Names ====
<p>The public template is <code>default.xml</code>.</p>

<p>The back end template is <code>default_internal.xml</code>.</p>

==== Re-Generate Pages ====
<p>After updating your global template you will need to run</p>
 /opt/eprints3/bin/generate_static ARCHIVE_ID
 /opt/eprints3/bin/generate_views ARCHIVE_ID
 /opt/eprints3/bin/generate_abstracts ARCHIVE_ID
<p>to regenerate the pages across the site.</p>

=== Static Pages ===
<p>Static pages use the global templates (see [#Site_Templates |above]) as a wrapper for the content they contain. The content can be modified by editing the relevant file, the most prominant static page is the homepage, the template file for it is <code>index.xpage</code> and can be found at <code>/opt/eprints3/lib/themes/example/lang/en/static/index.xpage</code>. It should be copied to <code>/opt/eprints3/archives/ARCHIVE_ID/cfg/lang/en/static/</code> before being modified. Additional templates can  be created in the same archive level <code>/static</code> directory for other pages.</p>
==== Re-Generate Pages ====
<p>After updating your template you will need to run <code>/opt/eprints3/bin/generate_static ARCHIVE_ID</code> to regenerate the pages</p>
==== Find out More ====
<p>Find out more about static pages [[How_to_modify_static_pages | here]].</p>

=== Custom Files ===
<p>As well as the template files, you may want to have custom CSS or Javascript that is used across the site and images included on various pages.</p>
==== CSS ====
<p>Your CSS styles should go in <code>/opt/eprints3/archives/ARCHIVE_ID/cfg/static/style/auto/zzz_local.css</code>.</p>
<p>You can create additional CSS files if you need.</p>
<p><i>Note: Files are loaded in alphabetical order, hence the zzz_ prefix.</i></p>

==== Javascript ====
<p>Your custom Javascript should go in <code>/opt/eprints3/archives/ARCHIVE_ID/cfg/static/javascript/auto/90_local.js</code>.</p>
<p>You can create additional .js files if you need.</p>
<p><i>Note: Files are loaded in alphabetical order, hence the 90_ prefix.</i></p>

==== Media ====
<p>Images for your site should go in <code>/opt/eprints3/archives/ARCHIVE_ID/cfg/static/images/</code>.<p>
<p>You can then load your images from <code><nowiki>http://ARCHIVE_ID.your_domain_here.net/images/EXAMPLE_IMAGE.jpg</nowiki></code> eg: <code><nowiki>https://demo.eprints-hosting.org/images/eprintslogo.png</nowiki></code>

== Find Out More ==
You can find out more in our templating guide, [[Branding_with_confidence | Branding with Confidence]]