Palita:Intern/Autorenportal/Syntax
Aus Palita
Hier werden kurz die wichtigsten Wiki-Syntaxen erklärt.
Inhaltsverzeichnis |
Allgemein
Zunächst siehst du beim Bearbeiten von Artikeln eine kleine Symbolleiste über dem Bearbeitungsfeld. Hier sind die Funktionen
- Fettschrift
- Kursivschrift
- Artikellink
- Weblink
- Überschrift
- Dateilink
- Mediendateilink
- Mathematische Formel (LaTeX)
- Unformatierter Text (Wiki-Syntax ausschalten)
- Signatur
- Horizontale Linie
- Artikel als Baustelle markieren
- Tipp-Box einfügen
- Abschnitt als komplex markieren
- Code-Block einfügen
- Erster Buchstabe des Artikels als Kleinbuchstaben anzeigen (wird standardmäßig Großgeschrieben)
bei einem Klick auf diese Buttons (evtl. mit markiertem Text / Link) fügt sich automatisch die dazu passende Wiki-Syntax ein, um den gewünschten Effekt zu erzielen. Im Folgenden gehen wir etwas detaillierter auf die Funktionen ein. Fett- und Kursivschrift sollten sich von selbst erklären.
Artikellinks
Artikellinks solltest du sinnvoll einsetzen - und zwar nur dann, wenn es Sinn macht. Denke daran, was Palita im Wiki anbieten möchte und was unsere Ziele sind. Ein link auf den Artikel Ratte macht wenig sinn, dafür gibt es schließlich Wikipedia und andere. Überleg dir einfach, bei welchem Thema es Sinn macht, einen Artikel zu verfassen, wenn es Sinn macht, dann verlinke ihn.
Verlinken kannst du Artikel mit je zwei eckigen Klammern ([[ und ]]). Zwischen den Klammern steht der Name des Artikels. Dieser sollte immer im Singular sein. Beispiel:
[[Virus]]
wird zu: Virus.
Möchtest du einen anderen Text ausgeben lassen, aber trotzdem auf den Artikel Virus verlinken, tippst du nach dem Artikelnamen eine Pipe (|) und anschließend den zu erscheinenden Text.
Beispiel:
[[Virus|Viren]]
wird zu: Viren.
Soll mal ein einziger Buchstabe drangehängt werden (oder auch mehrere), kannst du diese einfach nach dem Link-Tag ohne Leerzeichen einfügen, sie werden mit dem Link zusammengefasst, verlinken aber trotzdem auf die gewünschte Seite.
Beispiel:
[[Virus]]artikel
wird zu: Virusartikel.
Du kannst auch auf Abschnitte verlinken, egal, ob in anderen Artikeln oder auf dem Aktuellen. Dazu ergänzt du den Artikelnamen mit einer Raute (#) und dem Namen des Abschnittes. Es bietet sich dabei immer an, mit einer Pipe den Namen des Abschnittes anzugeben, da der Link ansonsten auch die Raute und den Artikelnamen enthält.
Beispiel:
[[Palita:Intern/Autorenportal/Syntax#Überschriften]] und [[Palita:Intern/Autorenportal#Überschriften|Überschriften]]
wird zu: Palita:Intern/Autorenportal/Syntax#Überschriften und Überschriften.
Wikipedia-Links
Du kannst auch Artikel verlinken, die nicht im Palita-Wiki enthalten sind, sondern auf Wikipedia. Dazu setzt du dem Artikelnamen einfach "wikipedia:" voran. Auch hier solltest du mit einer Pipe den Artikelnamen angeben, da sonst auch wikipedia: zu sehen ist.
Beispiel:
[[wikipedia:Mediawiki|Mediawiki]]
wird zu: Mediawiki.
Damit kennst du nun alle Funktionen von Artikellinks.
Weblinks
Mit Weblinks kannst du auf externe Seiten verlinken. Die Syntax ist unfassbar einfach:
http://de.wikipedia.org
wird zu: http://de.wikipedia.org.
Die bloße eingabe der URL (inkl. http://) genügt für dieses Resultat.
Möchtest du hingegen einen anderen Text für den Link anzeigen lassen, klammerst du den Link ein und gibst nach einem Leerzeichen den zu erscheinenden Text ein.
Beispiel:
[http://de.wikipedia.org Wikipedia]
wird zu: Wikipedia.
Jetzt weißt du auch alles über die Verlinkung von externen Webseiten.
Kategorisieren
Du kannst (und solltest!) Artikel zu passenden Kategorien zuordnen. Achte darauf, dass jeder Artikel in einer bestimmten Kategorie zu finden ist!
Du kannst Artikel einer Kategorie zuordnen, indem du folgendes am Ende des Artikels einfügst:
[[Kategorie:Palita]]
Somit ist der Artikel in der Kategorie:Palita zu finden. Du kannst Artikel auch in mehreren Kategorien erscheinen lassen, indem du einfach mehrfach diese Syntax eingibst.
Kategorien verlinken
Möchtest du eine Kategorie nur verlinken, setzt du einfach ein Doppelpunkt vor "Kategorie:".
Beispiel:
[[:Kategorie:Sicherheit]]
wird zu Kategorie:Sicherheit
Überschriften
Um einen Artikel leserlich zu gestalten, solltest du Überschriften verwenden. Dabei gibt es verschiedene Ebenen, angefangen bei Ebene 2 (Ebene 1 ist der Titel der Seite und sollte nicht verwendet werden!). Wenn du mehr als 2 Überschriften in einem Artikel angibst, erscheint am Anfang automatisch ein Inhaltsverzeichnis.
Das folgende Beispiel sollte eigentlich alles erklären:
== Überschrift == Hier steht der Text, der zu der Überschrift gehört. Es folgen Überschriften die unter der 2. Ebene liegen. === Unter-Überschrift === Diese Überschrift gehört ist die 3. Ebene und liegt unter der 2. Ebene. ==== Unter-Unter-Überschrift ==== Diese liegt unter der 3. Ebene == Überschrift 2 == Und noch mehr === Und so weiter === und so fort.
Das Ergebnis hiervon ist etwas zu viel für den Artikel, probier es doch einfach aus! Zum Beispiel im Sandkasten!
Beachte bitte, dass der Text unmittelbar unter der Zeile der Überschrift beginnen sollte. Eine weitere Überschrift folgt nach einer Leerzeile, also so wie in dem Beispiel dargestellt.
Bilder einbinden
Du kannst natürlich auch Bilder in Artikel einbinden, um Artikel anschaulicher zu gestalten oder um etwas besser zu erklären. Die Syntax dafür ist etwas umfangreicher, aber dennoch einfach. Da du die Grundsyntax mittlerweile kennen solltest, zeigen wir dir das komplexeste Beispiel und erklären die einzelnen Parameter.
Beispiel:
[[Bild:Palita.png|thumb|left|140px|Palita.net Schriftzug]]ergibt:
Zur Erklärung:
- Palita.png ersetzt du mit dem Dateinamen des Bildes, das du verwenden möchtest. Ein Bild musst du vorher natürlich Hochladen.
- thumb sagt, dass das Bild als Thumbnail, also Miniaturbild angezeigt werden soll. Dies solltest du wenn möglich immer machen, damit man nicht so viel scrollen muss.
- left ist optional, wenn du es weglässt, erscheint das Bild auf der rechten Seite. Dies solltest du wenn möglich immer machen, damit der Text auf der linken Seite ohne Umbruch weiter gehen kann.
- 140px ist die Größe, lässt du sie Weg, wird eine Standardgröße verwendet. Die Standardgröße reicht meistens aus, aber nicht immer. Probier es einfach aus.
- Palita.net Schriftzug ersetzt du einfach mit deiner gewünschten Unterschrift.
Weitere Parameter:
- noframe
- framed
- right
Bilder verlinken
Wenn du mal ein Bild verlinken möchtest, machst du das auf die folgende Weise:
[[:Bild:Palita.png]]
Das wird zu: Bild:Palita.png. Es gelten die gleichen Eigenschaften wie bei Artikellinks.
Bildergalerien
Du kannst auch eine Reihe von Bildern in einer Galerie anzeigen. Das eignet sich z.B. für Screenshots, die einen Arbeitsablauf oder Tutorial beschreiben. Die Syntax lautet wie Folgt:
<gallery> Bild:Bild1.png|Beschreibung Bild:Bild2.png|Beschreibung Bild:Bild3.png|Beschreibung </gallery
Damit solltest du Bilder einbinden und verlinken sowie Galerien erstellen können.
Unformatierter Text
Wenn du die Mediawiki-Syntax ausschalten möchtest, z.B. um wie hier zu Zeigen, wie die Syntax aussieht, setzt du den Text einfach zwischen <nowiki> und </nowiki>.
Beispiel:
<nowiki> [[Artikellink]] [[Bild:Bild.png|Beschreibung]] </nowiki>
wird zu [[Artikellink]] [[Bild:Bild.png|Beschreibung]] .
Zum Einrücken von Text setzt du einfach ein Leerzeichen vor jede Zeile, die unformatiert ausgegeben werden soll.
Dies sind Zeilen, die Leerzeichen und Einrückungen erscheinen komplett, zu realisieren über ein Leerzeichen am Anfang der Zeilen.
Baustellenartikel
Wenn du gerade anfängst, einen Artikel zu schreiben, aber noch nicht fertig bist (oder Hilfe brauchst), markiere den Artikel als Baustele. Somit erscheint ein Hinweis am Anfang des Artikels und der Artikel wird automatisch in die Kategorie:Baustelle aufgenommen. Das ist Sinnvoll, um eine Übersicht nicht fertiger Artikel zu bekommen.
Zum markieren einfach in die erste Zeile des Artikels klicken und auf das Baustellensymbol klicken. Damit wird {{baustelle}} eingefügt, was die Vorlage:Baustelle einbindet.
Tipp Box
Siehe Palita:Intern/Autorenportal/Vorlagen.
Abschnitt als Komplex markieren
Da palita.net sich auch an Anfänger richten soll, aber trotzdem auch detaillierte Informatinen anbieten soll, kannst du Teile eines Artikels, die für ein rudimentäres Verständnis des Themas nicht unbedingt relevant oder zu kompliziert sind, die Vorlage:Box/Komplex einbinden. Klicke dazu einfach auf das Tafelsymbol in der Symbolleiste. Damit wird {{Box/Komplex}} eingefügt, was die Vorlage einbindet.
Code-Block einfügen
Mit einem Code-Block kannst du Quellcode verschiedener Programmiersprachen mit Syntax-Highlighting zur besseren Lesbarkeit ausgeben. Klicke einfach auf das Code-Symbol und du siehst, wie es funktioniert.
Ersten Buchstaben groß schreiben
Da die Wiki-Software bei Artikeln den Anfangsbuchstaben automatisch groß schreibt, musst du die Vorlage:lcase am Anfang des Artikels einbinden, um den ersten Buchstaben klein zu schreiben. Klicke dazu einfach auf das Symbol in der Symbolleiste.
Tabellen
Tabellen sind etwas komplizierter. Wir erklären an dieser Stelle nur die Grundsyntax:
{| style="infotbl"
|-
!Kopfzeile, Spalte 1
!Kopfzeile, Spalte 2
|-
|Zeile 2, Spalte 1
|Zeile 2, Spalte 2
|-
|colspan="2" bgcolor=#C6C6C6|Zeile 3, Spalte 1
|-
|}
wird zu:
| Kopfzeile, Spalte 1 | Kopfzeile, Spalte 2 |
|---|---|
| Zeile 2, Spalte 1 | Zeile 2, Spalte 2 |
| Zeile 3, Spalte 1 | |
Zu beachten ist, dass hier die CSS-Klasse 'infotbl für die Tabelle verwendet wird. Weitere Vorlagen und CSS-Vorlagen findest du unter Palita:Intern/Autorenportal/Vorlagen#Tabellen.
Schluss
Das sind die Grundfunktionen der Wiki-Software. Eine sehr umfangreiche Hilfe findest du auf wikipedia: http://de.wikipedia.org/wiki/Hilfe:Bearbeiten
