Das Plone-Nutzerhandbuch enthält eine Buildout-Konfigurationsdatei, mit der sich die Inhalte des Plone-Nutzerhandbuchs in eine Plone-Site überführen lassen. Dabei wird eine Pipeline für collective.transmogrifier definiert, die die Inhalte als Reference Manual des Plone Help Center erstellt.
Linux
$ sudo apt-get install git-core
Mac
$ sudo port install git-core
Erstellen der Dokumentation
Dies ist in Installation des Plone-Nutzerhandbuchs beschrieben.
Installation der Migrationsskripte
$ ./bin/buildout -c migration.cfg
Dies erzeugt das Skript bin/migration.
Aufrufen des Skripts mit:
$ ./bin/migration --ploneupload:target=http://admin:secret@localhost:8080/Plone/documentation/manual/plone-nutzerhandbuch
Bemerkung
In userem Fall wird das Plone-Nutzerhandbuch in eine lokale Plone-Site mit der ID Plone importiert wobei das Plone Help Center die ID documentation und das reference Manual die ID plone-nutzerhandbuch hat. Falls Sie die Dokumentation in eine andere Plone-Site mit anderen HTTP Basic Auth-Credentials importieren möchten, können Sie diese Zeile selbstverständlich entsprechend abändern.
Folgende Schritte werden während der Migration ausgeführt:
Bemerkung
Das Skript zum Hochladen der Dateien überschreibt momentan noch nicht bereits vorhandene Artikel. Falls Seiten umbenannt oder verschoben wurden, sollte zunächst die gesamte Dokumentation gelöscht werden bevor die Dateien erneut hochgeladen werden.
Eine exemplarische CSS-Datei unter styles/sphinx.css. Diese Datei können Sie ggf. für Ihre Plone-Site übernehmen um die folgenden Elemente zu gestalten: