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

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    = >    dann wird das übergeordnete Recht vererbt  
   2. Allowed    =    Harken    =>    die Gruppe oder der User hat explezit das Recht bekommen
   3. Denied    =    durchgestrichener Kreis    =>    der Gruppe oder dem User ist 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 3. Anklicken führt dazu, dass es wieder Undefiniert wird.
   
   
    
6. Die Seite muss anschließen nicht gespeichert werden, um die Einstellungen zu übernehmen.
    

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 werden die Blog Funktionen über die 'Blog Application' geregelt.

Um einen Blog-Bereich unabhängig vom Standardblog zu erstellen müssen Sie Admin-Rechte haben. Bei Fragen oder Problemen wenden Sie sich gerne an den IT-Helpdesk (E-Mail: uco@desy.de, Tel: 5005).

Mit Adminatrionsrechten müssen Sie dazu auf die URL https://xwiki.desy.de/xwiki/bin/view/Blog/Management zugreifen.

Hier können nun neue Blogs erstellt werden und deren Speicherorte festgelegt werden.

Um nun die Blogeinträge auf einer Seite einzufügen benötigt es ein paar Schritte:

1. Seite editieren
2. über das + ein Macro auswählen (z.B. BlogPostLayoutFull)
3. Referenz eingeben (Syntax: Überordner.Blogordner.BlogTitel )

Der Blogbeitrag muss hierfür 'publish' sein!

Bei Dashboard kann das Blog-Macro über 'Add Gadget' hinzugefügt werden.

Beachten Sie dabei die Berechtigungen der verschiedenen Überordner.

Dies können Zeilenumbrüche sein, die nun nicht an der richtigen Stelle liegen oder Textblock ist verrutscht. Für diese Fälle wird an einem DESY-Template gearbeitet.

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/

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 in der standatisiert 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.

Bei XWiki funktioniert die Rechtestruktur ähnlich wie bei Confluence, auch hier können die Rechte nach untenhin vererbt werden. Sie können immer weiter eingeschränkt werden, aber auch pro Seite eingestellt und dann über Links auf übergeordnete Seiten aufrufbar gemacht werden. Grundsätzlich ist die Rechtesturktur dadurch flexibler.

Um die Einstellungen einer Seite zu ändern, müssen Sie auf der betroffenen Seite auf. Kicken Sie auf:

1. "more Actions"
2. "Administer Page"
3. "User & Rights"
4. Entscheiden ob es sich nur um die Rechte dieser Seite "Rights: Page" oder auch die Rechte der Unterseiten "Rights: Page & Children" handeln soll
5. Nun entsprechende User-Gruppen und/ oder einzelne User berechtigen

Eine bebilderte Schritt-für-Schritt-Anleitung zur Vergabe von Rechten für Gruppen und User findet sich hier.

Mehr zu den einzelnen Rechten (view, comment, edit etc) findet sich hier.

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: