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

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
 
(15 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 (hier bei [[Pakete]]) so aus:
Eine tiefe Verlinkung der alten Dokumentation sieht zum Beispiel (hier bei [[Pakete]]) so aus:
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:


<pre><nowiki>
=== Weiterführende Links ===
[[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:
 
<pre><nowiki>
[[Pakete:Dynamic-Web:Speicherbelegung]] und [[Pakete:Dynamic-Web:Verzeichnisstruktur]]
</nowiki></pre>
 
=== 2. Weiterführende Links ===


Jede Seite, die in der HS-Doku Links zu tiefergehenden Seiten trägt, erhält einen Absatz '''Weiterführende Links'''.  
Jede Seite, die in der HS-Doku Links zu tiefergehenden Seiten trägt, erhält einen Absatz '''Weiterführende Links'''.  
Zeile 42: Zeile 30:


== Weiterführende Links ==
== Weiterführende Links ==
 
* [[Dynamic-Web]]<br>
* [[Pakete:Dynamic-Web | Dynamic-Web]]
* [[Static-Web]]
* [[Pakete:Static-Web | Static-Web]]


</nowiki></pre>
</nowiki></pre>


Hier wird übrigens zugunsten der Übersichtlichkeit darauf verzichtet, im Link den Namensraum extra zu nennen.
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.
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.
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.


=== 3. Gemeinsame Kategorie ===
=== Gemeinsame Kategorie ===


Da alle Seiten im Beispiel zum Thema "Pakete" der HS-Doku gehören, werden sie einer gemeinsamen Kategorie zugeordnet:
Da alle Seiten im Beispiel zum Thema "Pakete" der HS-Doku gehören, werden sie einer gemeinsamen Kategorie zugeordnet:
Zeile 62: Zeile 49:
</nowiki></pre>
</nowiki></pre>


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 zum Beispiel in [[Pakete:Dynamic-Web:Speicherbelegung]] so gemacht:
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 [[:Kategorie:Installationsanleitungen | Installationsanleitungen]]) kann so verlinkt werden (man beachte den ersten Doppelpunkt):


<pre><nowiki>
<pre><nowiki>
[[Kategorie:Pakete:Dynamic-Web]]
[[:Kategorie:Installationsanleitungen | Installationsanleitungen]]
</nowiki></pre>
</nowiki></pre>
== 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.

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