Download - Manakin Themes - Slideset
-
8/4/2019 Manakin Themes - Slideset
1/38
Manakin themes:Customizing the look and feel of DSpace
Alexey Maslov, Cody Green, Adam Mikeal, Scott Phillips, and John Leggett
-
8/4/2019 Manakin Themes - Slideset
2/38
Outline
Overview and theme
components
Creating a new theme
Basic theme development
Complex theme
development
-
8/4/2019 Manakin Themes - Slideset
3/38
Overview and ThemeComponents
1
-
8/4/2019 Manakin Themes - Slideset
4/38
ReviewWhat is Manakin?
What does Manakin do?
How does Manakin do it?
-
8/4/2019 Manakin Themes - Slideset
5/38
Quick Review
-
8/4/2019 Manakin Themes - Slideset
6/38
Quick Review
-
8/4/2019 Manakin Themes - Slideset
7/38
Quick Review
-
8/4/2019 Manakin Themes - Slideset
8/38
What does atheme do?
Convert DRI to a more
usable format
Style the result
-
8/4/2019 Manakin Themes - Slideset
9/38
Themecomponents
Sitemap
The heart of a theme
A configuration file
References other
components
XSL
Converts DRI to HTML
CSS
Styles the resulting HTML
-
8/4/2019 Manakin Themes - Slideset
10/38
Providing your own components
-
8/4/2019 Manakin Themes - Slideset
11/38
Providing your own components
-
8/4/2019 Manakin Themes - Slideset
12/38
Referencing components from elsewhere
-
8/4/2019 Manakin Themes - Slideset
13/38
So what is a theme?
A theme is a tool to convert from a DRI document to a user-
readable format
Uses XSL to convert from DRI XML to XHTML
Styles the result with CSS
The sitemap is the heart of a theme, referencing other
components to actually perform the themes task
Those components are reusable
Some are provided for you
-
8/4/2019 Manakin Themes - Slideset
14/38
Theme Creation
2
-
8/4/2019 Manakin Themes - Slideset
15/38
How do you
create a new
theme?
Create a new directory
and sitemap
Configure the sitemap andprovide the necessary
components
Install the newly created
theme
-
8/4/2019 Manakin Themes - Slideset
16/38
Create
Locate the Themes
directory
Create the new directory
and name it after yournew theme
Copy the contents of the
template into your newly
created theme directory
-
8/4/2019 Manakin Themes - Slideset
17/38
Configure
Editing the
The default template
sitemap is configured to:
use existing XSL
reference CSS files
internationalize the result
using default settings
-
8/4/2019 Manakin Themes - Slideset
18/38
Install
The xmlui.xconf
configuration file
Theme settings
Theme path
URL matching rules:
regex, handle, or both
Theme name
-
8/4/2019 Manakin Themes - Slideset
19/38
Documentation
Theme creation tutorial
www.di.tamu.edu/projects/xmlui/manakin/resources/ThemeTutorial.pdf
Also available from the Manakin source tree
Internal documentation
sitemap.xmapxmlui.xconf
http://www.di.tamu.edu/projects/xmlui/manakin/resources/ThemeTutorial.pdfhttp://www.di.tamu.edu/projects/xmlui/manakin/resources/ThemeTutorial.pdfhttp://www.di.tamu.edu/projects/xmlui/manakin/resources/ThemeTutorial.pdfhttp://www.di.tamu.edu/projects/xmlui/manakin/resources/ThemeTutorial.pdf -
8/4/2019 Manakin Themes - Slideset
20/38
Resultsso far...
Theme created and
installed
Default XSL used
No styling applied
-
8/4/2019 Manakin Themes - Slideset
21/38
Basic ThemeDevelopment
3
-
8/4/2019 Manakin Themes - Slideset
22/38
Tiers review
1. Style Tier
XHTML + CSSCreate simple themes
2. Theme Tier
XSL + XHTML + CSS
Create complex themes
-
8/4/2019 Manakin Themes - Slideset
23/38
Creating a newstyle
Start out with a blank CSS
Make sure the themessitemap references it
Fill it with CSS rules
-
8/4/2019 Manakin Themes - Slideset
24/38
Style Application Overview
-
8/4/2019 Manakin Themes - Slideset
25/38
The mechanics of styling
The sitemap does not apply the CSS to the XHTML
The sitemap adds metadata tags to the pageMeta of the
DRI document that point to the CSS
Once the XSL builds the head element of the XHTML
document, it places the CSS link there
-
8/4/2019 Manakin Themes - Slideset
26/38
So far...
CSS styles applied
Theme created and
installed
Default XSL used
-
8/4/2019 Manakin Themes - Slideset
27/38
Complex ThemeDevelopment
4
-
8/4/2019 Manakin Themes - Slideset
28/38
Tiers review
1. Style Tier
XHTML + CSS
Create simple themes
2. Theme Tier
XSL + XHTML + CSS
Create complex themes
-
8/4/2019 Manakin Themes - Slideset
29/38
How do you
make XSLchanges?
Use existing XSL library
Override individual
templates
-
8/4/2019 Manakin Themes - Slideset
30/38
What is XSL?
-
8/4/2019 Manakin Themes - Slideset
31/38
XSL in Manakin
-
8/4/2019 Manakin Themes - Slideset
32/38
XSL in Manakin
-
8/4/2019 Manakin Themes - Slideset
33/38
XSL in Manakin
-
8/4/2019 Manakin Themes - Slideset
34/38
The specifics of theme XSL imports
The theme template also comes with a token XSL file that is
by default not used in the sitemap
To make your own XSL changesModify the sitemap to include the themes XSL
Copy the template you want to override from structural.xsl to
your themes XSL
Any changes made in the themes XSL will override thetemplate from structural
-
8/4/2019 Manakin Themes - Slideset
35/38
Complete picture
-
8/4/2019 Manakin Themes - Slideset
36/38
So far...
Partially overridden
XSL used
Theme created and
installedCSS styles applied
-
8/4/2019 Manakin Themes - Slideset
37/38
-
8/4/2019 Manakin Themes - Slideset
38/38
Some of the
advancedtopics
Metadata handlers
Non-HTML output formats
Internationalization
Static page insertion
Non-XSL transformations