Um sich zunächst mit der Oberfläche, den Funktionen und Seitenstrukturen vertraut zu machen, empfehlen wir als Einstiegspunkt den User Guide der offiziellen XWiki Webseite (nur verfügbar auf Englisch). Hier erhalten Sie einen ersten Überblick über den Dienst und dessen grundlegende Basis-Funktionen.

Aufgrund von Sicherheitsrisiken wird DESY-Confluence ab dem 15.02.2024 nicht mehr über das Internet erreichbar sein. DESY-IT wird aber eine Möglichkeit anbieten, Inhalte weiterhin über das Internet weltweit lesend zur Verfügung zu stellen. Details hierzu finden Sie auf folgender Webseite:

https://it.desy.de/dienste/xwiki/voruebergehend_oeffentliche_confluence_inhalte

Bitte beachten Sie, dass ein Account erst in XWiki verfügbar ist, wenn sich mit diesem mindestens ein Mal am Dienst angemeldet wurde. Wenn Sie also einen Account berechtigen möchten, diesen aber nicht auffinden können, bitten Sie die betroffene Person, sich zunächst am Dienst anzumelden. Im Anschluss sollten Sie den Account finden können.

XWiki bietet Seiten-Admins und Erstellern die Möglichkeit für ihre Seiten allgemeine Panels links und rechts (z.B. das Panel für Tips, die Navigation u.ä.) ein- oder auszublenden. Diese Option gilt für die jeweilige Seite und deren Unterseiten. Hierzu gehen Sie wie folgt vor:

1. Klicken Sie rechts oben auf der Seite auf die drei Punkte -> "Manage Page" -> "Look & Feel"
2. Wählen Sie hier das Theme, welches Sie gerne für die Seite übernehmen möchten
3. Anschließend wird das Theme automatisch übernommen

Vorerst werden neue Spaces nur unter Anfrage an uco@desy.de erstellt. Dies soll Sicherstellen, dass es während der Migration nicht zu Namensdopplungen kommt.

Bitte schreibe dem UCO hierfür folgende Angaben:

• "SpaceName", bevorzugter Kurzname (3-5 Zeichen).
• Admin-User(s),
• DESY-Abteilung und
• Gruppen- oder Projektname

Um ein Template, also eine Vorlage für häufig wiederkehrende Seiten, zu erstellen, benötigen Sie Administratorrechte.

Wenn Sie keine Admin-Rechte auf XWiki-Ebene haben, erstellen Sie bitte eine Seite nach Ihren Wünschen (einen Dummy) und kontaktieren Sie einen Admin.

Eine ausführliche Anleitung finden Sie hier unter „Inhalt“.

In XWiki kann eine Tabelle unterschiedlich erstellt und dementsprechend unterschiedlich eingefärbt werden:
 

Wenn die Tabelle über den "Tabellen-Button" erstellt wurde:

Mit Rechtsklick auf eine Zelle lassen sich unter "Table Properties" die Tabelleneigenschaften öffnen. Mit einem Klick auf "Advanced" lassen sich im Feld "Style" in HTML-Syntax Einstellungen vornehmen, z.B. background-color:yellow .

Um einzelne Zellen bzw. einzelne Reihen einzufärben, werden die entsprechenden Zellen markiert und dann mit Rechtsklick "Cell" -> "Cell Properties" ausgewählt. Im Feld "Background Color" kann nun die gewünschte Farbe eingetragen werden.

 

Wenn die Tabelle mit Hilfe des "HTML"-Macros erstellt wurde:

Nun kann im Quellcode die Farbe durch HTML eingestellt werden!

Für eine Zelle:

Für den Hintergrund einer Tabelle:

Wobei die Zellenfarbe die Farbe des Hintergrundes überschreibt.

Eine weitere Möglichkeit Tabellen in XWiki zu erstellen ist übrigens über das Macro Velocity. Dies funktioniert ähnlich wie bei HTML.

Eine sehr hilfreiche Dokumentation zum Thema Tabellen finden Sie hier.

