Quelltext der Seite Hilfe:Textgestaltung

{{Hilfe}}
Diese Seite erklärt, wie du in {{WP|Wikitext|Wiki-Syntax}} Überschriften, Listen und Absätze erzeugst und Textstellen formatierst. Aus den Überschriften generiert die [[Hilfe:MediaWiki|Software]] ein automatisches [[Hilfe:Inhaltsverzeichnis|Inhaltsverzeichnis]] (zu tiefgreifenderen Informationen siehe auch die Hilfeseiten über [[Hilfe:Vorlagen|Vorlagen]] und [[Hilfe:Parserfunktionen|Parserfunktionen]]).

== Hinweise ==
Bitte beachte die [[Hilfe:Textgestaltung#Formatierungen, die nicht in Wiki-Artikeln verwendet werden sollten|Wiki-Richtlinien zur Formatierung]]. Insbesondere

* kleiner- und größergeschriebenen Text,
* harte Zeilenumbrüche mit [[Hilfe:Tags#br|br-Tags]],
* durch mehrfache Leerzeilen erzeugte leere Absätze als vertikaler Abstand,
* [[Hilfe:Farbe|Farben]] und ähnliche Spezialformatierungen

solltest du nicht in Artikeln, sondern nur in [[Hilfe:Tabellen|Tabellen]] oder [[Hilfe:Vorlagen|Textbausteinen]] verwenden, um ein einheitliches Aussehen der Artikel zu gewährleisten. Ansonsten bietet die Wikiauszeichnungssprache genügend Möglichkeiten, den Text zu formatieren.

Fett- und Kursivschreibung soll ''nicht'' mit {{WP|Hypertext Markup Language|HTML}}-{{WP|Tag (Informatik)|Tags}} formatiert werden.

Hast du Fragen, die das Layout innerhalb eines Absatzes betreffen, beispielsweise das Umfließen von Tabellen oder Bilddateien, schaue dir die Seiten zum [[/Layoutfluss/]] und zum [[/Zentrieren/]] an.

Der Lesefluss innerhalb eines Artikels sollte nicht durch hervorgehobene Textelemente gestört werden.

== Möglichkeiten zur Formatierung von Wiki-Artikeln ==
{{Tabellenstile}}
{| class="wikitable toptextcells tabelle-kopf-fixiert"
|+ style="margin-bottom:1em;"| Möglichkeiten zur Formatierung von [[CowboysWiki:Artikel|Wiki-Artikeln]]<br /> (wirken auch in anderen [[Hilfe:Namensräume|Namensräumen]])
|- class="hintergrundfarbe8"
!style="width:50%"| Was du schreibst
! Wie es dargestellt wird
|-
| <code style="border:none;">Normaler Text wird so dargestellt, wie du ihn eingibst. Mit einer Leerzeile <br /> <br /> (zwei aufeinanderfolgende Umbrüche) erzeugst du einen neuen Absatz.</code>
|
Normaler Text wird so dargestellt, wie du ihn eingibst. Mit einer Leerzeile

(zwei aufeinanderfolgende Umbrüche) erzeugst du einen neuen Absatz.
|- id="br"
|
<code style="border:none;">Ein erzwungener Zeilenumbruch &lt;br&nbsp;/>
sollte normalerweise vermieden werden – lieber eine Zeile freilassen und einen neuen Absatz beginnen.</code>
|
Ein erzwungener Zeilenumbruch <br />
sollte normalerweise vermieden werden – lieber eine Zeile freilassen und einen neuen Absatz beginnen.
(siehe&nbsp;[[Hilfe:Tags&nbsp;#br]])
|- id="kursiv"
| <code><nowiki>''kursiv''</nowiki></code>
| ''kursiv'' (siehe [[CowboysWiki:Typografie #Schriftauszeichnung]])
|- id="fett"
| <code><nowiki>'''fett'''</nowiki></code>
| '''fett''' (im fortlaufenden Text, „Fließtext“, bitte sparsam verwenden – in der Regel nur vorgesehen für das Artikelstichwort in der Einleitung sowie für Begriffe, die als [[Hilfe:Weiterleitung|Weiterleitung]] auf diesen Artikel verweisen)
|-
| <code><nowiki>'''''fett und kursiv'''''</nowiki></code>
| '''''fett und kursiv''''' (sollte vermieden werden)
|-
| <code>&lt;[[Hilfe:TeX|math]]&gt;c = \sqrt{a^2 + b^2}&lt;/math&gt;</code>
| <math>c = \sqrt{a^2 + b^2}</math> (Hilfe dazu siehe [[Hilfe:TeX]])
|- id="sup"
| <code>Text <nowiki><sup>hochgestellt</sup></nowiki></code>
| Text <sup>hochgestellt</sup>
|- id="sub"
| <code>Text <nowiki><sub>tiefgestellt</sub></nowiki></code>
| Text <sub>tiefgestellt</sub>
|- id="Überschriften" class="hintergrundfarbe8"
|colspan="2" style="text-align:center;"| '''Überschriften'''<br /> Einzelheiten dazu siehe auch [[Hilfe:Überschrift]]
|-
|
<pre style="border:none; line-height:2em; margin:.3em; padding:0;">
== Überschrift Ebene 2 ==
=== Überschrift Ebene 3 ===
==== Überschrift Ebene 4 ====
===== Überschrift Ebene 5 =====
====== Überschrift Ebene 6 ======
</pre>
|
<div style="margin-top:-1em;">{{Überschriftensimulation|2|Text=Überschrift Ebene 2}}
{{Überschriftensimulation|3|Text=Überschrift Ebene 3}}
{{Überschriftensimulation|4|Text=Überschrift Ebene 4}}
{{Überschriftensimulation|5|Text=Überschrift Ebene 5}}
{{Überschriftensimulation|6|Text=Überschrift Ebene 6}}</div>
|- id="Listen" class="hintergrundfarbe8"
|colspan="2" style="text-align:center;"| '''Listen'''<br /> Einzelheiten dazu siehe auch [[Hilfe:Listen]]
|-
|
<pre style="border:none; margin:.2em; padding:0;">
* eins
* zwei
** zwei-eins
** zwei-zwei
* drei

* neue Liste!
** Unterpunkt der neuen Liste</pre>
|
* eins
* zwei
** zwei-eins
** zwei-zwei
* drei

* neue Liste!
** Unterpunkt der neuen Liste
<div class="hintergrundfarbe5" style="border:1px solid #808080; margin:5px 3px 0 3px; padding:0 5px 2px 5px;">Achtung: Eine Leerzeile (oder ein neuer Absatz) zwischen den Listenelementen weist die Software an, eine neue Liste zu beginnen.</div>
|-
|
<pre style="border:none; margin:.2em; padding:0;">
# eins
# zwei
## zwei-eins
## zwei-zwei
# drei: Es ist zu beachten, dass …

## … Leerzeilen zwischen den Aufzählungen auch zu einem semantischen Bruch führen.</pre>
|
# eins
# zwei
## zwei-eins
## zwei-zwei
# drei: Es ist zu beachten, dass …

## … Leerzeilen zwischen den Aufzählungen auch zu einem semantischen Bruch führen.
<div class="hintergrundfarbe5" style="border:1px solid #808080; margin:5px 3px 0 3px; padding:0 5px 2px 5px;">Achtung: Wie im Beispiel beschrieben, muss pro neue Zeile ein neues Listenelement stehen, ansonsten wird die Liste beendet. Eine Leerzeile (oder ein neuer Absatz) zwischen den Listenelementen weist die Software an, eine neue Liste zu beginnen.</div>
|- id="Definitionsliste"
|
<pre style="border:none; margin:.2em; padding:0;">
; Definitionsliste
: Eine Definition
: Eine andere Definition
; Begriff
: Definition des Begriffs
</pre>
| {{Anker|Semikolonmissbrauch}}
; Definitionsliste
: Eine Definition
: Eine andere Definition
; Begriff: Definition des Begriffs
<div class="hintergrundfarbe5" style="border:1px solid #808080; margin:5px 3px 0 3px; padding:0 5px 2px 5px;">Definitionslisten können zur Unterscheidung verschiedener Fachbegriffe benutzt werden. Sie sind '''nicht''' dafür verwendbar, durch das Semikolon Fettschreibung oder Zwischenüberschriften zu erzeugen, da die Auszeichnung vom {{WP|Stylesheet-Sprache|Stylesheet}} abhängig ist.</div>
|- id="Formatierung" class="hintergrundfarbe8"
! colspan="2"| Formatierung
|-
|
<pre style="border:none; margin:.2em; padding:0;">
 vorformatierter Text
  mit einem Leerzeichen am Zeilenanfang</pre>
|
 vorformatierter Text
   mit einem Leerzeichen am Zeilenanfang
|-
| Für Gedichte und ähnliche Texte:
<code style="border:none;">
&lt;[[Hilfe:Poem|poem]]><br />
Ob ich Biblio- was bin?<br />
phile? „Freund von Büchern“ meinen Sie?<br />
Na, und ob ich das bin!<br />
Ha! und wie!<br />
&lt;/poem></code>
|
<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!
</poem>
|- id="code"
| <code>[[Hilfe:Tags#code|&lt;code>]]Markiert Text als Quelltext, Dateiname, Pfad, Kommando&lt;/code></code>
|class="hintergrundfarbe5"| <code>Markiert Text als Quelltext, Dateiname, Pfad, Kommando</code>
|- id="Kommentar"
|
<pre style="border:none; margin:.2em; padding:0;">Das ist ein<!-- unsichtbarer Kommentar im--> Text.</pre>
| Das ist ein<!-- unsichtbarer Kommentar im--> Text.
|-
|
<code style="border:none; margin:.2em; padding:0;">Mit dem {{WP|Geschütztes Leerzeichen|geschützten Leerzeichen}} ''(non-breaking space)'' den Zeilenumbruch zwischen logisch zusammengehörenden Elementen verhindern (möglichst nur bei kurzen Elementen verwenden): Nr.&amp;nbsp;1, 10&amp;nbsp;kg, Dr.&amp;nbsp;Best</code>
|
Mit dem {{WP|Geschütztes Leerzeichen|geschützten Leerzeichen}} ''(non-breaking space)'' den Zeilenumbruch zwischen logisch zusammengehörenden Elementen verhindern (möglichst nur bei kurzen Elementen verwenden): Nr.&nbsp;1, 10&nbsp;kg, Dr.&nbsp;Best

{{Anker|Prozent}}
Ausnahme: &amp;nbsp; ist [[CowboysWiki:Projektneuheiten/Archiv/2007-1#Softwareerweiterungen|nicht nötig]] beim Prozentzeichen, also 100 % mit Leerzeichen.
|-
|style="font-family:monospace;"|
&#123;{[[Vorlage:Zitat|Zitat]]<br /> &nbsp;&#124;Text=Zitierter Text (als {{WP|Blockzitat}}, für mehrzeilige Zitate in ganzen Sätzen).}&#125;
|
{{Zitat
 |Text=Zitierter Text (als {{WP|Blockzitat}}, für mehrzeilige Zitate in ganzen Sätzen).}}
|-
| <code style="border:none; margin:.2em; padding:0;">Oder <span style="white-space:nowrap"><nowiki>{{" |kurzer zitierter Text}}</nowiki>,</span> auch mitten im Satz (stattdessen können die Anführungszeichen auch direkt eingegeben werden).</code>
|
Oder {{"|kurzer zitierter Text}}, auch mitten im Satz (stattdessen können die Anführungszeichen auch direkt eingegeben werden).
|}

== {{Anker|nicht|nicht in normalen Wiki-Artikeln}} Formatierungen, die nicht in Wiki-Artikeln verwendet werden sollten ==
<!--
! Dieser Hinweis betrifft vorstehenden "{{Anker|…}}":
! Wird oben auch in der Tabellenüberschrift verwendet,
! aber auch um diesen Tabellenabschnitt allgemein wie folgt
! von „außerhalb“ verlinken zu können:
! [[Hilfe:Textgestaltung#nicht in normalen Wikipedia-Artikeln]]
! Deshalb bitte Anker-Text nicht ändern.
-->
Folgende Formatierungen sollten im Artikelnamensraum im Normalfall nicht verwendet werden, da sie die Leserlichkeit stören (zum Beispiel ''groß'', ''klein'', ''Farben''), in diesem Zusammenhang unsinnig sind (zum Beispiel ''Durchstreichungen'') oder einen {{WP|Formale Semantik|formal-semantisch}} falschen {{WP|Extensible Hypertext Markup Language|Code}} (Missbrauch von Definitionslisten, Einrückungen) erzeugen; möglicherweise technisch veraltet sind. Es kann in Einzelfällen (etwa innerhalb von Tabellen) nötig sein, diese Formatierungen zu benutzen, gehe damit aber in jedem Fall sparsam um. Derartige kaputte logische Strukturen eignen sich beispielsweise nicht für Text-zu-Sprache-Programme für sehbehinderte Menschen, die auf ein {{WP|barrierefreies Internet}} angewiesen sind.

{| class="wikitable toptextcells tabelle-kopf-fixiert"
|+ style="margin-bottom:1em;"| Formatierungen, die <span style="font-size:larger;">{{Hilfe/mark|'''''nicht'''''|hellrot}}</span> in Artikeln verwendet werden sollten
|- id="veraltet"
|colspan="2" class="hintergrundfarbe-basis" style="border:2px solid #{{Standardfarbe|rahmen|3}};"| Generell soll keine veraltete Syntax neu in die Seiten von {{SITENAME}} eingefügt werden, wo sie vorgefunden wird, sollte sie durch zukunftsfähige Syntax ersetzt werden. Veränderte Schriftfarben sind ebenso zu vermeiden. Weitere Informationen dazu:
* [[Hilfe:CSS#veraltete Anweisungen]] und [[Hilfe:Tabellen/Veraltet]]
* [[CowboysWiki:Barrierefreiheit]] und [[Hilfe:Textgestaltung/Barrierefreiheit]]
|- class="hintergrundfarbe8"
!style="width:50%"| Was du nicht schreiben sollst
! Wie es dargestellt würde
|- id="big"
| <code><nowiki><big>groß</big></nowiki></code>
| Text <big>groß</big>
|- id="small"
| <code><nowiki><small>klein</small></nowiki></code>
| Text <small>klein</small>
|- id="div style="font-size:xyz"
| <code><nowiki><div style="font-size:125%;">Schriftgröße auf 125% setzen</div></nowiki></code>
<code><nowiki><div style="font-size:85%;">Schriftgröße auf 85% setzen</div></nowiki></code>
| <div style="font-size:125%;">Schriftgröße auf 125% setzen</div><div style="font-size:85%;">Schriftgröße auf 85% setzen</div>
|- id="strike"
| <code><nowiki><s>durchgestrichen</s></nowiki></code>
| Text <s>durchgestrichen</s>
|- id="u"
| <code><nowiki><u>unterstrichen</u></nowiki></code>
| Text <u>unterstrichen</u>
|-
| <code><nowiki><span style="color:red;">Rotlink ?</span> <span style="color:blue;">Link ?</span></nowiki></code>
| <span style="color:red;">Rotlink ?</span> <span style="color:blue;">Link ?</span>
|-
| <code><nowiki>andere <span style="font-family:serif;">Schriftart</span></nowiki></code>
| andere <span style="font-family:serif;">Schriftart</span>
|-
| <code><nowiki><nowiki>keine ''Wiki-[[Syntax]]''</nowiki></nowiki></code>
| <nowiki>keine ''Wiki-[[Syntax]]''</nowiki>
|-
| keine Vorlagensyntax <code><nowiki>{{#if: {{{Dings|}}} | {{{Dings}}} | Vorgabewert}}</nowiki></code>
| {{#if: {{{Dings|}}} | {{{Dings}}} | Vorgabewert}}
|- id="center"
| <code><nowiki><div class="center">zentriert</div></nowiki></code><br />
oder <code><nowiki><div style="text-align:center;">zentriert</div></nowiki></code>
|style="text-align:center"| [[/Zentrieren|zentriert]]
|-
| <code><nowiki><div style="text-align:right;">rechtsbündig</div></nowiki></code>
|style="text-align:right"| rechtsbündig
|-
| <code><nowiki><div style="text-align:justify;">Blocksatz</div></nowiki></code>
| <div style="text-align:justify;">Diese Formatierung bewirkt {{WP|Blocksatz}}, welcher im Artikelnamensraum nicht erwünscht ist, aber auf Projektseiten eventuell eingesetzt werden kann. An diesem Beispiel zeigen die großen, unvorhersehbaren und wahrscheinlich zum Teil ungleichmäßigen Abstände zwischen den Wörtern den entscheidenden Nachteil von ''Blocksatz in {{WP|Webseite|Webseiten}}''. Siehe auch {{WP|Flattersatz}}.</div>
|-
|
<pre style="border:none; margin:.2em; padding:0;">
Einrückungen mit dem Doppelpunkt sollten
: vermieden
:: werden,
sofern sie nicht mit Definitionslisten benutzt werden.
# Gleiches gilt für das Semikolon
# und für Einrückungen
#: innerhalb von Aufzählungen,
# die aber außerhalb des Artikelnamensraumes
# sehr nützlich sein können.</pre>
| Einrückungen mit dem Doppelpunkt sollten
: vermieden
:: werden,
sofern sie nicht mit Definitionslisten benutzt werden.<br />
# Gleiches gilt für das Semikolon
# und für Einrückungen
#: innerhalb von Aufzählungen,
# die aber außerhalb des Artikelnamensraumes
# sehr nützlich sein können.
|-
|
<pre style="border:none; margin:.2em; padding:0;">
Eine
----
horizontale Trennlinie</pre>
| Eine
----
horizontale Trennlinie
|-
| <code><nowiki>[[Garage]]n[[Tor (Architektur)|tor]][[Schloss (Technik)|schloss]]</nowiki></code>
| {{WP|Garage|Garagen}}[[wp:Tor (Architektur)|tor]][[wp:Schloss (Technik)|schloss]]
Mehrfachlinks innerhalb eines Wortes führen dazu, dass nicht erkannt wird, dass hier auf mehrere Begriffe weitergeleitet wird, die jedoch wie ein Link aussehen. [[CowboysWiki:Verlinken #Verlinkung von Teilwörtern]]
|}

== VisualEditor ==
Die Bearbeitungsumgebung [[Hilfe:VisualEditor|VisualEditor]] stellt in ihrem Hauptmenü unterschiedliche Menüpunkte bereit, mit denen die Darstellung oder Gliederung des Seitentextes beeinflusst werden kann.

* [[Hilfe:VisualEditor/Schrifteigenschaften]] – Beschreibung zur Schriftgestaltung
* [[Hilfe:Überschrift/VisualEditor]] – Überschriften und vorformatierte Textblöcke einfügen und bearbeiten oder Absätze erzeugen
* [[Hilfe:Listen/VisualEditor]] – Listen erstellen und bearbeiten
* [[Hilfe:Tags/Kommentar/VisualEditor]] – unsichtbare Kommentare einfügen und bearbeiten
* [[Hilfe:Poem/VisualEditor]] – hat kein eigenes Menü, nur die Bearbeitung ist möglich

== Wiki-Syntax aus der Bearbeitungswerkzeugleiste ==
Mithilfe der [[Hilfe:Symbolleisten#Bearbeitungswerkzeugleiste|Bearbeitungswerkzeugleiste]] lässt sich mit einem Mausklick Wiki-Syntax in den Text einfügen. Der eingefügte Beispieltext muss dann mit dem eigenen Text überschrieben werden, andernfalls wird ein [[Spezial:Missbrauchsfilter/6|Bearbeitungsfilter&nbsp;6]] ausgelöst. Dieser generiert einen Hinweis, dass sich ''Wiki-Syntax aus der Zeichenleiste'' im Text befindet und [{{canonicalurl:Spezial:Missbrauchsfilter-Logbuch|wpSearchFilter=6}} protokolliert] die Änderung. Nach einem erneuten Klick wird der Edit nicht gespeichert. Es wird ein Hinweis angezeigt:

{{Hilfe/Simulation
|content=<br />
{{MediaWiki:Abusefilter-disallowed-testeditwarn|6}}
}}

{{Hilfe/Weitere Informationen|Liste=
* [[Hilfe:Bearbeitungshilfe]] – Kurzübersicht
* [[/HTML]] – für Benutzer mit Vorkenntnissen in {{WP|Hypertext Markup Language|HTML}}
* [[Hilfe:Wikisyntax]] – mehr Hilfeseiten
* [[CowboysWiki:Formatierung]] – Richtlinien des Projekts
* [[:Kategorie:Vorlage:Formatierungshilfe]] – Vorlagen zur Formatierung von Artikeln
}}
<noinclude>
[[Kategorie:Hilfe:Formatieren]]
[[Kategorie:Hilfe:Wikisyntax]]
</noinclude>