Hilfe:Übernahme der HS-Dokumentation

Verlinkung bei der Übernahme der HS Dokumentation

Die HS Dokumentation in der alten Form zeichnet sich dadurch aus, dass sie eine tiefe Verlinkung aufweist. Diese in das HS Dokuwiki zu übernehmen, ist nicht ganz einfach, weil das Wiki eine eher flache Linkstruktur aufweist.

Eine tiefe Verlinkung der alten Dokumentation sieht zum Beispiel so aus:

Pakete ->
      > Dynamic-Web ->
                 > Speicherbelegung
                 > Verzeichnisstruktur
                 > etc...
      > Static-Web
      > etc...

Um diese Linkstruktur im HS-Wiki optimal abzubilden, ist folgende Vorgehensweise angebracht:

1. Namensraum

Alle Seiten, die einer anderen Seite der originalen HS-Doku untergeordnet sind, werden dem Namensraum untergeordnet, den die übergeordnete Seite definiert. Im Beispiel oben ist die erste Seite "Pakete", die direkt untergeordneten Seiten werden so verlinkt:

[[Pakete:Dynamic-Web]] und [[Pakete:Static-Web]]

Im Beispiel befinden sich unter Pakete:Dynamic-Web weitere Seiten. Diese werden nach dem gleichen Prinzip verlinkt:

[[Pakete:Dynamic-Web:Speicherbelegung]] und [[Pakete:Dynamic-Web:Verzeichnisstruktur]]

2. Weiterführende Links

Jede Seite, die in der HS-Doku Links zu tiefergehenden Seiten trägt, erhält einen Absatz Weiterführende Links mit Überschrift. Hier werden die direkt darunter liegenden Seiten verlinkt.

Für die Seite Paket im Beispiel oben sieht das so aus:

== Weiterführende Links ==

* [[Pakete:Dynamic-Web | Dynamic-Web]]
* [[Pakete:Static-Web | Static-Web]]

Es bleibt dem Autor überlassen, ob der Absatz "Weiterführende Links" ganz oben oder ganz unten in der Seite angelegt wird, nur irgendwo in der Mitte macht er naturgemäss wenig Sinn. Im Beispiel muss natürlich auch in der Seite Pakete:Dynamic-Web ein entsprechender Absatz abgelegt werden, da sie ja in der alten Dokumentation auf "tiefer" liegende Seiten verweist.

3. Gemeinsame Kategorie

Da alle Seiten im Beispiel zum Thema "Pakete" der HS-Doku gehören, werden sie einer gemeinsamen Kategorie zugeordnet:

[[Kategorie:Pakete]]