Hilfe:Formatierung

Aus Ubuntu-Forum Wiki

(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Überschriften)
(Syntaxhervorhebungen)
 
(Der Versionsvergleich bezieht 18 dazwischenliegende Versionen mit ein.)
Zeile 1: Zeile 1:
__TOC__
__TOC__
=Allgemeines=
=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.
Um die Übersichtlichkeit zu wahren, werden nur die wichtigsten Formatierungen erwähnt. Am Ende des Artikels wird auf weiterführende Seite verwiesen.
-
 
=Links darstellen=
=Links darstellen=
Zeile 10: Zeile 9:
;Verweise auf eine Wiki-Seite:
;Verweise auf eine Wiki-Seite:
* '''[['''''name''''']]''' » Name muss einer Seite des Wikis genau entsprechen
* '''[['''''name''''']]''' » Name muss einer Seite des Wikis genau entsprechen
-
* '''[['''''name'''''#'''''abschnitt''''']]''' » Verweis auf einen Abschnitt, eine Überschrift, einer Seite
+
* '''[['''''name'''''#'''''abschnitt''''']]''' » Verweis auf einen Abschnitt (eine Überschrift) einer Seite
-
 
+
;Umleitung auf eine Wiki-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:
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:
;Syntax der Icons:
-
[[Bild:1004.png]] &raquo; <nowiki>[[Bild:1004.png]]</nowiki> Lucid Lynx
+
[[Bild:1004.png]] &raquo; <nowiki>[[Bild:1004.png]]</nowiki> (''Lucid Lynx'')
-
 
+
-
[[Bild:910.png]] &raquo; <nowiki>[[Bild:910.png]]</nowiki> Karmic Koala
+
-
 
+
-
[[Bild:904.png]] &raquo; <nowiki>[[Bild:904.png]]</nowiki> Jaunty Jackalope
+
-
 
+
-
[[Bild:810.png]] &raquo; <nowiki>[[Bild:810.png]]</nowiki> Intrepid Ibex
+
-
 
+
-
[[Bild:804.png]] &raquo; <nowiki>[[Bild:804.png]]</nowiki> Hardy Heron
+
-
 
+
-
[[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 kann auch <tt><nowiki> {{9.04}} </nowiki></tt> eingetragen werden. Dann erscheint nach dem Speichern das Icon auch für die anderen Versionen die jeweilige Versionnummer verwenden.
+
{| {{Hinweis}}
{| {{Hinweis}}
-
| Graue Icons kennzeichnen Versionen, deren Lebenszyklus beendet ist!
+
| Graue Icons kennzeichnen Ubuntu-Versionen, deren Lebenszyklus beendet ist!
|}
|}
=Schriftgestaltung=
=Schriftgestaltung=
-
{| {{Tabelle}} border=1
+
{| {{tabelle}}
-
!width=50%| Textformatierung
+
!width=50% | Textformatierung
-
!width=50%| Code
+
!width= 50 | Wiki-Code
|--
|--
Zeile 95: Zeile 68:
==Überschriften==
==Ü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:
-
{|{{Tabelle}} border=1
+
{|{{Tabelle}}  
-
!width=50%| Darstellung
+
!width=50% | Darstellung
-
!width=50%| Code
+
!width=50% | Wiki-Code
|--
|--
|
|
-
'''1. Überschrift erster Ebene'''
+
'''1. Überschrift zweiter Ebene'''*
|
|
-
<nowiki>= Überschrift =</nowiki>
+
<nowiki>== Überschrift ==</nowiki>
|--
|--
|
|
-
'''1.1 Überschrift zweiter Ebene'''
+
'''1.1 Überschrift dritter Ebene'''
|
|
-
<nowiki>== Überschrift ==</nowiki>
+
<nowiki>=== Überschrift ===</nowiki>
|--
|--
Zeile 119: Zeile 92:
<nowiki>;Überschrift</nowiki>
<nowiki>;Überschrift</nowiki>
-
|};Übersicht
+
|}
-
...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 Text erreicht.
{| {{warnung}}
{| {{warnung}}
-
  | In neuen Artikeln sollen die Überschriften mit der ''zweiten'' Ebene (also '''==''') beginnen.
+
  | 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 die Wiki-Software diese Ebene auch als Anfangswert vor.
+
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==
==Aufzählungen und Einrückungen==
{| {{Tabelle}} border="1"
{| {{Tabelle}} border="1"
!width=50%| Darstellung
!width=50%| Darstellung
-
!width=50%| Code
+
!width=50%| Wiki-Code
|--
|--
Zeile 151: Zeile 123:
<nowiki>## untergeordneter Listenpunkt 1</nowiki><br>
<nowiki>## untergeordneter Listenpunkt 1</nowiki><br>
<nowiki>## untergeordneter Listenpunkt 2</nowiki>
<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=
=Vorlagen=
Zeile 205: Zeile 175:
</source>
</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=
=Tipp=
Zeile 211: Zeile 181:
=Links=
=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]]
[[Kategorie:Hilfe]]

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

Inhaltsverzeichnis

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

#REDIRECT [[name]]
#REDIRECT [[name#abschnitt]]

2.2 Externe Links

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

1004.png » [[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

  1. nummerierter Listenpunkt
    1. untergeordneter Listenpunkt 1
    2. 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
|}

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!';
?>

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
Extern
Meine Werkzeuge
Namensräume
Varianten
Aktionen
Forum
Navigation
Internes
Bearbeitungshilfen
Werkzeuge