Wiki-Quellcode von Hilfe: Bearbeitungsmodus
Version 1.1 von Christian Holzner am 2026/10/23 08:03
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 | |||
| 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. |



