Erstellen eines Themes
Wir können nun unser neues Theme erstellen indem wir in unserem Buildout-Projekt einen Ordner static erstellen und in diesem das Invention-Theme von Open Source Web Design bereitstellen:
$ cd collective-xdv_buildout $ curl -O http://www.oswd.org/files/designs/3293/Invention.zip $ unzip Invention.zip
Nun erstellen wir in unserem Invention-Ordner noch die rules.xml-Datei mit den Angaben für die XSLT-Transformationen.
Aktivieren und Konfigurieren von collective.xdv
Setzen Sie nun eine neue Plone-Site mit dem Extension-Profile XDV theme support auf und wählen anschließend in deren Plone Control Panel die Konfiguration für das XDV theme-Zusatzprodukt aus:
- Enabled
ändert die XDV-Theme-Transformation.
Aktivieren Sie diese Option.
- Domains
Auf welche Domäne soll die Transformation angewendet werden?
Dabei ist zu berücksichtigen, dass auf 127.0.0.1 aus Sicherheitsgründen nie eine Theme-Transformation angewendet werden kann, sodass Sie immer wieder zu Ihrer Site zurückkehren können auch wenn die Transformationsregeln unbrauchbar werden sollten. Dieses Verhalten kann auch dazu genutzt werden, die CSS3-Selektoren und XPath-Anweisungen für content auszulesen.
Der Standardwert ist localhost:8080
- Theme template
Der Pfad zu einer statischen HTML-Datei. Eine relative Pfadangabe ist immer relativ zum Buildout-Verzeichnis, also z.B.:
Invention/index.html
Neben Pfadangaben im Dateisystem lassen sich hier auch Python-Pfade angeben, z.B.:
python://vs.xdvtheme/static/index.html
- Rules file
Der Pfad zu einer XML-Datei, die die Regeln für die Transformation enthält, also z.B.:
Invention/rules.xml
Auch hier lassen sich wieder Python-Pfade angeben, z.B.:
python://vs.xdvtheme/static/rules.xml
Häufig sind an dieser Stelle keine weiteren Angaben zu machen. Daher speichern wir die Einträge ab und sollten anschließend unsere einfachen XSLT-Transformationen betrachten können:
Im folgenden noch kurz die weiteren Optionen für die XDV theme-Konfiguration:
- Alternate themes
Hier können alternative themes- und rules-Dateien angegeben werden. Die Angabe erfolgt in der Form path|theme|rules.
- path
- Regulärer Ausdruck
- theme
- Dateipfad oder URL
- path
- Pfad zu der Datei, die die XDV-Transformationsregeln bereitstellt.
- Unstyled paths
Pfade, die nicht gestaltet werden sollen wobei die Pfadangaben aus regulären Ausdrücken bestehen sollen, z.B.:
^.*/manage$
- Absolute URL prefix
- konvertiert relative URLs in der theme-Datei zu absouten Pfaden unter Verwendung dieses Präfixes.
- XSLT extension file
- XDV kann erweitert werden um eine eigene XSLT-Datei. Diese kann hier als Pfadangabe oder URL angegeben werden.
- Read network
- Ist diese Option aktiviert, können URLs für die Angabe der rules- und config-Dateien angegeben werden.