All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
...
sitemap.xmap
(located at [xmlui]/sitemap.xmap
). This is the main entry point for all requests[xmlui]/themes/themes.xmap
file, which controls all the Themes.themes.xmap
file will then load all "matching" themes which are configured in your [dspace]/config/xmlui.xconf
file (see #Themes below).sitemap.xmap
file (located in its theme directory) is loaded and processed.The theme's sitemap.xmap
is in charge of actually loading the theme's XSLT, CSS, etc. However, before it does that, you'll notice it makes a call to generate the DRI document for the current page as follows:
Code Block |
---|
<map:generate type="file" src="cocoon://DRI/{1}"/> |
sitemap.xmap
(remember how we said that this sitemap is the main entry point for all requests).[xmlui]/aspects/aspects.xmap
file to be loaded. As the name suggests, this file obviously controls all the Aspects.aspects.xmap
file will then load all enabled Aspects which are configured in your [dspace]/config/xmlui.xconf
file (see #Aspects below).sitemap.xmap
is loaded & processeddspace-xmlui-api.jar
file. However, if you have a copy of DSpace source handy, it can be found in: [dspace-src]/dspace-xmlui/dspace-xmlui-api/src/main/resources/aspects/[name-of-aspect]/
or in DSpace 3 and newer in [dspace-src]/dspace-xmlui/src/main/resources/aspects/[name-of-aspect]/
xmlui.xconf
). Each aspect may add, remove or change content within the DRI document. After the final aspect is finished processing, the DRI document is complete.sitemap.xmap
(remember, this is the same location that triggered the loading of the Aspects in the first place).sitemap.xmap
will continue its processing. Generally speaking, most themes will then perform one or more XSLT transformations (to transform the final DRI document into XHTML). They also may load up one or more CSS files to help stylize the final XHTML....
Manakin themes stylize the look-and-feel of the repository, community, or collection and are distributed as self-contained packages. A Manakin/DSpace installation may have multiple themes installed and available to be used in different parts of the repository. The central component of a theme is the sitemap.xmap, which defines what resources are available to the theme such as XSL stylesheets, CSS stylesheets, images, or multimedia files.
1) Create theme skeleton
Most theme developers do not create a new theme from scratch; instead they start from the standard theme template, which defines a skeleton structure for a theme. The template is located at: [dspace-source]/dspace-xmlui/src/main/webbapp/themes/template
(in DSpace 1.8 and older the path is [dspace-source]/dspace-xmlui/dspace-xmlui-webbapp/src/main/webbapp/themes/template). To start your new theme simply copy the theme template into your locally defined modules directory, [dspace-source]/dspace/modules/xmlui/src/main/webbapp/themes/[your theme's directory]/.
2) Modify theme variables
The next step is to modify the theme's parameters so that the theme knows where it is located. Open the [your theme's directory]/sitemap.xmap and look for <global-variables>
...