Aus Ubuntu-Forum Wiki

(Unterschied zwischen Versionen)

Wechseln zu: Navigation, Suche

Aktuelle Version vom 1. Februar 2011, 10:33 Uhr

Inhaltsverzeichnis

1 Allgemeines
2 Links darstellen
3 Schriftgestaltung
4 Gliederung
- 4.1 Überschriften
- 4.2 Aufzählungen und Einrückungen
5 Vorlagen
- 5.1 Format-Vorlagen
6 Syntaxhervorhebungen
7 Tipp
8 Links

1 Allgemeines

Dieser Artikel soll Fragen, die beim Verfassen zum Formatieren von Wiki-Artikeln auftreten, beantworten. Ein optisch gut aufbereiteter Artikel fördert dessen Verständlichkeit und macht beim Lesen und Schreiben einfach mehr Spaß.

Um die Übersichtlichkeit zu wahren, werden nur die wichtigsten Formatierungen erwähnt. Am Ende des Artikels wird auf weiterführende Seite verwiesen.

2 Links darstellen

2.1 Interne Links

Verweise auf eine Wiki-Seite

[[name]] » Name muss einer Seite des Wikis genau entsprechen
[[name#abschnitt]] » Verweis auf einen Abschnitt (eine Überschrift) einer Seite

Umleitung auf eine Wiki-Seite

Man kann auch eine Seite direkt auf eine andere Seite oder einen Abschnitt in dieser umleiten lassen. Das macht zum Beispiel Sinn, wenn verschiedene Namen eines Artikels möglich sind oder ein Thema zwar eine eigene rechtfertigen würde, es aber schon hinreichend im Kontext eines anderen erklärt wurde. Dazu muss dann nur eine neue Seite erstellt werden, die nur den folgenden Inhalt hat:

Umleitung auf eine Seite

#REDIRECT [[name]]

Umleitung auf einen Unterpunkt

#REDIRECT [[name#abschnitt]]

2.2 Externe Links

Eingabe des kompletten URL » wird genauso wiedergegeben
[URL name_des_links] » Name des Links wird angezeigt

2.3 Grafiken

Auch Grafiken werden als Verweis gehandhabt. Dazu muss eine Grafik zunächst hochgeladen oder aus den schon vorhandenen ausgewählt werden. Dann kann sie mit dem Syntax [[Bild:name_des_bildes]] in den Artikel eingebunden werden.

2.3.1 Versionsangaben

Nicht ganz unwichtig ist die Ubuntu-Version, für die ein Beitrag geschrieben wurde. Daher sollten entsprechende Icons an den Beginn, noch vor dem Inhaltsverzeichnis, gesetzt werden:

Bitte immer mit der aktuellsten Version beginnen, also 10.10, 10.04, 9.10...

Syntax der Icons

» [[Bild:1004.png]] (Lucid Lynx)

Graue Icons kennzeichnen Ubuntu-Versionen, deren Lebenszyklus beendet ist!

3 Schriftgestaltung

Textformatierung	Wiki-Code
Kursivschrift	''Kursivschrift''
Fettschrift	'''Fettschrift'''
kursive Fettschrift	'''''kursive Fettschrift'''''

Um Code oder Befehle zu kennzeichnen, genügt es, die betreffende(n) Zeile(n) mit einem Leerzeichen zu beginnen:

sudo apt-get update

Wenn ein bestimmter Text nicht als Wiki-Code interpretiert werden soll, so muss er in folgende Tags gesetzt werden: <nowiki>unformatierter Text</nowiki>

4 Gliederung

4.1 Überschriften

Überschriften werden durch ='-Zeichen eingeschlossen und gekennzeichnet. Dabei muss jeweils die gleiche Anzahl am Anfang und am Ende der Überschrift stehen. Ihre Anzahl gibt die Gliederungsebene an:

Darstellung	Wiki-Code
1. Überschrift zweiter Ebene*	== Überschrift ==
1.1 Überschrift dritter Ebene	=== Überschrift ===
Absatzüberschrift ohne Nummerierung	;Überschrift

* Überschriften erster Ebene werden nicht verwendet, da sie der Artikelüberschrift vorbehalten sind. Absätze bzw. eine neue Zeile wird mit einer Leerzeile im Text erreicht.

In neuen Artikeln sollen die Überschriften mit der zweiten Ebene (also ==) beginnen.

Dadurch soll die eine bessere Abgrenzung zur Artikel-Titel erreicht werden. Außerdem gibt der Editor der Wiki-Software diese Ebene auch als Anfangswert vor.

4.2 Aufzählungen und Einrückungen

Darstellung	Wiki-Code
Stichpunkt eingerückter Stichpunkt	* Stichpunkt ** eingerückter Stichpunkt
nummerierter Listenpunkt untergeordneter Listenpunkt 1 untergeordneter Listenpunkt 2	# nummerierter Listenpunkt ## untergeordneter Listenpunkt 1 ## untergeordneter Listenpunkt 2

5 Vorlagen

5.1 Format-Vorlagen

Format-Vorlagen werden dazu verwendet, um bestimmte Textstellen besonders hervorzuheben. Dies geschieht wiki-weit. Es muss also nur eine Datei verändert werden, um sämtliche Textstellen neu zu gestalten.

Beispiel

Darstellung aller Hinweise

Soll nun das Aussehen aller Hinweise geändert werden, muss nur die entsprechende Vorlage dafür angepasst werden. Das vermindert den Aufwand bei einer Design-Umstellung oder -Änderung erheblich, da nicht jeder Hinweis einzeln auf jeder Seite angepasst werden muss. Die Vorlage selber besteht aus CSS-Code, der die Formatierung des Textes beschreibt.

Um eine Vorlage nutzen zu können, muss nur der folgende Code in den Artikel eingefügt werden. Dann muss der Name der Vorlage (ohne de Präfix Vorlage:)eingetragen und der Text an die Stelle des Mustertextes gesetzt werden.

{| {{Name}}
| Mustertext
|}

Dabei ist wichtig, dass die erste und letzte Zeile nur die angegebenen Inhalte haben - sie dienen als Anfangs- und Endmarkierung. Der auszugebende Text kann dabei auch mehrere Zeilen umfasse.

Der Code für einen Hinweis würde dementsprechend folgendermaßen aussehen:

{| {{Hinweis}}
| Darstellung aller Hinweise
|}

Vorlagen » häufig verwendete Vorlagen im Wiki

6 Syntaxhervorhebungen

Viele Artikel beinhalten Auszüge von Quellcode, manche auch ganze Programme. Um die Übersichtlichkeit und Lesbarkeit dieser Artikel zu steigern, kann man die Schlüsselworte des jeweiligen Codes farbig hervorheben. Das kann dieses Wiki automatisch mit Hilfe einer Erweiterung vornehmen.

Dazu muss man lediglich folgendes im Quellcode hinzufügen:

Syntax

<source lang="php">
<?php
  echo 'Nice Job, Developers!';
?>
</source>

Hinter den Parameter lang="xxx" kann man noch den Parameter line setzen. Damit schaltet man die Zeilennummerierung für den Quellcode ein.

Anzeige

<?php
  echo 'Nice Job, Developers!';
?>

GeSHi-Erweiterung für Syntaxhervorhebung » weiterführender Artikel

7 Tipp

Da man sich immer den Quellcode einer Seite ansehen kann, kann man sich so auch den dort verwendeten Code zu Nutze machen.

8 Links

Intern

Formatierung » Wiki-Texte formatieren
Formatierung/Tabellen » Wiki-Tabellen erstellen

Extern

Mediawiki-Handbuch » Kapitel zur Formatierung

@@ Zeile 1: / Zeile 1: @@
 __TOC__
 =Allgemeines=
-Diese Seite soll Fragen, die das Verfassen und vor allem Formatieren von Wiki-Artikeln betreffen, beantworten. Ein optisch gut aufbereiteter Artikel fördert schließlich dessen Verständlichkeit und macht beim Lesen und Schreiben einfach mehr Spaß.
+Dieser Artikel soll Fragen, die beim [[Hilfe:Verfassen |Verfassen ]] zum Formatieren von Wiki-Artikeln auftreten, beantworten. Ein optisch gut aufbereiteter Artikel fördert dessen Verständlichkeit und macht beim Lesen und Schreiben einfach mehr Spaß.
 Um die Übersichtlichkeit zu wahren, werden nur die wichtigsten Formatierungen erwähnt. Am Ende des Artikels wird auf weiterführende Seite verwiesen.
 =Links darstellen=
@@ Zeile 10: / Zeile 9: @@
 ;Verweise auf eine Wiki-Seite:
 * '''[['''''name''''']]''' &raquo; Name muss einer Seite des Wikis genau entsprechen
-* '''[['''''name'''''#'''''abschnitt''''']]''' &raquo; Verweis auf einen Abschnitt, eine Überschrift, einer Seite
+* '''[['''''name'''''#'''''abschnitt''''']]''' &raquo; Verweis auf einen Abschnitt (eine Überschrift) einer Seite
 ;Umleitung auf eine Wiki-Seite:
@@ Zeile 31: / Zeile 29: @@
 Nicht ganz unwichtig ist die Ubuntu-Version, für die ein Beitrag geschrieben wurde. Daher sollten entsprechende [[Ubuntu-Forum_Wiki:Verfassen#Aufbau_eines_Artikels|Icons]] an den Beginn, noch vor dem Inhaltsverzeichnis, gesetzt werden:
-''Bitte immer mit der aktuellsten Version beginnen, also 8.04, 7.10, 7.04, 6.10, 6.06...''
+''Bitte immer mit der aktuellsten Version beginnen, also 10.10, 10.04, 9.10...''
 ;Syntax der Icons:
+[[Bild:1004.png]] &raquo; <nowiki>[[Bild:1004.png]]</nowiki> (''Lucid Lynx'')
-[[Bild:804.png]] &raquo; <nowiki>[[Bild:804.png]]</nowiki> Hardy Heron
+{| {{Hinweis}}
+| Graue Icons kennzeichnen Ubuntu-Versionen, deren Lebenszyklus beendet ist!
-[[Bild:710.png]] &raquo; <nowiki>[[Bild:710.png]]</nowiki> Gutsy Gibbon
+|}
-[[Bild:704.png]] &raquo; <nowiki>[[Bild:704.png]]</nowiki> Feisty Fawn
-[[Bild:610.png]] &raquo; <nowiki>[[Bild:610.png]]</nowiki> Edgy Eft
-[[Bild:606.png]] &raquo; <nowiki>[[Bild:606.png]]</nowiki> Dapper Drake
-[[Bild:510.png]] &raquo; <nowiki>[[Bild:510.png]]</nowiki> Breezy Badger
-[[Bild:504.png]] &raquo; <nowiki>[[Bild:504.png]]</nowiki> Hoary Hedgehog
-[[Bild:410.png]] &raquo; <nowiki>[[Bild:410.png]]</nowiki> Warty Warthog
-Anstatt des ganzen Bildlinks kannst du auch <tt><nowiki> {{7.10}} </nowiki></tt> eintragen, dann erscheint nach dem Speichern das Icon auch (für die anderen Versionen die jeweilige Versionnummer verwenden).
 =Schriftgestaltung=
-{| border=1
+{| {{tabelle}}
-!width=50%| Textformatierung
+!width=50% | Textformatierung
-!width=50%| Code
+!width= 50 | Wiki-Code
 |--
@@ Zeile 85: / Zeile 68: @@
 ==Überschriften==
-Überschriften werden mit dem Zeichen '''=''' gekennzeichnet. Dabei muss jeweils die gleiche Anzahl am Anfang und am Ende der Überschrift stehen. Ihre Anzahl gibt die Gliederungstiefe an:
+Überschriften werden durch '''=''''-Zeichen eingeschlossen und gekennzeichnet. Dabei muss jeweils die gleiche Anzahl am Anfang und am Ende der Überschrift stehen. Ihre Anzahl gibt die Gliederungsebene an:
-{|border=1
+{|{{Tabelle}}
-!width=50%| Darstellung
+!width=50% | Darstellung
-!width=50%| Code
+!width=50% | Wiki-Code
 |--
 |
-'''1. Überschrift ersten Ranges'''
+'''1. Überschrift zweiter Ebene'''*
 |
-<nowiki>=Überschrift=</nowiki>
+<nowiki>== Überschrift ==</nowiki>
 |--
 |
-'''1.1 Überschrift zweiten Ranges'''
+'''1.1 Überschrift dritter Ebene'''
 |
-<nowiki>==Überschrift==</nowiki>
+<nowiki>=== Überschrift ===</nowiki>
 |--
@@ Zeile 107: / Zeile 90: @@
 '''Absatzüberschrift ohne Nummerierung'''
 |
-<nowiki>;Überschrift:</nowiki>
+<nowiki>;Überschrift</nowiki>
 |}
-...usw.
+<nowiki>*</nowiki> ''Überschriften erster Ebene werden nicht verwendet, da sie der Artikelüberschrift vorbehalten sind.''
+Absätze bzw. eine neue Zeile wird mit einer Leerzeile im Text erreicht.
-Absätze bzw. eine neue Zeile wird mit einer Leerzeile im Code erreicht.
+{| {{warnung}}
+ | In '''neuen''' Artikeln sollen die Überschriften mit der ''zweiten'' Ebene (also '''==''') beginnen.
+ |}
+Dadurch soll die eine bessere Abgrenzung zur Artikel-Titel erreicht werden. Außerdem gibt der Editor der Wiki-Software diese Ebene auch als Anfangswert vor.
 ==Aufzählungen und Einrückungen==
 {| {{Tabelle}} border="1"
 !width=50%| Darstellung
-!width=50%| Code
+!width=50%| Wiki-Code
 |--
@@ Zeile 136: / Zeile 123: @@
 <nowiki>## untergeordneter Listenpunkt 1</nowiki><br>
 <nowiki>## untergeordneter Listenpunkt 2</nowiki>
 |}
-Der Doppelpunkt kann an jeder Stelle eingesetzt werden, um Einrückungen vorzunehmen. Er funktioniert dabei wie die TAB-Taste, das heißt, je mehr Doppelpunkte hintereinander stehen, desto tiefer in Einrückung.
 =Vorlagen=
@@ Zeile 165: / Zeile 150: @@
 |}
-* [[Ubuntu-Forum_Wiki:Vorlagen|Vorlagen]] &raquo; häufig verwendete Vorlagen im Wiki
+* [[Vorlagen]] &raquo; häufig verwendete Vorlagen im Wiki
 =Syntaxhervorhebungen=
@@ Zeile 190: / Zeile 175: @@
 </source>
-* [[Hilfe:Erweiterungen/Geshi|GeSHi-Erweiterung für Syntaxhervorhebung]] weiterführender Artikel
+* [[Hilfe:Erweiterungen/Geshi|GeSHi-Erweiterung für Syntaxhervorhebung]] &raquo; weiterführender Artikel
 =Tipp=
@@ Zeile 196: / Zeile 181: @@
 =Links=
-* [[Tabellen]]
+{{Links hilfe formatierung}}
-* [http://de.wikipedia.org/wiki/Hilfe Hilfe von Wikipedia]
-* [http://meta.wikimedia.org/wiki/Help:Contents Handbuch von Mediawiki]
-* [http://wiki.zum.de/Hilfe:Textgestaltung ZUM-Wiki]
 [[Kategorie:Hilfe]]

Hilfe:Formatierung

Aus Ubuntu-Forum Wiki

Aktuelle Version vom 1. Februar 2011, 10:33 Uhr

Inhaltsverzeichnis

1 Allgemeines

2 Links darstellen

2.1 Interne Links

2.2 Externe Links

2.3 Grafiken

2.3.1 Versionsangaben

3 Schriftgestaltung

4 Gliederung

4.1 Überschriften

4.2 Aufzählungen und Einrückungen

5 Vorlagen

5.1 Format-Vorlagen

6 Syntaxhervorhebungen

7 Tipp

8 Links

Meine Werkzeuge

Namensräume

Varianten

Ansichten

Aktionen

Suche

Forum

Navigation

Internes

Bearbeitungshilfen

Werkzeuge