Anleitung zur Synchronisation von Animals in einer Wiki-Farm

Zum Aufbau einer Wiki-Farm wird das im Projekt entwickelte Farmer-Plugin genutzt. Um Inhalte zwischen einzelnen Animals einer Farm zu synchronisieren, wird das im Projekt entwickelte Farmsync-Plugin verwendet. Die Synchronisation erfolgt immer über den Farmer selbst im Admin-Bereich: Farming-Updates.

Im Zusammenhang mit dem hier vorliegenden Demo-System bestehen einige Bereiche, die identisch sind zu den Wikis der Pilotanwender im sprintDoc-Projekt. Dazu gehören:

• Methodenbeschreibung unterhalb des Ordners methode:
• generischen Dokumentationsmuster unterhalb des Ordners patterns:

Die Umsetzung der Dokumentationsmuster erfolgt mit dem struct-Plugin, weswegen einige Besonderheiten zu beachten sind:

• Die Synchronisation der der eigentlichen Seiten unterhalb der genannten Namensräume ist einfach. Wie oben im Screenshot ersichtlich, wird die Quelle (z.B. demo) ausgewählt. Anschließend die Ziele angehakt (demo ist hier nicht auswählbar). Anschließend wird der Namensraum (methode:** sowie patterns:** sowohl bei „Pages/Namespaces to update“ als auch „Media/Media-Namespaces to update“ eingetragen. Nach der Bestätigung erfolgt die Synchronisation. Bei Konflikten muss der Nutzer entscheiden, was geschehen soll: Daten behalten oder überschreiben.
• Zusätzlich müssen folgende Dinge manuell abgeglichen werden:
  • struct-Schema-Definitionen:
    • Exportieren der Schema-Definition im Admin-Bereich (Struct Schema Editor) des Quell-Animals (hier z.B. demo) ⇒ Speicherung als JSON-Datei auf dem lokalen Rechner
    • Anlegen der Schema-Definition im Admin-Bereich (Struct Schema Editor) des Ziel-Animals (z.B. Pilotanwender) mit identischem Namen
    • Importieren der lokal gespeicherten JSON-Datei
  • struct-Schema-Assignment:
    • Kopieren des Schema-Assignments im Admin-Bereich (Struct Schema Assignment) über die Zwischenablage aus dem Quell-Animal (hier z.b. demo)
    • Einfügen des Schema-Assignments im Admin-Bereich (Struct Schema Assignment) aus der Zwischenablage im Ziel-Animal (z.B. Pilotanwender)