Wiki-Quellcode von Hilfe: Bearbeitungsmodus
Zuletzt geändert von Christian Holzner am 2026/11/12 11:05
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 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}} |