Hilfe:Übernahme der HS-Dokumentation: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
 
(25 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
== Verlinkung bei der Ü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.
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 so aus:
Eine tiefe Verlinkung der alten Dokumentation sieht zum Beispiel (hier bei [[Pakete]]) so aus:


<pre><nowiki>
<pre><nowiki>
Zeile 18: Zeile 18:
Um diese Linkstruktur im HS-Wiki optimal abzubilden, ist folgende Vorgehensweise angebracht:
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:  
 
=== 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:


<pre><nowiki>
<pre><nowiki>
[[Pakete:Dynamic-Web]] und [[Pakete:Static-Web]]
</nowiki></pre>


Im Beispiel befinden sich unter [[Pakete:Dynamic-Web]] weitere Seiten. Diese werden nach dem gleichen Prinzip verlinkt:
== Weiterführende Links ==
* [[Dynamic-Web]]<br>
* [[Static-Web]]


<pre><nowiki>
[[Pakete:Dynamic-Web:Speicherbelegung]] und [[Pakete:Dynamic-Web:Verzeichnisstruktur]]
</nowiki></pre>
</nowiki></pre>


=== 2. Weiterführende Links ===
Es wird übrigens zugunsten der Übersichtlichkeit darauf verzichtet, im Link den Namensraum extra zu nennen.


Jede Seite, die in der HS-Doku Links zu tiefergehenden Seiten trägt, erhält einen Absatz '''Weiterführende Links''' mit Überschrift.
Im Beispiel muss natürlich auch in der Seite [[Dynamic-Web-Pakete]] ein entsprechender Absatz abgelegt werden, da sie ja in der alten Dokumentation auf "tiefer" liegende Seiten verweist.
Hier werden die direkt darunter liegenden Seiten verlinkt.


Für die Seite Paket im Beispiel oben sieht das so aus:
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.


<pre><nowiki>
=== Gemeinsame Kategorie ===


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


* [[Pakete:Dynamic-Web | Dynamic-Web]]
<pre><nowiki>
* [[Pakete:Static-Web | Static-Web]]
[[Kategorie:Pakete]]
</nowiki></pre>


</nowiki></pre>
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.


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.
== Ausnahmen ==


=== 3. Gemeinsame Kategorie ===
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 sofort auf die gleichnamige Kategorie.


Da alle Seiten im Beispiel zum Thema "Pakete" der HS-Doku gehören, werden sie einer gemeinsamen Kategorie zugeordnet:
Eine Kategorie (hier [[:Kategorie:Installationsanleitungen | Installationsanleitungen]]) kann so verlinkt werden (man beachte den ersten Doppelpunkt):


<pre><nowiki>
<pre><nowiki>
[[Kategorie:Pakete]]
[[:Kategorie:Installationsanleitungen | Installationsanleitungen]]
</nowiki></pre>
</nowiki></pre>

Aktuelle Version vom 24. April 2013, 06:11 Uhr

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:


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 ==
* [[Dynamic-Web]]<br>
* [[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 Dynamic-Web-Pakete 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.

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 sofort auf die gleichnamige Kategorie.

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

[[:Kategorie:Installationsanleitungen | Installationsanleitungen]]