Wiki-Quellcode von Hilfe: Bearbeitungsmodus

Version 1.1 von Christian Holzner am 2026/10/23 08:03

Verstecke letzte Bearbeiter
Christian Holzner 1.1 1 Kurzanleitung für Redakteurinnen und Redakteure. Punkte mit **⚙ Admin** werden zentral eingerichtet, Punkte mit **❓ Offen** müssen noch entschieden bzw. umgesetzt werden.
2
3 {{toc depth="2"/}}
4
5 = 1. Grundprinzip: Wie ist alpin.info aufgebaut? =
6
7 * **Jede Seite kann Unterseiten haben.** Ein „Thema“ (z. B. //Ausbildung Technik//) ist eine Seite, die „Kapitel“ darunter (z. B. //04. Helikopter im Bergrettungsdienst//) sind deren Unterseiten, und die eigentlichen Inhaltsseiten (z. B. //Organisation//, //Helikopter//) sind wiederum Unterseiten der Kapitel.
8 * **Übersichtsseiten** (Themen, Kapitel) zeigen ihre Unterseiten automatisch als **Kacheln** an. Die Zahl oben rechts in der Kachel ist die Anzahl der Unterseiten – sie wird automatisch berechnet.
9 * Das **Bild in der Kachel / im linken Menü** ist das **Piktogramm** der Seite: eine angehängte Bilddatei mit dem Namen ##Piktogramm.png## (oder ##.jpg##). Fehlt es, zeigt die Kachel das erste angehängte Bild der Seite.
10 * **Reihenfolge** (Kacheln und linkes Menü): zuerst die //angepinnten// Unterseiten in der festgelegten Reihenfolge, danach alle übrigen **alphabetisch nach Titel**. Deshalb haben Kapitel eine Nummer im Titel („01.“, „02.“, …).
11
12 = 2. Neues Thema anlegen und anordnen =
13
14 1. Zur Seite gehen, **unter** der das Thema erscheinen soll (z. B. die Bereichs-Startseite //BRD//).
15 1. Oben auf **„Erstellen“** klicken.
16 1. **Titel** eingeben (z. B. „Technische Anwendungen und digitale Systeme“).
17 1. Als **Vorlage „Unterseiten-Kacheln“** wählen → **Erstellen**. Die Seite zeigt damit automatisch ihre Unterseiten als Kacheln.
18 1. **Piktogramm hinzufügen:** Auf der neuen Seite unten den Reiter **„Anhänge“** öffnen und das Icon als Datei mit dem Namen **##Piktogramm.png##** hochladen. (Datei vorher am PC umbenennen.)
19
20 **Anordnen:**
21
22 * Einfachster Weg: Reihenfolge über den Titel steuern – die Seiten werden alphabetisch sortiert.
23 * Feste Reihenfolge unabhängig vom Titel: Übergeordnete Seite öffnen → Menü **⋮ (Mehr)** → **„Seite administrieren“** → Abschnitt **„Angepinnte Unterseiten“** – dort Seiten hinzufügen und per Drag & Drop sortieren. Angepinnte Seiten stehen immer vorne.
24
25 {{info}}
26 Neue Themen ohne Inhalt zeigen statt einer leeren Seite die graue Box „Diese Seite befindet sich im Aufbau“.
27 {{/info}}
28
29 = 3. Neue Kapitel anlegen, anordnen bzw. in ein anderes Thema verschieben =
30
31 **Anlegen** – wie ein Thema (Abschnitt 2), nur auf der **Themen-Seite** auf „Erstellen“ klicken:
32
33 * Titel mit Nummer, z. B. „14. Neues Kapitel“ → sortiert sich automatisch richtig ein.
34 * Vorlage **„Unterseiten-Kacheln“** (wenn das Kapitel selbst wieder Unterseiten hat) oder **„Allgemeine Vorlage“** (wenn es direkt Inhalt enthält).
35 * ##Piktogramm.png## anhängen.
36
37 **Anordnen** – über die Nummer im Titel oder über „Angepinnte Unterseiten“ (siehe Abschnitt 2). Wird ein Kapitel umnummeriert, nur den **Titel** ändern (Bearbeiten → Titel oben), nicht die Adresse.
38
39 **In ein anderes Thema verschieben:**
40
41 1. Kapitel öffnen → **⋮ (Mehr)** → **„Umbenennen“**.
42 1. Unter **„Ort“ / „Übergeordnete Seite“** das neue Thema auswählen.
43 1. Häkchen **„Unterseiten mitverschieben“** und **„Automatische Weiterleitung“** gesetzt lassen → **Umbenennen**.
44
45 Alle Unterseiten wandern mit, alte Links funktionieren dank Weiterleitung weiter.
46
47 = 4. Seiten und Unterseiten anlegen/kopieren und anordnen =
48
49 **Neue Inhaltsseite:** Im Kapitel auf **„Erstellen“** → Titel → Vorlage **„Allgemeine Vorlage“** → Erstellen. Die Seite öffnet sich direkt im Editor mit allen Bausteinen als Beispiel; nicht benötigte Bausteine einfach löschen.
50
51 **Seite kopieren:** Seite öffnen → **⋮ (Mehr)** → **„Kopieren“** → Ziel-Ort und neuen Namen wählen. Mit **„Unterseiten mitkopieren“** wird der ganze Teilbaum kopiert. Anhänge (Bilder, PDFs) werden mitkopiert.
52
53 **Anordnen:** wie bei Themen/Kapiteln (Titel-Sortierung oder „Angepinnte Unterseiten“).
54
55 **Tipp:** Seiten, die selbst nur auf Unterseiten verweisen (wie //04. Helikopter im Bergrettungsdienst//), brauchen keinen eigenen Text – das linke Menü zeigt die Unterseiten an.
56
57 = 5. Seiten bearbeiten =
58
59 * Auf **„Bearbeiten“** (Stift-Symbol) klicken → der visuelle Editor öffnet sich.
60 * **Speichern & Ansicht** schließt den Editor, **Speichern** speichert zwischendurch, **Abbrechen** verwirft Änderungen.
61 * Jede Speicherung erzeugt eine Version. Unter **„Historie“** (unten an der Seite) kann man alte Stände ansehen und **wiederherstellen** – man kann also nichts endgültig kaputt machen.
62 * Mit **##/##** im Text öffnet sich das Einfüge-Menü für Bausteine, Makros, Tabellen usw. (siehe Abschnitt 7).
63
64 = 6. Links zu externen Inhalten und Weiterleitungen =
65
66 **Link einfügen:** Text markieren → **Link-Symbol** in der Werkzeugleiste (oder **Strg + K**).
67
68 * **Externe Seite:** die vollständige Adresse ({{{https://...}}}) eintragen.
69 * **Andere alpin.info-Seite:** Seitennamen eintippen und aus der Vorschlagsliste wählen.
70 * **Datei (PDF, Word):** „Anhang“ wählen und die angehängte Datei auswählen.
71
72 **Im neuen Tab öffnen oder aktuellen Tab ersetzen?** Im Link-Dialog den Reiter **„Ziel“** öffnen:
73
74 * **„Neues Fenster (_blank)“** → öffnet in einem neuen Tab.
75 * **„<nicht gesetzt>“** → öffnet im aktuellen Tab.
76
77 Empfehlung: **externe Links im neuen Tab**, interne Links im aktuellen Tab.
78
79 **Weiterleitungen:** Beim Umbenennen/Verschieben einer Seite wird automatisch eine Weiterleitung von der alten Adresse angelegt (Häkchen „Automatische Weiterleitung“). Eine Seite, die //nur// auf eine andere Adresse weiterleiten soll, richtet **⚙ Admin** ein.
80
81 = 7. Bausteine und Makros einfügen =
82
83 Im Editor **##/##** tippen. In der Gruppe **„Textbausteine“** stehen die alpin.info-Bausteine. Nach dem Einfügen ist der Baustein normaler Text: Überschrift, Unterüberschrift und Text einfach überschreiben, Platzhalterbild („Bild hier einfügen“) per **Doppelklick** ersetzen.
84
85 |=Gewünscht|=So geht’s
86 |**Nur Text**|##/## → **„Textblock, 1 Spalte“** (zwei Spalten: **„Textblock, 2 Spalten“**, mit grauer Box: **„Textblock-Box“**)
87 |**Nur Bild**|##/## → **„Bild, zentriert“**
88 |**Bild links / Text rechts**|##/## → **„Bild + Text“** (mit grauer Box rechts: **„Bild + Box“**)
89 |**Nur Bilderkarussell**|##/## → **„Bildergalerie“**. Bilder vorher an die Seite anhängen und ihren Dateinamen mit **„Galerie“** beginnen lassen (z. B. ##Galerie1.jpg##, ##Galerie2.jpg##) – sie erscheinen dann automatisch, alphabetisch sortiert. Alternativ im Makro je Zeile einen Dateinamen eintragen. Klick auf ein Bild öffnet die Großansicht.
90 |**Bilderkarussell links / Text rechts**|**❓ Offen** – diesen Baustein gibt es noch nicht. Übergangslösung: Galerie über oder unter einem Textblock.
91 |**YouTube-Verlinkung**|##/## → **„YouTube Video“** → im Feld **url** die YouTube-Adresse einfügen ({{{https://www.youtube.com/watch?v=...}}} oder {{{https://youtu.be/...}}}).
92 |**Downloadbox**|##/## → **„Bild + Text + Downloads“**. Die PDFs/Word-Dateien an die Seite anhängen, dann jeden Platzhalter-Link in der grünen Box anklicken → Link-Symbol → **Anhang** auswählen. Weitere Downloads: Zeile kopieren.
93 |**Verlinkungs-Button**|##/## → **„Verlinkungs-Button“** → Ziel über den Link-Dialog setzen.
94 |**Makro für Zusatzseiten / Erweiterte Inhalte**|**❓ Offen** – Zusatzseiten sind derzeit normale Unterseiten. Bitte festlegen, wie sie dargestellt werden sollen (z. B. als aufklappbare Abschnitte, als Kacheln oder als Liste am Seitenende); danach wird ein passender Baustein erstellt.
95
96 = 8. Tabellen einfügen und bearbeiten =
97
98 * **Einfügen:** ##/## → **„Tabelle“** oder Tabellen-Symbol in der Werkzeugleiste → Zeilen/Spalten und ggf. Kopfzeile wählen.
99 * **Bearbeiten:** Rechtsklick in eine Zelle → **Zeile** / **Spalte** einfügen oder löschen, **Zellen verbinden/teilen**, **Tabelleneigenschaften**.
100 * Tabellen nur für **Tabellen-Inhalte** (Daten, Gegenüberstellungen) verwenden – für Layouts mit Bild und Text bitte die **Textbausteine** aus Abschnitt 7 nehmen, sie passen sich auch am Handy richtig an.
101
102 = 9. Bereits hochgeladenes Bild erneut auswählen =
103
104 Bild einfügen (##/## → **„Bild“** oder Bild-Symbol, bzw. Doppelklick auf ein Platzhalterbild) → im Bild-Dialog **nicht** „Hochladen“, sondern:
105
106 * **„Durchsuchen“** → Seitenbaum öffnen und das Bild bei der Seite auswählen, an der es hängt, oder
107 * **„Suchen“** → Teil des Dateinamens eintippen.
108
109 So wird das vorhandene Bild wiederverwendet statt eine Kopie hochzuladen (wichtig für Abschnitt 11).
110
111 = 10. Allgemeines (Festlegungen) =
112
113 == Infoboxen (Info / Warnung / Fehler) ==
114
115 XWiki bringt die Boxen fertig mit: ##/## → **„Info“**, **„Warnung“**, **„Fehler“** (zusätzlich **„Erfolg“**).
116
117 **❓ BRD intern festlegen**, wann welche Box verwendet wird. Vorschlag:
118
119 {{info}}
120 **Info:** ergänzende Hinweise, Tipps, Verweise.
121 {{/info}}
122
123 {{warning}}
124 **Warnung:** sicherheitsrelevante Hinweise, häufige Fehler in der Praxis.
125 {{/warning}}
126
127 {{error}}
128 **Fehler:** Lebensgefahr / „niemals so machen“.
129 {{/error}}
130
131 == Überschriften auf 2–3 Ebenen beschränken ==
132
133 Vorschlag: **Text**, **Überschrift 1**, **Überschrift 2** (ggf. Überschrift 3). Die Bausteine haben eigene Überschrift/Unterüberschrift und decken die meisten Fälle ab.
134
135 **⚙ Admin:** Nach der Festlegung wird die Auswahl im Editor auf diese Formate reduziert.
136
137 == Größe aller Bilder ==
138
139 Bereits technisch begrenzt:
140
141 * Bilder in Bausteinen passen sich der Spaltenbreite an; „Bild, zentriert“ max. **460 px** hoch, Bildreihen max. **350 px** hoch.
142 * Bildergalerie: einheitlich **250 px** hoch.
143
144 Vorschlag für den Upload: längste Seite **max. 1920 px**, Fotos als **JPG**, Grafiken/Icons als **PNG**, Dateigröße möglichst **unter 500 KB**. Piktogramme quadratisch (z. B. 408 × 408 px).
145
146 **❓ Offen:** Maximale Höhe/Breite für frei eingefügte Bilder außerhalb der Bausteine noch festlegen – kann dann zentral per Stil begrenzt werden.
147
148 == „/“-Auswahl auf ein Minimum reduzieren ==
149
150 **⚙ Admin:** möglich über die Editor-Konfiguration. **❓ Offen:** Bitte eine Liste der Einträge erstellen, die bleiben sollen (Vorschlag: Textbausteine, Bild, Tabelle, Infoboxen, YouTube Video, Bildergalerie, Überschriften, Listen).
151
152 == Vorlagenauswahl beim Erstellen minimieren ==
153
154 **⚙ Admin:** Vorlagen können ausgeblendet oder auf bestimmte Bereiche beschränkt werden. Vorschlag: nur noch **„Allgemeine Vorlage“** (Inhaltsseiten) und **„Unterseiten-Kacheln“** (Themen/Kapitel) anbieten.
155
156 = 11. Altes Bild durch eine neue Version ersetzen – wird es überall aktualisiert? =
157
158 **Ja, wenn das Bild nur einmal hochgeladen und überall wiederverwendet wurde:** Seite öffnen, an der das Bild hängt → Reiter **„Anhänge“** → die neue Datei **mit exakt demselben Dateinamen** hochladen. XWiki speichert sie als neue Version des Anhangs; alle Seiten, die dieses Bild verwenden, zeigen sofort die neue Version (ggf. Strg + F5 drücken). Die alte Version bleibt in der Anhang-Historie erhalten.
159
160 **Nein, wenn das Bild mehrfach (als Kopie) auf verschiedene Seiten hochgeladen wurde** – dann muss jede Kopie einzeln ersetzt werden.
161
162 Empfehlung: Bilder, die auf mehreren Seiten vorkommen, **nur einmal** hochladen (z. B. auf einer zentralen Seite „Mediathek“ pro Bereich) und überall über **„Durchsuchen“** (Abschnitt 9) einbinden.
163
164 = 12. Bildmediathek einsehbar? Bildersuche? =
165
166 **Ja:**
167
168 * **Alle Anhänge des Wikis:** [[Seitenindex → Reiter „Anhänge“>>Main.AllDocs||queryString="view=attachments"]] – Liste aller Dateien mit Filter nach Dateiname, Typ, Seite und Datum.
169 * **Anhänge einer Seite:** unten auf der Seite Reiter **„Anhänge“**.
170 * **Beim Einfügen:** im Bild-Dialog Reiter **„Suchen“** (Suche nach Dateinamen).
171 * **Normale Suche:** Suchergebnisse lassen sich auf **Anhänge** filtern.
172
173 **Tipp:** Sprechende Dateinamen verwenden (z. B. ##Achterknoten_Schritte.jpg## statt ##IMG_4711.jpg##) – sonst findet man Bilder kaum wieder.
174