Um eine Seite auf einer anderen Seite zu verlinken, müssen Sie die Seite(welche den Link bekommen soll) editieren:

1. Klick auf "Edit"
2. Klick in der Menü-Leiste auf "Link" 
3. 
4. Über den "Link"-Button öffnet sich ein Dialogfenster
5. Hier lässt sich der Display Text (sofern nicht vorher im Text selektiert) eingeben
6. Anschließend wird die zu verlinkende Seite über das SeitenSymbol bei "Page" ausgewählt
7. 
8. Wenn Anhänge, eine URL oder eine Mail-Adresse verlinkt werden soll, dann auf das Drop-Down Menü klicken und auswählen.
9. 
10. Nun lässt sich die zu verlinkende Seite über einen Navigationsbaum auswählen und erscheint anschließend unter dem "Find a page..."-Feld.
11. Abschließend müssen die Änderungen auf der Seite noch gespeichert werden.

Bei der Migration von Confluence zu XWiki, kann es vorkommen, dass der einige Code-Elemente rot umrandet werden.

Z.B. so:

Das liegt daran, dass bei der Migration die "Language" leer gelassen wird, wenn sie in Confluence nicht gesetzt ist.

Dies kann korrigiert werden, indem man die Einstellungen des Macros "Code Snippelt abändert.
Dafür auf Edit klicken

und dann doppelklick auf das Macro macht:

nun muss man im Reiter Language "none" eintragen

Anschließend sollten die Code Elemente nicht mehr eingerahmt sein.

 

Folgende Macros sind nur während der Confluence Migration verfügbar:

• Attachments
• Balsamiq
• Confluence Gallery
• Contributors
• Drawio
• Excerpt
• Excerpt-Include
• Gliffy
• Mathblock
• Mathblock-Ref
• Mathinline
• Mockup
• Pagetree
• Profile Picture
• Tip
• Time

Quelle: https://store.xwiki.com/xwiki/bin/view/Extension/ProMacros/

 

Bei der Migration einer Seite von Confluence zu XWiki, kann es zu einem Fehler beim "toc" Macro kommen:

Damit das Macro erkennt, wo es beginnt und endet, benötigt es 2 Leerzeilen vor und hinter sich.
Dies lässt sich am Besten in bei XWiki im Code-Editor einstellen:

Außerdem kann es dazu kommen, dass sich durch das Macro auch das Format des nachstehenden Textes verändert haben kann (es geht allerdings kein Inhalt verloren!):

Hier können jetzt einfach Leerzeilen durch die Enter-Taste ergänzt werden und das Format des Folgetextes angepasst werden:

Wenn das toc-Macro nicht am Seitenanfang, sondern "mitten in der Seite" eingesetzt wird, müssen auch über dem Macro 2 Leerzeilen sein.

Nach dem Speichern sieht die Seite wieder richtig aus:

Nach der Migration kann es dazu kommen, dass der Code aus Confluenc nicht ordentlich angezeigt werden kann. Hier erscheint dann ein "noformat"-Fehler:

Nun muss die Seite editiert werden und in der "Wiki" / "Source"-Ansicht das "noformat" ausgetauscht:

In den meisten Fällen hilft es, das "noformat" durch ein "Code" zu ersetzen:

Es gibt einige Macros, die in XWiki nicht mehr funktionieren und daher gegen ein XWiki-Macro ausgetauscht werden müssen. Eine Liste bekannter Alternativen finden Sie auf der folgenden Webseite:

https://xwiki.com/en/confluence-macros-alternatives/

Sollten Sie hierzu Fragen haben oder Probleme bei der Neueinrichtung des Macros in XWiki auftreten, wenden Sie sich gerne an den IT-Helpdesk (E-Mail: uco@desy.de, Tel: 5005).

Das Makro "livesearch" stellt ein Textfeld zur Verfügung, mit dem Suchen über einen bestimmten Bereich des Wikis durchgeführt werden können. In XWiki heißt das hierfür zu verwendende Makro "Location search". Gehen Sie insofern bitte wie folgt vor, um das Location search Makro einzufügen:

1. Gehen Sie in den Editor-Modus der Seite
2. Navigieren Sie an die Stelle, wo Sie das Such-Feld einfügen möchten, z.B. kurz über der Fehlermeldung

 

3. Klicken Sie im oberen Bereich des Editors auf das Plus Zeichen und wählen dort "Other Macros"
    

4. Suchen Sie nach dem macro "Location Search" und wählen es aus.

5. Anschließend geben Sie den Startpunkt der Suche in das Feld "Reference" ein. In vielen Fällen ist gewünscht, die thematisch zusammengehörigen Wiki-Seiten zu durchsuchen. In einem solchen Fall nehmen Sie also Ihre Hauptseite. Beispiel:
   Die Webadresse der aktuellen Seite könnte wie folgt lauten:
    

https://xwiki.desy.de/xwiki/bin/view/Noch%20ein%20Test/Noch%20eine%20Test%20Subseite/

Soll der Startpunkt für die Suche die Hauptseite sein, kopieren Sie nur den Namen der ersten Seite. Dieser ist hier rot dargestellt. Kopieren Sie den Namen inkl. jeglicher Sonderzeichen etc. und fügen diesen in das Feld "Reference" ein.

Sollte der Startpunkt stattdessen bei der Unterseite beginnen sollen, nehmen Sie den Namen der Unterseite (hier: "Noch eine Test Subseite") aus der Webadresse ebenfalls mit - wichtig ist in einem solchen Fall, dass Sie den Slash durch einen Punkt ersetzen. Bezogen auf das o.g. Beispiel würde dies also bedeuten, dass der Inhalt des Felds "Reference" am Ende wiefolgt aussehen muss, wenn der Startpunkt der Suche die Subseite sein soll:

Noch%20ein%20Test.Noch%20eine%20Test%20Subseite

6. Klicken Sie nun auf Submit.
7. Wenn soweit alles zufriedenstellend aussieht und funktioniert, entfernen Sie noch die Fehlermeldung des alten Livesearch Macros.

 

 

Das XWiki Macro "Document Tree Macro" stellt eine gute Alternative dar. das 'Children Macro' ist ein Teil davon und ergänzt das Document Tree Macro. Eine umfangreiche Anleitung findet sich bei dem Document Tree Macro.

Die Funktion von einem Template zu erstellen, ist standarmäßig bei XWiki integriert.

Beim Erstellen einer neuen Seite, kann auf der 'Create Page'  das gewünschte Template ausgewählt werden. Hier werden sowohl die Vorgefertigten als auch die selbst erstellten Templates angezeigt.

Bei XWiki ist die 'Like'-Funktion vorinstalliert und wird daher nicht mehr über ein extra Macro benötigt.

Die Fehlermeldung des nicht richtig importierten Macros kann also entfernt werden.
Am unteren Ende einer Seite lässt sich nun ein Herz zum Anklicken finden.

Nach dem Anklicken, erscheint eine Bestätigungsmeldung, dass die Seite geliked wurde und das Herz ist nicht mehr blau hinterlegt.

 

Die Confluence Macros 'mathinline' und 'mathblock' stehen nur während der Migration zur Verfügung.

Nach dem Migrieren der Daten von Confluence zu XWiki werden diese Macros also nicht mehr zur Verfügung stehen.

Sollten Sie hierzu Fragen haben oder Probleme auftreten, wenden Sie sich gerne an den IT-Helpdesk (E-Mail: uco@desy.de, Tel: 5005).

 

Zur Zeit gibt es leider noch kein XWiki Macro, welches 'content by label' ersetzt.

Das Macro 'popular label' gibt es nicht mehr bei XWiki, allerdings ist das Macro 'Tag Cloud Macro' eine gute Alternative.

Wie man es verwendet, die möglichen Parameter und Anwendungsbeispiele gibt es hier.

 

Zur Zeit gibt es leider noch kein XWiki Macro, welches 'details' ersetzt.

