| Dokumenteninformation | Festlegung |
|---|---|
| Dokumenten-ID | FW-HB-02 |
| Titel | Benutzung des Fotografen-Wikis |
| Bereich | Wiki-Handbuch |
| Dokumentenart | Benutzungs- und Pflegeanleitung |
| Verantwortlich | Wiki-Eigentümer |
| Version | 1.0 |
| Stand | 24.07.2026 |
| Dokumentenstatus | Entwurf |
| Klassifizierung | Intern / öffentlich nach Freigabe |
| Geltungsbereich | Gesamtes Fotografen-Wiki |
| Wiki.js-Pfad | /Fotografen-Wiki/FW-HB-02_Benutzung_des_Fotografen-Wikis |
Diese Seite erklärt, wie das Fotografen-Wiki gelesen, durchsucht, ergänzt und gepflegt wird. Sie beschreibt insbesondere:
Die verbindlichen Seitenpfade und Dokumentenkennungen stehen in der Struktur und Seitenarchitektur.
| Ziel | Vorgehen |
|---|---|
| Im Wiki beginnen | Startseite öffnen |
| Eine vorhandene Seite suchen | Seitenregister öffnen und den Link in der passenden Zeile verwenden |
| Einen Themenbereich öffnen | Auf der Startseite den gewünschten Hauptbereich auswählen |
| Eine neue Seite planen | Zuerst Dokumenten-ID und Wiki.js-Pfad im Seitenregister prüfen oder reservieren |
| Eine lokale Markdown-Datei prüfen | Die .md-Datei direkt auf dem Computer oder über einen in Codex bereitgestellten Dateilink öffnen |
| Eine Seite veröffentlichen | Inhalt der lokalen Markdown-Datei in Wiki.js am verbindlichen Pfad anlegen und anschließend die Links prüfen |
| Ein Bild oder PDF einbinden | Datei in Wiki.js hochladen und den tatsächlichen Wiki.js-Dateipfad in der Seite verwenden |
| Änderungen nachvollziehen | Version, Stand, Änderungshistorie und Seitenregister aktualisieren |
Die Startseite ist der allgemeine Einstieg. Sie enthält:
| Bereich | Typische Inhalte |
|---|---|
| Ausrüstung | Kameras, Objektive, analoge Filme, Stative, Filter und weiteres Zubehör |
| Anleitungen | Gebrauchsanleitungen, Kurzanleitungen, Datenblätter, Firmware und Software |
| Fotowissen | Belichtung, Fokus, Zonenfokus, Bildgestaltung, Licht und Nachbearbeitung |
| Genres | Landschafts-, Natur-, Tier-, Höhlen- und Reisefotografie |
| Fotoorte | Regionen, Schutzgebiete, Nationalparks, Naturparks, Höhlen und einzelne Fotostandorte |
| Touren | Fotoreisen, Photowalks, Planung, Packlisten und persönliche Notizen |
| Natur | Tiere, Pflanzen, Lebensräume und Jahreszeiten |
| Recht und Sicherheit | Fotorecht, Schutzgebiete, Drohnen und Sicherheit im Gelände |
| Nachweise | Eigene Tests, Erfahrungsberichte, Tourenberichte und Galerien |
Das Seitenregister ist das zentrale Verzeichnis. Es zeigt:
Das Seitenregister ist maßgeblich, wenn eine Seite nicht über die Navigation gefunden wird oder geprüft werden soll, ob sie bereits geplant beziehungsweise angelegt ist.
Eine lokale .md-Datei und eine Wiki.js-Seite sind zwei getrennte Fassungen desselben Inhalts.
| Element | Bedeutung |
|---|---|
| Lokale Markdown-Datei | Arbeits- und Sicherungsdatei auf dem Computer; kann unabhängig von Wiki.js geöffnet und geprüft werden |
| Wiki.js-Seite | In Wiki.js angelegte und über einen Webpfad erreichbare Fassung |
| Wiki.js-Pfad | Zieladresse der Seite innerhalb des Wikis |
| Asset | Hochgeladenes Bild, PDF oder eine andere Datei, die von einer Wiki-Seite verlinkt wird |
Wichtig: Das Erstellen oder Ändern einer lokalen
.md-Datei veröffentlicht den Inhalt nicht automatisch in Wiki.js.
Lokale Markdown-Dateien können geöffnet werden:
Der lokale Dateiname enthält zur eindeutigen Zuordnung normalerweise die Dokumenten-ID und den Zusatz _WikiJS.md. Der Wiki.js-Seitenpfad endet dagegen nicht mit .md.
Beispiel:
Lokale Datei:
FW-HB-02_Benutzung_des_Fotografen-Wikis_WikiJS.md
Wiki.js-Pfad:
/Fotografen-Wiki/FW-HB-02_Benutzung_des_Fotografen-Wikis
Innerhalb des veröffentlichten Wikis wird eine Seite über einen internen Markdown-Link geöffnet:
[Benutzung des Wikis öffnen](/Fotografen-Wiki/FW-HB-02_Benutzung_des_Fotografen-Wikis)
Lokale Computerpfade wie /Users/... dürfen nicht in eine Wiki.js-Seite übernommen werden. Sie funktionieren nur auf dem betreffenden Computer und nicht für andere Wiki-Benutzer.
Vor jeder neuen Seite ist zu prüfen:
Ein Inhalt wird nur einmal als Hauptseite angelegt. Andere Seiten verlinken auf diese Hauptseite.
Das genaue Aussehen der Wiki.js-Bedienoberfläche kann je nach Version und Berechtigung abweichen. Der Arbeitsablauf bleibt:
_WikiJS.md-Datei einfügen.Hinweis: Die technische Veröffentlichung einer Seite ist noch keine inhaltliche Freigabe. Der Dokumentenstatus muss den tatsächlichen Prüf- und Freigabestand wiedergeben.
| Regel | Richtiges Beispiel |
|---|---|
Interne Seitenlinks beginnen mit / |
/Fotografen-Wiki/Ausruestung/... |
| Kein Sprachpräfix verwenden | nicht /de/Fotografen-Wiki/... |
| Keinen abschließenden Schrägstrich ergänzen | /Fotografen-Wiki/FW-HB-01_Startseite |
| Bestehende Groß-/Kleinschreibung beibehalten | Pfad exakt aus Register oder Seitenarchitektur übernehmen |
| Umlaute in Pfaden vermeiden, wenn der Pfad bereits mit Umschrift festgelegt ist | Ausruestung, Fraenkische_Schweiz |
| Bindestriche und Unterstriche nicht eigenmächtig ändern | Leica_M10-R bleibt Leica_M10-R |
| Bestehende Seiten nicht nur zur optischen Verbesserung verschieben | zuerst alle betroffenen Verknüpfungen prüfen |
Ein Seitenpfad wird immer aus dem Seitenregister oder der Seitenarchitektur übernommen und nicht aus dem Titel neu abgeleitet.
[Leica-Übersicht öffnen](/Fotografen-Wiki/Ausruestung/Kameras/Leica/FW-KAM-LEI-01_Leica_Uebersicht)
[Herstellerseite öffnen](https://www.beispiel.de/)
Bei externen Quellen sollen Herausgeber, Seitentitel und Prüfdatum erkennbar sein. Veraltete oder nicht mehr erreichbare Quellen werden ersetzt oder als nicht mehr verfügbar gekennzeichnet.
Nach einer Änderung ist zu prüfen:
Ein Bild wird zuerst in Wiki.js hochgeladen. Anschließend wird der dort angezeigte Dateipfad verwendet.
Ein zusätzlicher Direktlink ist sinnvoll:
[Bilddatei öffnen](/FW-ZUB-01-02_Berlebach_Holzstativ.png)
Wichtig: Eine Bilddatei im lokalen Ordner
assetsist noch nicht automatisch in Wiki.js vorhanden. Sie muss zusätzlich in Wiki.js hochgeladen werden.
PDF-Dateien, Gebrauchsanleitungen und Programme werden als Assets in Wiki.js hochgeladen und anschließend verlinkt:
[Programm als PDF öffnen](/erlebnistage_2026programm.pdf)
Zu jedem Download sollen nach Möglichkeit angegeben werden:
| Angabe | Beispiel |
|---|---|
| Bezeichnung | Gebrauchsanleitung Leica R 6.2 |
| Dokumenttyp | PDF-Gebrauchsanleitung |
| Sprache | Deutsch |
| Herausgeber | Hersteller oder Veranstalter |
| Versions- oder Datumsstand | laut Dokument |
| Interner Dateilink | tatsächlicher Asset-Pfad in Wiki.js |
| Prüfdatum | Datum der letzten Kontrolle |
Vor einer Veröffentlichung ist zu prüfen, ob die Datei gespeichert und verbreitet werden darf. Im Zweifel wird auf die offizielle Downloadseite verlinkt.
Private Notizen werden im vorgesehenen Notizbereich abgelegt:
/Fotografen-Wiki/Touren/Notizen/
Sie können enthalten:
Zugriffsschutz: Die Angabe
Klassifizierung: Privatin der Markdown-Seite ist nur eine Kennzeichnung. Der tatsächliche Schutz muss zusätzlich über die Wiki.js-Berechtigungen für Seite oder Pfad eingerichtet werden.
Personenbezogene Angaben, nicht öffentliche Kontaktdaten und sensible Standortinformationen dürfen nicht unbeabsichtigt in einen öffentlich lesbaren Bereich übernommen werden.
| Status | Verwendung |
|---|---|
| Geplant | Dokumenten-ID und Pfad sind reserviert; die Seite wurde noch nicht erstellt |
| Entwurf vorhanden | Lokale Markdown-Datei ist vorhanden; Veröffentlichung und Freigabe sind offen |
| In Prüfung | Inhalt oder technische Darstellung wird geprüft |
| Freigegeben | Inhalt wurde geprüft und zur Nutzung freigegeben |
| Veröffentlicht | Freigegebene Seite ist unter dem registrierten Wiki.js-Pfad erreichbar |
| Überarbeitung erforderlich | Seite ist vorhanden, benötigt aber eine Aktualisierung |
| Archiviert | Seite wurde ersetzt oder wird nicht mehr gepflegt |
Entwurf vorhanden, Freigegeben und Veröffentlicht sind unterschiedliche Zustände. Sie dürfen nicht allein aufgrund einer gespeicherten Datei gleichgesetzt werden.
Bei einer inhaltlichen Änderung werden mindestens folgende Stellen geprüft:
| Änderung | Beispiel |
|---|---|
| Neue Seite | Version 1.0 |
| Inhaltliche Ergänzung oder neue Grafik | 1.0 auf 1.1 |
| Weitere kleinere Ergänzung | 1.1 auf 1.2 |
| Grundlegende Neufassung | beispielsweise 1.x auf 2.0 |
| Version | Datum | Änderung |
|---|---|---|
| 1.0 | 24.07.2026 | Seite erstellt |
| 1.1 | TT.MM.JJJJ | Inhalt oder Grafik ergänzt |
Die Beschreibung soll erkennen lassen, was tatsächlich geändert wurde.
Geplant oder Entwurf vorhanden setzen.| Problem | Ursache | Lösung |
|---|---|---|
Eine aktualisierte .md-Datei lässt sich nur über den Finder finden |
Es wurde kein direkter lokaler Dateilink bereitgestellt | In der Codex-Antwort einen absoluten anklickbaren Link zur Datei verwenden |
| Die Seite ist lokal vorhanden, aber nicht im Wiki sichtbar | Lokale Datei wurde noch nicht in Wiki.js angelegt | Inhalt am registrierten Wiki.js-Pfad veröffentlichen |
| Das Bild erscheint nicht | Datei wurde nicht in Wiki.js hochgeladen oder der Asset-Pfad stimmt nicht | Datei hochladen und tatsächlichen Wiki.js-Dateipfad übernehmen |
| Ein interner Link führt ins Leere | Pfad wurde aus dem Titel abgeleitet oder verändert | Pfad mit Seitenregister und Seitenarchitektur vergleichen |
| Eine private Notiz ist öffentlich sichtbar | Klassifizierung wurde eingetragen, aber keine Zugriffsregel gesetzt | Wiki.js-Berechtigungen für Seite oder Pfad korrigieren |
| Register und Seite zeigen unterschiedliche Versionen | Register wurde bei der Änderung nicht aktualisiert | Seitenversion und Registereintrag angleichen |
| Sonderzeichen führen zu einem anderen Pfad | Bindestriche, Unterstriche oder Umschriften wurden geändert | den registrierten Pfad exakt übernehmen |
| Thema | Link |
|---|---|
| Startseite | FW-HB-01 öffnen |
| Struktur und Seitenarchitektur | FW-HB-03 öffnen |
| Seitenregister | FW-REG-01-01 öffnen |
| Änderungshistorie | FW-REG-01-02 öffnen |
| Offene Themen | FW-REG-01-03 öffnen |
| Notizen zu Fotoreisen und Photowalks | FW-TOU-NOT-01 öffnen |
| Version | Datum | Änderung |
|---|---|---|
| 1.0 | 24.07.2026 | Benutzungs- und Pflegeanleitung für Navigation, lokale Markdown-Dateien, Wiki.js-Veröffentlichung, Links, Assets, private Notizen, Versionierung und Registerpflege erstellt |