By default, DSpace does not build the Mirage 2 theme (as it lengthens the normal build process). However, you can easily tell DSpace to build Mirage 2 by running the following from your
mvn package -Dmirage2.on=true
If you wish to speed up the Mirage 2 build process, you can do so by pre-installing all of the Mirage 2 dependencies on your system (by default they will be downloaded each time you rebuild Mirage 2). This will significantly shorten the build process for Mirage 2. More information on installing these prerequisites can be found in the Developer Documentation for Mirage 2. Once these prerequisites have been installed on your local server, you can then build Mirage 2 more rapidly by running:
# WARNING: This command will only work if you've manually installed *all* the prerequisites for Mirage 2 mvn package -Dmirage2.on=true -Dmirage2.deps.included=false
Using an exclamation mark character ("!") in Maven directory name will cause a Mirage 2 build to fail. See:
Jira server DuraSpace JIRA serverId c815ca92-fd23-34c2-8fe3-956808caf8c5 key DS-2749
After building Mirage 2, you can install this theme into your DSpace by simply re-running Ant from
To enable Mirage 2, add the following to the
<themes>section of your
xmlui.xconf, replacing the currently active theme:
<theme name="Mirage 2" regex=".*" path="Mirage2/" />
- Finally, restart your Tomcat or servlet container, and you should see the Mirage 2 theme.
Manage your local Mirage 2 customizations or derived themes in:
Managing your local customizations in this folder comes with the advantage that you ONLY need to keep files you have changed, compared to the standard Mirage 2 folder. To get you started, the contributors have added a
The Mirage 2 color scheme
The classic mirage theme is a customization of the bootstrap theme. Thanks to the sass variables, a complete color scheme can be conceived by modifying one or two variables. These variables are set in the theme's
/styles/classic_mirage_color_scheme/_bootstrap_variables.scss. Copy this file into
[dspace-source]/dspace/modules/xmlui-mirage2/src/main/webapp/themes/Mirage2 and see what happens when you change
$brand-primary. More detailed information on how to customize this file can be found in the Mirage 2 readme.
How to reuse an existing bootstrap theme is also explained in that section.
You can make these changes in the bower.json file: bower.json
As mentioned in the previous section, make sure you manage this file and any changes you make to it in
[dspace-source]/dspace/modules/xmlui-mirage2/src/main/webapp/themes/Mirage2). It is not recommended to update the officially distributed bower.json file directly in