summaryrefslogtreecommitdiff
path: root/ikiwiki/Howtos
diff options
context:
space:
mode:
authorCaoimhe Chaos <caoimhechaos@protonmail.com>2016-01-23 22:34:12 +0100
committerCaoimhe Chaos <caoimhechaos@protonmail.com>2016-01-23 22:34:12 +0100
commit5158ddcc8a6dfbc08430b36aea9939d149a2fb51 (patch)
tree9b4f7009d444e73a644b739f96ac161582943f0e /ikiwiki/Howtos
parentf527e0e8608511d737844fcc61143e76e149530e (diff)
Mehr Ikiwiki-Spass.
Diffstat (limited to 'ikiwiki/Howtos')
-rw-r--r--ikiwiki/Howtos/Anleitung_Wiki-Formatierung.mdwn48
1 files changed, 39 insertions, 9 deletions
diff --git a/ikiwiki/Howtos/Anleitung_Wiki-Formatierung.mdwn b/ikiwiki/Howtos/Anleitung_Wiki-Formatierung.mdwn
index 1d878047..c9d244a7 100644
--- a/ikiwiki/Howtos/Anleitung_Wiki-Formatierung.mdwn
+++ b/ikiwiki/Howtos/Anleitung_Wiki-Formatierung.mdwn
@@ -1,17 +1,21 @@
Da es bisher nur eine [[englische Anleitung zum Wiki|ikiwiki/formatting/]] vorhanden ist, wird hier nun eine deutsche Zusammenfassung angeboten.
+[[!toc ]]
+
[[!sidebar content="""
This is my custom sidebar for this page.
[[!calendar pages="posts/*"]]
"""]]
-#Allgemeines zum Wiki-Prinzip
+Allgemeines zum Wiki-Prinzip
+============================
+
Damit Informationen im Internet (genauer WWW) dargestellt werden können, müssen diese entsprechend formatiert sein. Dazu wird unter anderem die "Sprache" HTML verwendet, die jedoch für viele Leute zu umständlich ist.
-Damit es aber *"einfacher"* wird, damit jeder sein Wissen beitragen kann, wurde eine Syntax erfunden, die "wiki wiki" (=hawaiianisch für schnell) eingegeben werden kann und damit viel einfacher sein soll als HTML. Die meisten kennen es wohl zumindest vom Hörensagen von der [[Wikipedia|http://de.wikipedia.org]] her. Dort wird allerdings eine andere Software eingesetzt, namens "Mediawiki" .
+Damit es aber *"einfacher"* wird, damit jeder sein Wissen beitragen kann, wurde eine Syntax erfunden, die "wiki wiki" (=hawaiianisch für schnell) eingegeben werden kann und damit viel einfacher sein soll als HTML. Die meisten kennen es wohl zumindest vom Hörensagen von der [Wikipedia](http://de.wikipedia.org/) her. Dort wird allerdings eine andere Software eingesetzt, namens "Mediawiki" .
-Auf unserem Wiki wird hingegen die Software [[ikiwiki|http://ikiwiki.info]] verwendet. Die Unterschiede sind allerdings nicht sehr gross.
+Auf unserem Wiki wird hingegen die Software [ikiwiki](http://ikiwiki.info) verwendet. Die Unterschiede sind allerdings nicht sehr gross.
Grundsätzlich kann eine Seite auch mit Inhalt gefüllt werden, ohne dass eine Formatierung eingehalten wird. Die eigentliche Formatierung kann dann später jederzeit ergänzt werden.
@@ -27,13 +31,15 @@ Es gibt *Kursivdruck* oder | &nbsp; | Es gibt \*Kursivdruck\* oder |&nbsp; | Ei
&nbsp; | | | |
**Auflistungen und Aufzählungen**||||
* Erste Zeile|&nbsp;|\* Erste Zeile|&nbsp;|Mit einem Stern am Anfang der Zeile, gefolgt von einem Leerzeichen kann eine solche Auflistung (mit Bullet) erzeugt werden.
-* Zweite Zeile|&nbsp;|\* Zweite Zeile|&nbsp;|Aber Vorsicht: Wenn der Text vorne **UND** hinten mit Stern umrandet wird, dann wird er hervorgehoben.
+ * Zweite Zeile|&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;\* Zweite Zeile|&nbsp;|Aber Vorsicht: Wenn der Text vorne **UND** hinten mit Stern umrandet wird, dann wird er hervorgehoben.
"""]]
1. Erste Zeile &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1. Erste Zeile&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Für eine nummerierte Aufzählung wird am Beginn der Zeile eine beliebige Zahl gefolgt von einem Punkt aufgeführt.
1. Zweite Zeile &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1. Zweite Zeile&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (aus 1. wird automatisch 2., 3., 4., ...außer innerhalb von Tabellen)
-##Überschriften
+Überschriften
+=============
+
Überschriften sollen helfen, etwas Struktur in den Text zu bekommen. Praktischer Nebeneffekt ist, dass ganz oben im Dokument automatisch ein Inhaltsverzeichnis aus allen Überschriften erzeugt wird, zu denen dann per Mausklick gesprungen werden kann.
Einfach an den Zeilenanfang ein bis sechs Rautesymbole # gefolgt von der Überschrift anführen.
@@ -45,6 +51,16 @@ Einfach an den Zeilenanfang ein bis sechs Rautesymbole # gefolgt von der Übersc
##### Überschrift Ebene 5
###### Überschrift Ebene 6
+Zudem gibt es noch eine weitere Schreibweise für Überschriften, indem diese einfach mit Gleichheitszeichen oder Bindestrichen «graphisch unterstrichen» werden:
+
+Überschrift Ebene 1
+===================
+
+Überschrift Ebene 2
+-------------------
+
+Mit dieser Schreibweise wird dasselbe erreicht wie oben, aber der Wikitext ist für manche Leute selbsterklärender.
+
##(Hyper-)Links
Um von einem Dokument eine Verbindung zu einem anderen zu erstellen, werden sog. Hyperlinks eingesetzt. Links werden durch Umklammerung eines Textes durch doppelte eckige Klammern erstellt:\[[Dokumentname\]]. Dabei können interne Links im Wiki oder auch Links zu externen Webseiten oder Emailadressen verwendet werden (siehe Beispiele).
@@ -52,23 +68,37 @@ Soll einen anderer Text, als der Linktext angezeigt werden, dann kann man dies d
**Beispiele für Links: **
-* \[\[Hier geht es zur Hauptseite\|https://wiki.starship-factory.ch\]\] -> [[Hier geht es zur Hauptseite|https://wiki.starship-factory.ch]]
+* \<https://www.hackerspace-basel.ch/\> -> <https://www.hackerspace-basel.ch/>
+
+* \[Externe Links mit Beschreibung\](https://www.hackerspace-basel.ch/) -> [Externe Links mit Beschreibung](https://www.hackerspace-basel.ch/)
+
+* \[Externe Links mit Beschreibung\](https://www.hackerspace-basel.ch/ "Hackerspace Basel") -> [Externe Links mit Beschreibung](https://www.hackerspace-basel.ch/ "Hackerspace Basel")
* \[\[Howtos\]\] -> [[Howtos]]
+* \[\[mit anderem Text|Howtos\]\] -> [[mit anderem Text|Howtos]]
+
+Die folgenden Beispiele stellen den Mediawiki-Stil dar, werden aber auch unterstützt:
+
+* \[\[Hier geht es zur Hauptseite\|https://wiki.starship-factory.ch\]\] -> [[Hier geht es zur Hauptseite|https://wiki.starship-factory.ch]]
+
* \[\[irgendwer@starship-factory.ch\]\] -> [[irgendwer@starship-factory.ch]]
Vorsicht: Wenn doppelte eckige Klammern im Text verwendet werden sollen, müssen diese mit dem Backslash \\ eingeleitet werden, sonst wird es als Link verarbeitet.
-##Bilder und Grafiken
+Bilder und Grafiken
+===================
* \[\[!img logo_44px.png\]\] -> [[!img logo_44px.png]]
* \[\[!img logo_44px.png size="50x50" alt="SF-Logo"\]\] -> [[!img logo_44px.png size="50x50" alt="SF-Logo"]]
+* \[\[!img logo_44px.png size="x100" alt="SF-Logo"\]\] -> [[!img logo_44px.png size="x100" alt="SF-Logo"]] (maximale Breite 100 Pixel)
+
* Größenanpassung bei Grafiken auf fremden Servern geht aber nur per HTML-Syntax, genauso, wenn verzerrt werden soll: \< img src="https://wiki.starship-factory.ch/logo_44px.png" width="30" height="30" alt="SF-Logo" \> -> <img src="https://wiki.starship-factory.ch/logo_44px.png" width="30" height="30" alt="SF-Logo">
-##Spezialseiten
+Spezialseiten
+=============
* \[\[!brokenlinks pages="* and !recentchanges"\]\] -> [[!brokenlinks pages="* and !recentchanges"]]
@@ -76,7 +106,7 @@ Vorsicht: Wenn doppelte eckige Klammern im Text verwendet werden sollen, müssen
* [[!progress totalpages="HowTos/* and !*/Discussion" donepages="*/Discussion"]]
-* [[!waypoint lat="47.54071N" lon="7.61427W" name="Spaceship-Factory" tag="city" embed]]
+* [[!waypoint lat="47.54071N" lon="7.61427W" name="Starship-Factory" tag="city" embed]]
*