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 (hier bei Pakete) 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]]

Hier wird übrigens zugunsten der Übersichtlichkeit darauf verzichtet, im Link den Namensraum extra zu nennen.

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]]

Es bleibt dem Autor überlassen, ob tiefer als in zweiter Eebene gelegene Seiten nicht auch als Mitglieder der direkt darüber liegenden Seite kategorisiert werden. Ich habe es in zum Beispiel in Pakete:Dynamic-Web:Speicherbelegung so gemacht:

[[Kategorie:Pakete:Dynamic-Web]]

4. Ausnahmen

Es gibt Seiten, bei denen aufgrund der vielen gleichwertigen darunter liegenden Seiten dieses Vorgehen nicht sinnvoll ist. Ein Beispiel ist die Seite Installationsanleitungen. Sie verlinkt über eine Weiterleitung sofort auf die gleichnamige Kategorie.