Codice sorgente Wiki di Hilfe: Bearbeitungsmodus

Ultima modifica di Christian Holzner il 2026/11/12 11:05

Show last authors
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 * Größere Überarbeitungen, die erst später sichtbar werden sollen, am besten in einem **Entwurf** machen (siehe Abschnitt 13).
64
65 = 6. Links zu externen Inhalten und Weiterleitungen =
66
67 **Link einfügen:** Text markieren → **Link-Symbol** in der Werkzeugleiste (oder **Strg + K**).
68
69 * **Externe Seite:** die vollständige Adresse ({{{https://...}}}) eintragen.
70 * **Andere alpin.info-Seite:** Seitennamen eintippen und aus der Vorschlagsliste wählen.
71 * **Datei (PDF, Word):** „Anhang“ wählen und die angehängte Datei auswählen.
72
73 **Im neuen Tab öffnen oder aktuellen Tab ersetzen?** Im Link-Dialog den Reiter **„Ziel“** öffnen:
74
75 * **„Neues Fenster (_blank)“** → öffnet in einem neuen Tab.
76 * **„<nicht gesetzt>“** → öffnet im aktuellen Tab.
77
78 Empfehlung: **externe Links im neuen Tab**, interne Links im aktuellen Tab.
79
80 **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.
81
82 = 7. Bausteine und Makros einfügen =
83
84 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.
85
86 |=Gewünscht|=So geht’s
87 |**Nur Text**|##/## → **„Textblock, 1 Spalte“** (zwei Spalten: **„Textblock, 2 Spalten“**, mit grauer Box: **„Textblock-Box“**)
88 |**Nur Bild**|##/## → **„Bild, zentriert“**
89 |**Bild links / Text rechts**|##/## → **„Bild + Text“** (halb/halb; mit grauer Box rechts: **„Bild + Box“**). Schmales Bild (1/3) und breiter Text (2/3): **„Bild schmal + Text“**. Klick auf das Bild öffnet die Großansicht.
90 |**Nur Bilderkarussell**|##/## → **„Bildergalerie“** – mehrere Bilder nebeneinander, mit Pfeilen blättern. Wie die Bilder hineinkommen: siehe **„Mehrere Bilder für Bildergalerie und Karussell“** unten.
91 |**Bilderkarussell links / Text rechts**|##/## → **„Karussell schmal + Text“** – links (1/3) immer ein Bild, Pfeile blättern zum nächsten; rechts (2/3) Überschrift, Unterüberschrift, Text. Bilder: siehe unten.
92 |**YouTube-Verlinkung**|##/## → **„YouTube Video“** → im Feld **url** die YouTube-Adresse einfügen ({{{https://www.youtube.com/watch?v=...}}} oder {{{https://youtu.be/...}}}).
93 |**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.
94 |**Verlinkungs-Button**|##/## → **„Verlinkungs-Button“** → Ziel über den Link-Dialog setzen.
95 |**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.
96
97 == Mehrere Bilder für Bildergalerie und Karussell ==
98
99 **Schritt 1 – Bilder auf einmal hochladen (für beide gleich):** Seite öffnen (nicht im Bearbeitungsmodus) → unten Reiter **„Anhänge“** → **„Dateien auswählen“** und im Dateifenster **mehrere Bilder gleichzeitig markieren** (Strg bzw. Umschalt gedrückt halten). Alternativ die Bilder aus dem Explorer auf den Anhänge-Bereich ziehen. Der Bild-Dialog im Editor lädt dagegen immer nur **ein** Bild hoch.
100
101 **Bildergalerie – Weg A, automatisch (empfohlen):**
102
103 1. Die Dateinamen der Bilder **vor dem Hochladen** mit **„Galerie“** beginnen lassen, z. B. ##Galerie_01_Aufstieg.jpg##, ##Galerie_02_Gipfel.jpg##.
104 1. Bilder wie in Schritt 1 hochladen.
105 1. Im Editor ##/## → **„Bildergalerie“** einfügen und nichts weiter eintragen.
106
107 Alle Bilder, deren Name mit „Galerie“ beginnt, erscheinen automatisch, **alphabetisch sortiert** – die Reihenfolge steuert man also über den Namen (##01##, ##02##, …). Neues Bild dazu = einfach eine weitere „Galerie…“-Datei anhängen; ein Bild entfernen = Anhang löschen oder umbenennen.
108
109 **Bildergalerie – Weg B, eigene Auswahl/Reihenfolge:** Bilder ganz normal hochladen (beliebige Namen). Im Editor auf die Galerie **doppelklicken** → im Feld **„Inhalt“** **je Zeile einen Dateinamen** eintragen, genau so geschrieben wie unter „Anhänge“ (inkl. Endung, Groß-/Kleinschreibung). Die Bilder erscheinen in der Reihenfolge der Zeilen.
110
111 **Karussell („Karussell schmal + Text“):** Hier werden die Bilder direkt im Editor ausgetauscht. Im Bearbeitungsmodus zeigt das Karussell alle Bilder **nebeneinander als Raster** (auf der fertigen Seite dann wieder einzeln mit Pfeilen).
112
113 * **Bild austauschen:** Platzhalter **doppelklicken** → im Bild-Dialog **„Anhänge“** → hochgeladenes Bild auswählen → bestätigen.
114 * **Weiteres Bild:** ein Bild im Karussell anklicken → **Strg + C** → daneben klicken → **Strg + V** → das neue Bild wie oben austauschen.
115 * **Bild entfernen:** anklicken → **Entf**.
116 * **Reihenfolge ändern:** Bild anklicken → **Strg + X** → an der neuen Stelle **Strg + V**. Die Reihenfolge im Raster ist die Reihenfolge beim Blättern.
117
118 = 8. Tabellen einfügen und bearbeiten =
119
120 * **Einfügen:** ##/## → **„Tabelle“** oder Tabellen-Symbol in der Werkzeugleiste → Zeilen/Spalten und ggf. Kopfzeile wählen.
121 * **Bearbeiten:** Rechtsklick in eine Zelle → **Zeile** / **Spalte** einfügen oder löschen, **Zellen verbinden/teilen**, **Tabelleneigenschaften**.
122 * 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.
123
124 = 9. Bereits hochgeladenes Bild erneut auswählen =
125
126 Bild einfügen (##/## → **„Bild“** oder Bild-Symbol, bzw. Doppelklick auf ein Platzhalterbild) → im Bild-Dialog **nicht** „Hochladen“, sondern:
127
128 * **„Durchsuchen“** → Seitenbaum öffnen und das Bild bei der Seite auswählen, an der es hängt, oder
129 * **„Suchen“** → Teil des Dateinamens eintippen.
130
131 So wird das vorhandene Bild wiederverwendet statt eine Kopie hochzuladen (wichtig für Abschnitt 11).
132
133 = 10. Allgemeines (Festlegungen) =
134
135 == Infoboxen (Info / Warnung / Fehler) ==
136
137 XWiki bringt die Boxen fertig mit: ##/## → **„Info“**, **„Warnung“**, **„Fehler“** (zusätzlich **„Erfolg“**).
138
139 **❓ BRD intern festlegen**, wann welche Box verwendet wird. Vorschlag:
140
141 {{info}}
142 **Info:** ergänzende Hinweise, Tipps, Verweise.
143 {{/info}}
144
145 {{warning}}
146 **Warnung:** sicherheitsrelevante Hinweise, häufige Fehler in der Praxis.
147 {{/warning}}
148
149 {{error}}
150 **Fehler:** Lebensgefahr / „niemals so machen“.
151 {{/error}}
152
153 == Überschriften auf 2–3 Ebenen beschränken ==
154
155 Vorschlag: **Text**, **Überschrift 1**, **Überschrift 2** (ggf. Überschrift 3). Die Bausteine haben eigene Überschrift/Unterüberschrift und decken die meisten Fälle ab.
156
157 **⚙ Admin:** Nach der Festlegung wird die Auswahl im Editor auf diese Formate reduziert.
158
159 == Größe aller Bilder ==
160
161 Bereits technisch begrenzt:
162
163 * Bilder in Bausteinen passen sich der Spaltenbreite an; „Bild, zentriert“ max. **460 px** hoch, Bildreihen max. **350 px** hoch.
164 * Bildergalerie: einheitlich **250 px** hoch.
165
166 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).
167
168 **❓ Offen:** Maximale Höhe/Breite für frei eingefügte Bilder außerhalb der Bausteine noch festlegen – kann dann zentral per Stil begrenzt werden.
169
170 == „/“-Auswahl auf ein Minimum reduzieren ==
171
172 **⚙ 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).
173
174 == Vorlagenauswahl beim Erstellen minimieren ==
175
176 **⚙ Admin:** Vorlagen können ausgeblendet oder auf bestimmte Bereiche beschränkt werden. Vorschlag: nur noch **„Allgemeine Vorlage“** (Inhaltsseiten) und **„Unterseiten-Kacheln“** (Themen/Kapitel) anbieten.
177
178 = 11. Altes Bild durch eine neue Version ersetzen – wird es überall aktualisiert? =
179
180 **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.
181
182 **Nein, wenn das Bild mehrfach (als Kopie) auf verschiedene Seiten hochgeladen wurde** – dann muss jede Kopie einzeln ersetzt werden.
183
184 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.
185
186 = 12. Bildmediathek einsehbar? Bildersuche? =
187
188 **Ja:**
189
190 * **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.
191 * **Anhänge einer Seite:** unten auf der Seite Reiter **„Anhänge“**.
192 * **Beim Einfügen:** im Bild-Dialog Reiter **„Suchen“** (Suche nach Dateinamen).
193 * **Normale Suche:** Suchergebnisse lassen sich auf **Anhänge** filtern.
194
195 **Tipp:** Sprechende Dateinamen verwenden (z. B. ##Achterknoten_Schritte.jpg## statt ##IMG_4711.jpg##) – sonst findet man Bilder kaum wieder.
196
197 = 13. Entwürfe: Seiten erst bearbeiten, später veröffentlichen =
198
199 Normale Änderungen sind sofort nach dem Speichern für alle sichtbar. Soll eine Seite in Ruhe überarbeitet und erst später freigegeben werden, legt man einen **Entwurf** an.
200
201 **Entwurf anlegen:**
202
203 1. Die Seite öffnen, die überarbeitet werden soll.
204 1. Oben neben „Bearbeiten“ auf **„Entwurf“** klicken.
205 1. Wenn die Seite Unterseiten hat: Häkchen **„Unterseiten mit übernehmen“** setzen, wenn auch diese im Entwurf überarbeitet werden sollen.
206 1. **„Entwurf anlegen“** klicken – die Kopie öffnet sich.
207
208 **Entwurf bearbeiten:** Der Entwurf wird ganz normal mit „Bearbeiten“ und dem gewohnten Editor bearbeitet; man kann ihn beliebig oft speichern. Eine **gelbe Box** oben zeigt „Entwurf – nicht öffentlich“. Neue Unterseiten, Bilder und Anhänge können im Entwurf ebenfalls angelegt werden. Die veröffentlichte Seite bleibt in dieser Zeit unverändert.
209
210 **Veröffentlichen:** Im Entwurf in der gelben Box (oder oben) auf **„Veröffentlichen“** klicken und bestätigen. Inhalt, Titel und Anhänge des Entwurfs ersetzen dann die veröffentlichte Seite (bei Bedarf auch die Unterseiten), danach wird der Entwurf gelöscht. Die veröffentlichte Seite behält ihre Adresse; der alte Stand bleibt in der **Historie** und kann jederzeit wiederhergestellt werden.
211
212 **Verwerfen:** In der gelben Box auf **„Verwerfen“** klicken – nur der Entwurf wird gelöscht, die veröffentlichte Seite bleibt, wie sie ist.
213
214 **Wer sieht Entwürfe?** Nur die Redakteurinnen und Redakteure des jeweiligen Bereichs (z. B. BRD-Entwürfe nur die BRD-Redaktion). Leserinnen und Leser sehen sie nicht. Alle Redakteure des Bereichs dürfen einen Entwurf bearbeiten und veröffentlichen.
215
216 * Gibt es zu einer Seite bereits einen Entwurf, heißt der Button **„Entwurf öffnen“**, und auf der veröffentlichten Seite erscheint der Hinweis „Für diese Seite gibt es einen Entwurf“.
217 * Eine Liste aller offenen Entwürfe gibt es unter [[Entwürfe>>Entwuerfe.WebHome]] (auch über den Link „Alle Entwürfe“ in der gelben Box).
218
219 {{warning}}
220 Wird die veröffentlichte Seite geändert, während es einen Entwurf gibt, warnt das Veröffentlichen davor – diese Änderungen würden durch den Entwurf überschrieben. Also entweder im Entwurf **oder** in der veröffentlichten Seite arbeiten, nicht in beiden.
221 {{/warning}}