Links
Wie werden Links zu anderen Seiten oder auf andere Sites formatiert.
Grundsätzliches
Unabhängig vom Link-Typ gilt:
- alle Links werden in doppelte eckige Klammern gesetzt (keine „blanken“ URLs, auch wo diese nach DokuWiki Syntax erlaubt wären)
- Es wird immer ein spezifischer Link-Text angegeben (kein automatischer Linktext, wie bei internen Links möglich, und auch keine automatischen URLs, wie bei externen Links möglich)
- Bei mehreren möglichen Link-Typen sollte immer der spezifischste mögliche verwendet werden (z.B.
[[wpde>…|…]]
anstelle einer URL zu Wikipedia)
Interne Links
Für interne Links, d.h. Links innerhalb des Denkfehler Online Wikis sollte immer die DokuWiki-Syntax verwendet werden. D.h. es wird der interne Pfadname (mit :
als Trennzeichen) verwendet.
Zum Beispiel für einen Link auf den Artikel zu „Syllogismus“ sieht der Link-Code wie folgt aus:
[[begriffe:syllogismus|Syllogismus]]
Solche Links werden automatisch erstellt, wenn der „Link“-Knopf im Editor geklickt wird. Im Zweifelsfall sollte man daher diese Methode verwenden.
Styleguide und Lernmaterial
Aus technischen Gründen sind sowohl dieser Styleguide, als auch das „Lernmaterial“-Portal aus Sicht des Wikis „externe“ Sites.
Aus diesen Gründen wird für Links zu diesen dieselbe Syntax verwendet, wie für externe „Interwiki“ Links. Solche Links erhalten auch ein eigenes Icon, um klar als externe Resourcen erkennbar zu sein:
Beispiel | Code |
---|---|
Denkfehler Online Lernmaterial | lern |
Denkfehler Online Style Guide | style |
Zum Beispiel sähe ein Link auf diese Seite im Code des Wikis wie folgt aus:
[[style>formatierung/links|Styleguide: Links]]
→ Styleguide: Links
Wichtig: Bei solchen „externen“ Links werden keine Doppelpunkte als Pfadbegrenzungszeichen verwendet, sondern die üblichen Schrägstriche!
Sprachversionen
Neben dem deutschen „Denkfehler Online“ existiert auch eine Englische Version unter fallacies.online. Möglicherweise kommen irgendwann einmal andere Sprachversionen dazu.
Es ist möglich, auf eine spezifische Sprachvariante zu verweisen, indem die folgenden Interwiki-Codes verwendet werden:
Beispiel | Zielsite | Sub-Site | Code |
---|---|---|---|
Denkfehler Online | Denkfehler Online (DE) | Wiki | de |
Fallacies Online | Fallacies Online (EN) | Wiki | en |
Diese Links verweisen jeweils auf die /wiki/
Verzeichnisse der Sites.
Es ist auch möglich, auf diese Weise intern auf eine Seite im Wiki zu verlinken. Dies sollte aber nur gebraucht werden, wenn damit ganz explizit auf eine deutschsprachige Version verwiesen werden soll. Das dürfte nur sehr selten sinnvoll sein.
Syllogismus-Finder App
Ein Sonderfall der internen Links sind Verweise auf die „Syllogismus-Finder“-App. Diese werden mit dem Code app
markiert. Ein Beispiel hierfür wäre etwa der folgende Link:
[[app>#barbara|Modus Barbara]]
→ Modus Barbara
Der Linktext (hier: „Modus Barbara“) wird auf der Seite nicht angezeigt. Er wird dennoch aus Gründen der Barrierefreiheit benötigt und sollte die verlinkte Syllogismus-Form beschreiben.
Sinnvollerweise sollte auch der sichtbare Text vor oder nach dem Link eine sinnvolle Beschreibung des Links enthalten.
Da diese Links in einer ausgedruckten Seite wenig sinnvoll wären, sollten sie auch mit der Klasse no-print
markiert werden, damit sie in der Druckversion nicht erscheinen.
Typ ''AAA'', Form ''1''<span no-print> [[app>#barbara|Modus Barbara]]</span>
→ Typ AAA
, Form 1
Externe Links
Die generische Form eines externen Links besteht einfach aus der zu verlinkenden URL, einschließlich Linktext. Dies kann wie folgt aussehen:
[[https://www.philoclopedia.de/|Philoclopedia]]
→ Philoclopedia
Solche Links erhalten ein generisches Link-Icon (siehe oben), um sie von anderen Linkformen zu unterscheiden.
Wann immer möglich, sollten anstelle von generischen Links die spezifischere „Interwiki“-Links verwendet werden!
Interwiki Links
Als „Interwiki“ werden in der DokuWiki-Dokumentation Links zu anderen DokuWikis oder zu Wikipedia bezeichnet. Bereits dort fallen aber auch Links, z.B. zu Google, Twitter oder Skype unter diese Kategorie. Für Denkfehler Online wurde die Liste der unterstützten „Interwiki“-Sites nochmals erweitert.
Die Syntax solcher „Interwiki“-Links besteht aus einem Code, der von einem „größer-als“-Zeichen gefolgt wird. Dahinter kommt dann der spezifischere Teil der Adresse:
[[wpde>Fehlschluss|Fehlschluss]]
→ Fehlschluss
Ein wichtiger Vorteil dieser Links ist es, dass sie ein Icon erhalten, das die verlinkte Site besser erkennbar macht.
Wikipedia
Die folgenden Wikipedia-Sites werden unterstützt:
Beispiel | Ziel | Sprache | Code |
---|---|---|---|
Wikipedia (DE) | Wikipedia | Deutsch | wpde |
Wikipedia (EN) | Englisch | wp |
|
Wikipedia (FR) | Französisch | wpfr |
|
Wikipedia (ES) | Spanisch | wpes |
|
Meta-Wiki | Wikipedia Meta | wpmeta |
Service Links
Es gibt Link-Codes für wichtige Online-Services. Die Abgrenzung zu den „wichtigen Sites“ (siehe unten) sind dabei etwas arbiträr, aber auch nicht wirklich wichtig:
Beispiel | Code |
---|---|
Google-Suche (DE) | google.de |
Google-Suche (EN) | google |
ISBN Suche (Abebooks) | isbn |
Telefonnummer | tel oder callto |
Wichtige Sites
Die folgenden Websites werden von vielen Artikeln im Wiki verlinkt und haben daher einen eigenen „Interwiki“-Code erhalten, um diese Verlinkungen zu erleichtern, und damit sie ihr eigenes Icon erhalten können:
Beispiel | Code |
---|---|
Gutenberg Online | gutenberg |
Stanford Encyclopedia of Philosophy | stanford |
Wayback Machine | archive |
YouTube | yt |
Duden Online | duden |
DokuWiki | doku |
Obsolete Codes
Und schließlich gibt es noch ein paar Codes, die entweder nicht mehr länger verwendet werden, oder die für dieses Wiki nicht wirklich relevant sind. Ein paar davon haben eigene Icons, in anderen Fällen wird ein generisches Interwiki-Icon (nicht identisch zum generischen Link-Icon oben!) verwendet:
Beispiel | Code | Status |
---|---|---|
Skype | skype | Obsolet |
twitter | Obsolet | |
PHP Funktionsreferenz | phpfn | Nicht relevant |
Linux Manual | man | Nicht relevant |
RFC Standard | rfc | Nicht relevant |