Sollten Sie Probleme haben ihre Daten auszulesen, wenden Sie sich bitte an den zentralen DESY IT-Helpdesk (E-Mail: uco@desy.de, Tel: 5005).

 

Zur Zeit gibt es leider kein Äquivalent zum "collapsible-panel" Macro in XWiki. 

Die Inhalte wurden aber migriert. Um nun an die Daten zu kommen, müssen Sie die Seite editieren.

Nun wird sich die Seite vermutlich im WYSIWYG-Modus befinden (Sie können die Seite so sehen, wie sie später dargestellt wird).

Um dies zu ändern, und die Daten aus dem Source-Mode herausholen zu können, sollten Sie auf die Fehlermeldung klicken, sodass

am oberen Teil die Aktionbar auftaucht. Ein Klick auf "Source" sorgt dafür, dass sich die Darstellung ändert.

Wenn Sie vorher das fehlerhafte Macro ausgewählt hatten, wird ihnen nun die Codeausgabe inklusive des Inhaltes ausgewählt.

 

Berechtigungen einer Seite können Sie nur dann setzen, wenn Sie Ersteller oder Admin einer Seite sind. Andernfalls sehen Sie den erforderlichen Menüpunkt zum Ändern von Berechtigungen nicht.

Sind Sie Ersteller oder Admin der Seite, gehen Sie wiefolgt vor:

1. Klicken Sie rechts oben auf der Seite auf die drei Punkte -> "Administer Page"

2.  -> "Users & Rights"

3.   Im nächsten Fenster können Sie entscheiden, ob die Berechtigungen nur für die aktuelle Seite (Rights: Page) oder zusätzlich auch für alle Unterseiten (Rights: Page & Children) gelten soll.

Für Page:

oder für Page & Children:

4. Anschließend können Sie Gruppen oder individuelle Accounts berechtigen.

5.    Die Checkbox hat 3 Zustände.

1. Undefined    =    leer  = >    Das übergeordnete Recht wird vererbt.
2. Allowed        =    Haken  =>    Die Gruppe oder der User hat explizit das Recht bekommen.
3. Denied         =    durchgestrichener Kreis  =>    Der Gruppe oder dem User wird das Recht explitzit verweigert.

Wenn eine Checkbox ausgewählt wird, wird sie zunächst "Allowed", wenn sie ein weiteres mal angeklickt wird, ändert sie sich zu "Denied". Ein drittes Anklicken führt dazu, dass es wieder "Undefined" wird.

6. Die Seite muss anschließend nicht gespeichert werden, um die Einstellungen zu übernehmen.

Ein Beispiel für die Rechte-Vererbung in XWiki:

Ausgangslage:

Im Beispiel-Space "ElternSpace" haben alle XWiki-Accounts (Gruppe: XWikiAllGroup) Lese- (view), Kommentier- (comment) und Editier- (edit) Rechte.

Als Unterseiten erstellen wir KindPage1, KindPage2, KindPage3 und KindPage4.

Wenn die Unterseite alle Rechte erbt:

Wenn, wie bei KindPage1, keine expliziten Rechte eingetragen werden, erbt KindPage1 ALLE Rechte von "ElternSpace". In diesem Fall kann die Gruppe XWikiAllGroup weiterhin lesen (view), kommentieren (comment) und editieren (edit).

In den "Detailled Page Rights" taucht die Seite "KindPage1" nur als Titel auf und unten nicht mit speziellen Rechten. Das weißt darauf hin, dass die Rechte des ElternSpace übernommen wurden :

 

Wenn ein Recht "implizit" eingeschränkt wird (empfohlen!):

Dies ist wohl auch der häufigste Anwendungsfall: Momentan erbt die KindPage2 das View-, Comment- und Edit-Recht von seinem ElternSpace. Diese Rechte werden aber "überschrieben" wenn auf einer Page das Recht "neu" / "anders" vergeben wird.

