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 tief und baumartig verlinkt. Diese in das HS Dokuwiki zu übernehmen, ist ganz einfach, obwohl 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:

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 erstellt:

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

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

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

Weiterführende Links

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

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

== Weiterführende Links ==

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

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

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.

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. "Ganz oben" macht auf allen Seiten Sinn, die so lang sind, dass er nicht gleich am Bildschirm auftaucht.

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 Ebene gelegene Seiten nicht auch als Mitglieder der direkt darüber liegenden Seite kategorisiert werden. Ich habe es zum Beispiel in Pakete:Dynamic-Web:Speicherbelegung so gemacht:

[[Kategorie:Pakete:Dynamic-Web]]

Ausnahmen

Es gibt Seiten, bei denen aufgrund der vielen gleichwertigen darunter liegenden Seiten dieses Vorgehen nicht sinnvoll ist. Hier reicht es, nur die in zweiter Ebene liegenden Seiten zu kategorisieren. Als Hauptseite wird die kategorie genommen. Ein Beispiel ist die Seite Installationsanleitungen. Sie verlinkt über eine Weiterleitung sofort auf die gleichnamige Kategorie.

Eine Kategorie (hier Installationsanleitungen) kann so verlinkt werden (man beachte den ersten Doppelpunkt):

[[:Kategorie:Installationsanleitungen | Installationsanleitungen]]