Branding with confidence - Revision history

LukeWallin: /* Changing the theme */

2025-05-01T13:44:58Z

‎Changing the theme

Drn@ecs.soton.ac.uk at 10:55, 3 March 2022

2022-03-03T10:55:08Z

Drn@ecs.soton.ac.uk: Added info about how to go about editing branding and other config files.

2022-03-03T10:44:17Z

Added info about how to go about editing branding and other config files.

Drn@ecs.soton.ac.uk: /* Adding a logo */

2022-03-03T10:37:18Z

‎Adding a logo

Drn@ecs.soton.ac.uk: Clarified how changing logo example work in real life.

2022-03-03T10:36:32Z

Clarified how changing logo example work in real life.

Tdb01r at 16:21, 27 February 2012

2012-02-27T16:21:51Z

Tdb01r at 16:20, 27 February 2012

2012-02-27T16:20:18Z

Tdb01r: /* Adding dynamic content */

2012-02-27T16:17:39Z

‎Adding dynamic content

Tdb01r: /* Adding extra images */

2012-02-27T16:16:18Z

‎Adding extra images

Tdb01r at 16:16, 27 February 2012

2012-02-27T16:16:03Z

Show changes

← Older revision		Revision as of 13:44, 1 May 2025
Line 66:		Line 66:

	Open the branding configuration file in a text editor:		Open the branding configuration file in a text editor:
		+	(Note if this file does not exist, copy it from lib/cfg.d/branding.pl)

	archives/ARCHIVEID/cfg/cfg.d/branding.pl		archives/ARCHIVEID/cfg/cfg.d/branding.pl

@@ Line 3: / Line 3: @@
 One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.
-It is general advised that you have command line access to the server so you can add/edit these files for branding directly.  Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer.  It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface.  However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.
+It is generally advised that you have command line access to the server so you can add/edit these files for branding directly.  Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer.  It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface.  However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.
 __TOC__

← Older revision		Revision as of 10:44, 3 March 2022
Line 2:		Line 2:

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.
		+
		+	It is general advised that you have command line access to the server so you can add/edit these files for branding directly. Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer. It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface. However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.

	__TOC__		__TOC__

@@ Line 13: / Line 13: @@
 '''Example 1'''
-The simplest approach, which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface, is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:
+The simplest approach, (which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface), is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:
   EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/sitelogo.png

@@ Line 11: / Line 11: @@
 ===Adding a logo===
-'''Example 1
+'''Example 1'''
-The simplest approach is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo to:
+The simplest approach, which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface, is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:
-  archives/ARCHIVEID/cfg/static/images/sitelogo.png
+  EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/sitelogo.png
-And refresh the page. Your logo should now be displayed in place of the default EPrints logo.
+And refresh the web page. Your logo should now be displayed in place of the default EPrints logo.
-'''Example 2
+'''Example 2'''
 The image that EPrints uses for the site logo is defined in the branding configuration file. You can change this setting to point to the logo image on your institution's Web page.
-Open the branding configuration file in a text editor:
+Open the branding configuration file in a text editor (e.g. Vim or Nano) if you are editing it from the command line:
-  archives/ARCHIVEID/cfg/cfg.d/branding.pl
+  EPRINTS_PATH/archives/ARCHIVEID/cfg/cfg.d/branding.pl
 Find the site_logo configuration setting:
@@ Line 41: / Line 45: @@
 Reload the EPrints configuration by typing:
-  bin/epadmin reload ARCHIVEID
+  EPRINTS_PATH/bin/epadmin reload ARCHIVEID
-'''Example 3
+'''Example 3'''
-You can also adjust the site_logo configuration setting to point any local image file. Place a copy of your logo image somewhere in the /opt/eprints3/archives/ARCHIVEID/cfg/static/images/ directory and then update the branding configuration file to point to it.
+You can also adjust the <tt>site_logo</tt> configuration setting to point any local image file using a text editor at the command line. Place a copy (e.g. using SCP of SFTP) of your logo image somewhere in the <tt>EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/</tt> directory and then update the branding configuration file to point to it.
 <source lang="perl">
@@ Line 53: / Line 59: @@
 Reload the EPrints configuration by typing:
-  bin/epadmin reload ARCHIVEID
+  EPRINTS_PATH/bin/epadmin reload ARCHIVEID
 ===Changing the theme===

← Older revision		Revision as of 16:21, 27 February 2012
Line 1:		Line 1:
	[[Category:Branding]]		[[Category:Branding]]
−	~~{{Workswith\|3.3=1}}~~

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

← Older revision		Revision as of 16:20, 27 February 2012
Line 1:		Line 1:
	[[Category:Branding]]		[[Category:Branding]]
		+	{{Workswith\|3.3=1}}

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

@@ Line 358: / Line 358: @@
 Reload the dynamic template configuration:
-  bin/epadmin ARCHIVEID
+  bin/epadmin reload ARCHIVEID
 The date should now be displayed on your repository pages.
 == See also ==
 * [[Branding, the next level]]

@@ Line 208: / Line 208: @@
 <source lang="html4strict">
-<img src="/images/small_logo.gif" />
+<img src="{$config{base_url}}/images/small_logo.gif" />
 </source>