Also wenn hier ein User Edit-Rechte bekommt, verfällt das Edit-Recht automatisch für die Gruppe XWikiAllGroup. Da der User hier auch die View- und Comment-Rechte bekommen hat, muss die Gruppe XWikiAllGroup erneut die Rechte 'View' und 'Comment' zugesprochen bekommen.

 

Wenn ein Recht explizit eingeschränkt wird (nicht empfohlen!):

Bei KindPage2 werden die editier (edit) -Rechte der XWikiAllGroup explizit verboten.

 

Hierdurch ergibt sich bei den Rechten der KindPage2 folgendes Bild:

Dies ist nur selten sinnvoll und XWiki empfiehlt, es über eine "implizierte" Einschränkung zu lösen.

Wenn alle Rechte überschrieben werden:

Wie in KindPage2 angedeutet, muss die vererbte Gruppe (in diesem Fall XWikiAllGroup) NICHT unbedingt auch Teil der Unterseite sein. In diesem Fall werden alle vergebenen Rechte (view, comment und edit) der Gruppe IT zugeschrieben. Damit hat XWikiAllGroup keinerlei Zugriff mehr auf diese Seite (sie wird XWikiAllGroup dann natürlich auch nicht im Navigationsbaum angezeigt):

 

Zugang über Links:

Natürlich kann eine Unterseite auch Rechte für jemanden beinhalten, der für die übergeordnete Seite keine Rechte hat.
Beispiel:

KindPage4 hat eine UnterKindPage auf die wieder die Gruppe XWikiAllGroup zugreifen soll. Dann kann ein Nutzer, der sowohl Edit-Rechte auf "ElternSpace", als auch mindestens View-Rechte bei KindPage4 und UnterKindPage hat, einen Link zu UnterKindPage auf Ebene von ElternSpace einrichten.

Den Link zur UnterKindPage richtig in ElternSpace implementieren:

1. ElternSpace editieren und Link einfügen:

 

2. Einen AnzeigeText einfügen:

3. Seite auswählen und speichern:

Ansicht für einen User, der nicht für die KindPage4 berechtigt ist:

Sowohl die KindPage4 als auch deren Unterseite UnterKindPage werden dem User NICHT angezeigt.

 

Wenn der User den Link öffnet wird er aber auf die UnterKindPage-Seite weitergeleitet:

Im seitlichen Navigationsbaum werden weder die KindPage4 als auch die UnterKindPage angezeigt, aber im Navigationspfad über dem Seitentitel werden auch die nicht berechtigten Seiten angezeigt.

 

Mit der Migration wird jeder Confluence Administrator eines Spaces auch in XWiki Administrationsrechte für den migriten Space erhalten.

Zusätzlich ist es in XWiki möglich ganzen "Gruppen" einzelne Rechte (View, Comment, Edit, Script, Delete, Admin) zuzuweisen. An dieser Stelle wird empfohlen die Rolle der Administration über eine solche Gruppe abzubilden. Die Rechte können entweder nur für die aktuelle Seite oder für die aktuelle Seite und alle ihre Unterseiten bestehen.

Beispielbild einer Administrationsseite:

Sollten, über die migrierten Administratoren hinaus, noch für einzelne Kollegen Administrationsrechte benötigt werden, geht das auch wie bisher auf individueller Basis.

Eine sehr gute Dokumentation findet sich auch bei XWiki: hier.

 

Es gibt eine (vorläufige) Ansicht, um besser nachvollziehen zu können, welcher User bzw welche Gruppe Rechte für den jeweiligen Space hat. Diese Ansicht ist noch "vorläuftig" weil noch daran gearbeitet wird, es kann also noch zu äußerlichen Änderungen kommen.

Um diese Ansicht zu bekommen, wählen Sie den entsprechenden Space aus und klicken Sie in der oberen rechten Space-Ecke auf das Drop-Down Menü:

Hier können Sie über den unteresten Punkt "Detailled Page Rights"

eine Übersicht bekommen über Berechtigte

Hier wird erst die Globalen Rechte angezeigt, gefolgt von den Seitenberechtigungen der übergeordneten Seite

und optional den Rechten der aktuellen Seite: