Views

Difference between revisions of "How do I format my contents?"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Headings and paragraphs)
(Wiki Syntax and HTML)
 
(54 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div class="breadcrumb">
+
{{Breadcrumb|en|Wie formatiere ich meine Inhalte?|Getting started}}
{{up}} [[Getting started]] | {{de}} [[Wie formatiere ich meine Inhalte?]]
 
</div>
 
  
 
__TOC__
 
__TOC__
 
+
== Wiki Syntax and HTML ==
== Wiki syntax and HTML ==
 
  
 
You can only enter simple text in the edit field of an article. In order to convert this text to properly formatted content when presenting the article, you have to insert structuring and formatting instructions in the text. The text field supports the use of two languages here:
 
You can only enter simple text in the edit field of an article. In order to convert this text to properly formatted content when presenting the article, you have to insert structuring and formatting instructions in the text. The text field supports the use of two languages here:
  
 
* Wiki's own syntax. This is especially simple and allows even inexperienced authors to create properly structured and formatted text quickly.
 
* Wiki's own syntax. This is especially simple and allows even inexperienced authors to create properly structured and formatted text quickly.
* Parts of [http://en.wikipedia.org/wiki/HTML HTML] including [http://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS]. However, you should only use HTML/CSS if the desired objective cannot be achieved with the assistance of Wiki's own syntax.
+
* Parts of [http://en.wikipedia.org/wiki/HTML HTML] including [http://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS]. However, you should only use HTML/CSS if the desired objective cannot be achieved using Wiki's own syntax.
  
If you actually need HTML/CSS in the article, you will need knowledge of these languages. We will look primarily at the fundamentals of the Wiki syntax here.
+
If you actually need HTML/CSS in an article, you will need knowledge of these languages. We will look primarily at the fundamentals of the Wiki syntax here.
  
 
You can use the [[Sandbox|sandbox]] to familiarize yourself with the formatting options described below.
 
You can use the [[Sandbox|sandbox]] to familiarize yourself with the formatting options described below.
  
== Headings and paragraphs ==
+
== Breadcrumb ==
 +
 
 +
If possible the page should have a breadcrumb link path.
 +
 
 +
Information about syntax and examples are available on the template page: [[Template:Breadcrumb]].
 +
 
 +
== Headings and Paragraphs ==
  
 
Always split longer articles into a number of sections. Each section is introduced by a section heading. This is how you format a section heading:
 
Always split longer articles into a number of sections. Each section is introduced by a section heading. This is how you format a section heading:
Line 22: Line 25:
 
  <nowiki>== Text of section heading ==</nowiki>
 
  <nowiki>== Text of section heading ==</nowiki>
  
The character sequence <tt>==</tt> is annotated before and after the text of the section heading. This corresponds to a Level 2 heading. Level 1 headings are reserved for the page heading.
+
The character sequence <tt>==</tt> is added before and after the text of the section heading. This corresponds to a Level 2 heading. Level 1 headings are reserved for the page heading.
  
 
To insert this type of section heading, you can also click the following symbol in the format bar above the edit field:
 
To insert this type of section heading, you can also click the following symbol in the format bar above the edit field:
Line 35: Line 38:
 
You should avoid further hierarchical structuring however.
 
You should avoid further hierarchical structuring however.
  
You do not need any special marking for text paragraphs. Separate the section headings and text sections as well as text paragraphs using a blank line. Textabsätze benötigen Sie keine spezielle Markierung. Trennen Sie Abschnittsüberschriften und Textabschnitte sowie Textabsätze untereinander jeweils durch eine Leerzeile. Beispiel:
+
You do not need any special marking for text paragraphs. Separate the section headings and text sections as well as text paragraphs using a blank line. Example:
  
  <nowiki>== Text Abschnittsüberschrift ===</nowiki>
+
  <nowiki>== Text of section heading ===</nowiki>
 
  &nbsp;
 
  &nbsp;
  Hier ein Textabsatz. Der Text wird automatisch umgebrochen.
+
  This is a text paragraph. The text is wrapped automatically.
 
  &nbsp;
 
  &nbsp;
  Hier ein weiterer Textabsatz.
+
  This is another text paragraph.
 
  &nbsp;
 
  &nbsp;
  <nowiki>== Noch eine Abschnittsüberschrift ===</nowiki>
+
  <nowiki>== This is another section heading ===</nowiki>
 
  &nbsp;
 
  &nbsp;
  Wieder ein Textabsatz
+
  And another text paragraph
  
Falls Sie innerhalb eines Textabsatz an einer bestimmten Stelle einen erzwungenen Zeilenumbruch einfügen wollen, müssen Sie HTML verwenden (genauer: XHTML). Geben Sie an der entsprechenden Stelle die Zeichenfolge <tt>&lt;br /&gt;</tt> ein.
+
If you want to insert a forced line break at a certain point within a text paragraph, you have to use HTML (more precisely: XHTML). Enter the character string <tt>&lt;br /&gt;</tt> at the appropriate point.
  
Um logisch nicht zusammengehörige Teile im Fließtext optisch besser zu trennen, können Sie Trennlinien einfügen. Notieren Sie dazu in einer eigenen Textzeile einfach vier Bindestriche hintereinander:
+
Separators can be inserted as a more visually efficient means of splitting parts in the running text that do not logically belong together. To do this, simply add four hyphens in succession in a separate text line:
  
 
  <nowiki>----</nowiki>
 
  <nowiki>----</nowiki>
  
Damit bewirken Sie in der Präsentationsansicht folgenden Effekt:
+
This creates the following effect in the presentation view:
  
 
----
 
----
  
Beachten Sie jedoch, dass Abschnittsüberschriften unterstrichen und damit zwischen Abschnitten automatisch eine optische Trennung entsteht.
+
Note, however, that section headings are underlined as a result and a visual split appears automatically between sections.
  
== Formatierungen im Text ==
+
== Formatting in the Text ==
  
Innerhalb eines Textes können Sie einzelne Wörter oder Passagen '''fett''', ''kursiv'' oder '''''fett und kursiv''''' markieren. Die entsprechenden Markierungen sehen wie folgt aus:
+
You can highlight individual words or passages within a text using '''bold''', ''italics'' or '''''bold and italics'''''. The relevant markings look as follows:
  
  Hier ein Text mit <nowiki>''kursivem''</nowiki> Text, <nowiki>'''fetten'''</nowiki> Text und <nowiki>'''''fetten und kursivem'''''</nowiki> Text
+
  This is an example of text with <nowiki>''italic''</nowiki> writing, <nowiki>'''bold'''</nowiki> writing and <nowiki>'''''bold and italic'''''</nowiki> writing.
  
Um diese Formatierungen einzufügen, können Sie auch in der Formatierleiste auf folgende Symbole klicken:
+
To insert this formatting, you can also click the following symbols in the format bar:
  
[[Image:Formatierleiste-bold.gif]] = Text als fett markieren
+
[[Image:Formatierleiste-bold.gif]] = Mark text as bold
  
[[Image:Formatierleiste-italic.gif]] = Text als kursiv markieren
+
[[Image:Formatierleiste-italic.gif]] = Mark text as italics
  
Um speziellere Formatierungen zu erreichen, müssen Sie mit HTML arbeiten. Hier nur einige sinnvolle Möglichkeiten:
+
For special formats, you will need to use HTML. These are a few possible options:
  
* Mit <tt>&lt;sup&gt;Text&lt;/sup&gt;</tt> markieren Sie Text als hochgestellt (z.B. 16<sup>3</sup>)
+
* Use <tt>&lt;sup&gt;Text&lt;/sup&gt;</tt> to mark text as superscript (e.g. 16<sup>3</sup>)
* Mit <tt>&lt;sub&gt;Text&lt;/sub&gt;</tt> markieren Sie Text als tiefgestellt (z.B. S<sub>0</sub>)
+
* Use <tt>&lt;sub&gt;Text&lt;/sub&gt;</tt> to mark text as subscript (e.g. S<sub>0</sub>)
* Mit <tt>&lt;u&gt;Text&lt;/u&gt;</tt> markieren Sie Text als unterstrichen (z.B. <u>unterstrichen</u>)
+
* Use <tt>&lt;u&gt;Text&lt;/u&gt;</tt> to mark text as underscored (e.g. <u>underscore</u>)
* Mit <tt>&lt;strike&gt;Text&lt;/strike&gt;</tt> markieren Sie Text als durchgestrichen (z.B. <strike>ungültig</strike>)
+
* Use <tt>&lt;strike&gt;Text&lt;/strike&gt;</tt> to mark text as struck-through (e.g. <strike>invalid</strike>)
* Mit <tt>&lt;big&gt;Text&lt;/big&gt;</tt> markieren Sie Text als vergrößert (z.B. <big>Lupe</big>)
+
* Use <tt>&lt;big&gt;Text&lt;/big&gt;</tt> to mark text as zoomed in (e.g. <big>magnifying glass</big>)
* Mit <tt>&lt;small&gt;Text&lt;/small&gt;</tt> markieren Sie Text als verkleinert (z.B. <small>Vogelperspektive</small>)
+
* Use <tt>&lt;small&gt;Text&lt;/small&gt;</tt> to mark text as zoomed out (e.g. <small>bird's eye view</small>)
* Mit <tt>&lt;tt&gt;Text&lt;/tt&gt;</tt> markieren Sie Text als dicktengleich (z.B. <tt>Code-Beispiel</tt>)
+
* Use <tt>&lt;tt&gt;Text&lt;/tt&gt;</tt> to mark text as non-proportional (e.g. <tt>code example</tt>)
  
== Aufzählungen und Listen ==
+
== Enumerations and Lists ==
  
Listen lockern Texte auf. Außerdem sorgen sie für Struktur. Es gibt Listen für die Aufzählung gleichberechtigter Punkte, und nummerierte Listen etwa für Step-by-Step-Beschreibungen.
+
Lists are used to break up text. In addition, they provide structure. Lists are used for itemizing points of equal importance while numbered lists are used for step-by-step descriptions.
  
Aufzählungslisten werden so notiert:
+
Enumeration lists are annotated as follows:
  
  <nowiki>* Listenpunkt</nowiki>
+
  <nowiki>* List item</nowiki>
  <nowiki>* Noch ein Listenpunkt</nowiki>
+
  <nowiki>* Another list item</nowiki>
  <nowiki>* Noch ein anderer Listenpunkt</nowiki>
+
  <nowiki>* Yet another list item</nowiki>
  
Jeder Listenpunkt beginnt in einer neuen Zeile. Das erste Zeichen ist ein Stern. Das obige Beispiel erzeugt folgenden Präsentationsinhalt:
+
Every list item starts in a new line. The first character is an asterisk. The example above produces the following presentation content:
  
* Listenpunkt
+
* List item
* Noch ein Listenpunkt
+
* Another list item
* Noch ein anderer Listenpunkt
+
* Yet another list item
  
Nummerierte Listen werden analog dazu notiert:
+
Numbered lists are annotated in a similar way:
  
  <nowiki># Erster Listenpunkt</nowiki>
+
  <nowiki># First list item</nowiki>
  <nowiki># Zweiter Listenpunkt</nowiki>
+
  <nowiki># Second list item</nowiki>
  <nowiki># Dritter Listenpunkt</nowiki>
+
  <nowiki># Third list item</nowiki>
  
Das Beispiel erzeugt folgenden Präsentationsinhalt:
+
The example produces the following presentation content:
  
# Erster Listenpunkt
+
# First list item
# Zweiter Listenpunkt
+
# Second list item
# Dritter Listenpunkt
+
# Third list item
  
Auch verschachtelte Listen sind möglich. Beispiel:
+
Nested lists are also possible. Example:
  
  <nowiki>* Listenpunkt</nowiki>
+
  <nowiki>* List item</nowiki>
  <nowiki>* Noch ein Listenpunkt</nowiki>
+
  <nowiki>* Another list item</nowiki>
  <nowiki>** Unterpunkt zu "Noch ein Listenpunkt"</nowiki>
+
  <nowiki>** Sub-item for "Another list item"</nowiki>
  <nowiki>** Noch ein Unterpunkt zu "Noch ein Listenpunkt"</nowiki>
+
  <nowiki>** Another sub-item for "Another list item"</nowiki>
  <nowiki>* Noch ein anderer Listenpunkt</nowiki>
+
  <nowiki>* Yet another list item</nowiki>
  
Mit nummerierten Listen funktioniert das genauso. Allerdings haben Unterlisten stets nur eine einfache Nummerierung. Nummerierungen wie 1.2 oder 1.2.1 sind nicht automatisierbar.
+
The same principle applies for numbered lists. Sub-lists always only have simple numbering however. Numbering such as 1.2 or 1.2.1 cannot be automated.
  
== Tabellen ==
+
== Tables ==
  
Tabellen sind für tabellarische Daten gedacht, nicht für mehrspaltige Inhalte oder separate Boxen. Aus diesem Grund werden Tabellen in diesem Wiki auch automatisch mit Gitternetzlinien versehen. Das nachfolgende Beispiel zeigt, wie eine Datentabelle mit Wiki-Syntax grundsätzlich erstellt wird:
+
Tables are intended for representing tabular data and not for multi-column contents or separate boxes. Tables in this Wiki are therefore provided automatically with reticule lines. The example below shows how a data table is essentially created with Wiki syntax:
  
 
  <nowiki>
 
  <nowiki>
 
  {|
 
  {|
  ! Kopfzelle 1. Spalte
+
  ! Header cell 1st. column
  ! Kopfzelle 2. Spalte
+
  ! Header cell 2nd. column
  ! Kopfzelle 3. Spalte
+
  ! Header cell 3rd. column
 
  |-
 
  |-
  | Datenzelle 1. Spalte
+
  | Data cell 1st. column
  | Datenzelle 2. Spalte
+
  | Data cell 2nd. column
  | Datenzelle 3. Spalte
+
  | Data cell 3rd. column
 
  |}</nowiki>
 
  |}</nowiki>
  
In der Präsentationsansicht sieht das wie folgt aus:
+
This then looks as follows in the presentation view:
  
 
{|
 
{|
! Kopfzelle 1. Spalte
+
! Header cell 1st. column
! Kopfzelle 2. Spalte
+
! Header cell 2nd. column
! Kopfzelle 3. Spalte
+
! Header cell 3rd. column
 
|-
 
|-
| Datenzelle 1. Spalte
+
| Data cell 1st. column
| Datenzelle 2. Spalte
+
| Data cell 2nd. column
| Datenzelle 3. Spalte
+
| Data cell 3rd. column
 
|}
 
|}
  
Die Definition einer Tabelle beginnt in einer neuen Textzeile mit der Zeichenfolge <tt><nowiki>{|</nowiki></tt>. Am Ende wird die Definition der Tabelle mit der Zeichenfolge <tt><nowiki>|}</nowiki></tt> abgeschlossen. Das <tt>|</tt> ist der Senkrechtstrich.
+
The definition of a table begins in a new text row with the character string <tt><nowiki>{|</nowiki></tt>. The definition of the table is terminated at the end with the character string <tt><nowiki>|}</nowiki></tt>. The <tt>|</tt> is the vertical bar.
  
Jede Tabellenzeile wird in einer neuen Textzeile durch die Zeichenfolge <tt><nowiki>|-</nowiki></tt> eingeleitet.  
+
Every table row is introduced in a new text row with the character string <tt><nowiki>|-</nowiki></tt>.  
  
Um eine Kopfzelle zu definieren, notieren Sie in einer neuen Textzeile zunächst ein Ausrufezeichen und dahinter den gewünschten Zelleninhalt.
+
To define a header cell, first enter an exclamation mark in a new text row followed by the desired cell content.
  
Um eine Datenzelle zu definieren, notieren Sie in einer neuen Textzeile zunächst einen Senkrechtstrich und dahinter den gewünschen Zelleninhalt.
+
To define a data cell, first enter a vertical bar in a new text row followed by the desired cell content.
  
Zelleninhalte können neben reinem Text auch Formatierungen, Links, Grafiken usw. enthalten.
+
Cell contents can contain formatting, links, graphics etc. in addition to pure text.
  
Achten Sie darauf, dass Sie in jeder Tabellenzeile für jede Spalte einen Inhalt notieren. Soll ein Zelleninhalt leer bleiben, notieren Sie das beginnende Zeichen (Ausrufezeichen oder Senkrechtstrich), und lassen Sie die Textzeile dahinter leer.  
+
Make sure that you enter content in every table row for every column. If the content of a cell is to remain blank, enter the starting character (exclamation mark or vertical bar) and leave the following text row blank.  
  
=== Zellen verbinden ===
+
=== Connecting Cells ===
  
Um Zellen zu verbinden, müssen Sie ein HTML-Attribut einfügen. Nachfolgend ein Beispiel:
+
You need to insert a HTML attribute to connect cells. An example of this is given below:
  
 
  <nowiki>
 
  <nowiki>
 
  {|
 
  {|
  ! Kopfzelle 1. Spalte
+
  ! Header cell 1st. column
  ! Kopfzelle 2. Spalte
+
  ! Header cell 2nd. column
  ! Kopfzelle 3. Spalte
+
  ! Header cell 3rd. column
 
  |-
 
  |-
  | colspan="2" | Datenzelle 1. Zeile 1. und 2. Spalte
+
  | colspan="2" | Data cell 1st. row 1st. and 2nd. column
  | Datenzelle 1. Zeile 3. Spalte
+
  | Data cell 1st. row 3rd. column
 
  |-
 
  |-
  | rowspan="2" | Datenzelle 2. und 3. Zeile 1. Spalte
+
  | rowspan="2" | Data cell 2nd. and 3rd. row 1st. column
  | Datenzelle 2. Zeile 2. Spalte
+
  | Data cell 2nd. row 2nd. column
  | Datenzelle 2. Zeile 3. Spalte
+
  | Data cell 2nd. row 3rd. column
 
  |-
 
  |-
  | Datenzelle 3. Zeile 2. Spalte
+
  | Data cell 3rd. row 2nd. column
  | Datenzelle 3. Zeile 3. Spalte
+
  | Data cell 3rd. row 3rd. column
 
  |}</nowiki>
 
  |}</nowiki>
  
In der Präsentationsansicht sieht das so aus:
+
This looks as follows in the presentation view:
  
 
{|
 
{|
! Kopfzelle 1. Spalte
+
! Header cell 1st. column
! Kopfzelle 2. Spalte
+
! Header cell 2nd. column
! Kopfzelle 3. Spalte
+
! Header cell 3rd. column
 
|-
 
|-
| colspan="2" | Datenzelle 1. Zeile 1. und 2. Spalte
+
| colspan="2" | Data cell 1st. row 1st. and 2nd. column
| Datenzelle 1. Zeile 3. Spalte
+
| Data cell 1st. row 3rd. column
 
|-
 
|-
| rowspan="2" | Datenzelle 2. und 3. Zeile 1. Spalte
+
| rowspan="2" | Data cell 2nd. and 3rd. row 1st. column
| Datenzelle 2. Zeile 2. Spalte
+
| Data cell 2nd. row 2nd. column
| Datenzelle 2. Zeile 3. Spalte
+
| Data cell 2nd. row 3rd. column
 
|-
 
|-
| Datenzelle 3. Zeile 2. Spalte
+
| Data cell 3rd. row 2nd. column
| Datenzelle 3. Zeile 3. Spalte
+
| Data cell 3rd. row 3rd. column
 
|}
 
|}
  
Mit <tt>colspan="2"</tt> können Sie eine Zelle innerhalb einer Tabellenzeile über zwei Spalten erstrecken. Natürlich können Sie auch einen höheren Wert als 2 angeben, wenn sich die Zelle über noch mehr Spalten erstrecken soll. Beachten Sie dabei, dass entsprechend weniger übrige Zellen in der entsprechenden Zeile definiert werden dürfen.
+
You can use <tt>colspan="2"</tt> to extend a cell within a table row across two columns. You can of course also select a higher value than 2 if the cell is to span more columns. Note that correspondingly fewer remaining cells may be defined in the relevant row.
  
Mit <tt>rowspan="2"</tt> können Sie eine Zelle über Tabellenzeilen hinweg in der gleichen Spalte erstrecken. Natürlich können Sie auch einen höheren Wert als 2 angeben, wenn sich die Zelle über noch mehr Zeilen erstrecken soll. Beachten Sie dabei, dass in den nachfolgenden Tabellenzeilen entsprechend weniger Zellen definiert werden dürfen.
+
You can use <tt>rowspan="2"</tt> to extend a cell across a number of table rows in the same column. You can of course also select a higher value than 2 if the cell is to span more rows. Note that correspondingly fewer cells may be defined in the next table rows.
  
Auch die Kombination von <tt>colspan</tt> und <tt>rowspan</tt> in einer Zelle ist erlaubt.
+
The combination of <tt>colspan</tt> and <tt>rowspan</tt> in a cell is also permitted.
  
Zellen mit Angaben zu <tt>colspan</tt> und/oder <tt>rowspan</tt> beginnen wie normale Zellen mit Senkrechtstrich (Datenzellen) oder Ausrufezeichen (Kopfzellen). Dahinter folgt die Notation des HTML-Attributs. Es folgt ein Senkrechtstrich, und dahinter der Zelleninhalt.
+
Cells with entries for <tt>colspan</tt> and/or <tt>rowspan</tt> start like normal cells with a vertical bar (data cell) or an exclamation mark (header cell). The notation for the HTML attribute then follows this and after that a vertical bar and after that again the cell content.
  
=== Rahmenlose Tabellen ===
+
=== Borderless Tables ===
  
Um Rahmen um Tabellen und Tabellenzellen zu verhindern, müssen Sie in diesem Wiki sowohl bei der Tabelle als auch bei den Tabellenzellen <tt>class="noborder"</tt> notieren. Beispiel:
+
To suppress borders around tables and table cells, you have to insert <tt>class="noborder"</tt> in this Wiki both in the table and in the table cells. Example:
  
 
  <nowiki>
 
  <nowiki>
 
  {| class="noborder"  
 
  {| class="noborder"  
  ! class="noborder" | Kopfzelle 1. Spalte
+
  ! class="noborder" | Header cell 1st. column
  ! class="noborder" | Kopfzelle 2. Spalte
+
  ! class="noborder" | Header cell 2nd. column
  ! class="noborder" | Kopfzelle 3. Spalte
+
  ! class="noborder" | Header cell 3rd. column
 
  |-
 
  |-
  | class="noborder" | Datenzelle 1. Spalte
+
  | class="noborder" | Data cell 1st. column
  | class="noborder" | Datenzelle 2. Spalte
+
  | class="noborder" | Data cell 2nd. column
  | class="noborder" | Datenzelle 3. Spalte
+
  | class="noborder" | Data cell 3rd. column
 
  |}</nowiki>
 
  |}</nowiki>
  
Das erzeugt folgende Ausgabe in der Präsentationsansicht:
+
This produces the following output in the presentation view:
  
 
{| class="noborder"  
 
{| class="noborder"  
! class="noborder" | Kopfzelle 1. Spalte
+
! class="noborder" | Header cell 1st. column
! class="noborder" | Kopfzelle 2. Spalte
+
! class="noborder" | Header cell 2nd. column
! class="noborder" | Kopfzelle 3. Spalte
+
! class="noborder" | Header cell 3rd. column
 
|-
 
|-
| class="noborder" | Datenzelle 1. Spalte
+
| class="noborder" | Data cell 1st. column
| class="noborder" | Datenzelle 2. Spalte
+
| class="noborder" | Data cell 2nd. column
| class="noborder" | Datenzelle 3. Spalte
+
| class="noborder" | Data cell 3rd. column
 
|}
 
|}
  
== Weitere Formatierungsmöglichkeiten ==
+
== Footnotes ==
 +
 
 +
Refer to {{wp|en|Wikipedia:Footnotes|Footnotes}} in the Wikipedia Help.
 +
 
 +
Example in this Wiki: [[optiPoint WL2 professional interoperability matrix]].
 +
 
 +
== Other Formatting Options ==
  
Lesen Sie innerhalb der Hilfe zu diesem Wiki auch folgende Seiten:
+
Please refer also to the following pages within the Help for this Wiki:
  
 
* [[How do I link to other contents or URLs?]]
 
* [[How do I link to other contents or URLs?]]
 
* [[How do I add images and multimedia?]]
 
* [[How do I add images and multimedia?]]
  
Ausführliche und systematische Beschreibungen finden Sie außerdem in folgender externen Quelle:
+
Detailed and systematic descriptions can also be found in the following external source:
  
 
* {{en}} [http://meta.wikimedia.org/wiki/Help:Help Official MediaWiki Handbook]
 
* {{en}} [http://meta.wikimedia.org/wiki/Help:Help Official MediaWiki Handbook]
  
== Strukturierte Formatierung, Vorlagen und Standards ==
+
== Structured Formatting, Templates and Standards ==
  
Je häufiger ein Artikel mit ähnlichem Inhalt erstellt wird, desto mehr Sinn macht die Verwendung von Vorlagen und Standards, um den Artikeln ein einheitliches Aussehen zu verleihen. Deshalb stellen wir in unserem Wiki einige Vorlagen bereit, um Ihnen das Erstellen solcher Artikel zu erleichtern.  
+
The more frequently an article with similar content is produced, the more sense it makes to use templates and standards to give the articles a uniform look and feel. We therefore provide a number of templates in our Wiki to make it easier for you to create such articles.  
  
Zur Zeit vorhandene Vorlagen im Namensraum '''Template''' (Auswahl):
+
The following templates are currently available in the '''Template''' namespace (selection):
  
* [[Template:TOC]]: Kurz-Inhaltsverzeichnis
+
* [[Template:TOC]]: Short table of contents
* [[Template:File-DL]]: Filedownload-Link
+
* [[Template:File-DL]]: File download link
* [[Template:DefaultTable]]: Formatierung einer Standard-Tabelle
+
* [[Template:wp]]: Link to Wikipedia (EN or DE)
* [[Template:FeatureBox Phone]]: Vorlage für eine Standard-Featureliste
+
* [[Template:Info]]: Labeling a paragraph as important
* [[Template:ProcedureTable]]: Vorlage für eine Prozedur-Tabelle
+
* [[Template:Warning]]: Labeling a paragraph as very important
* [[Template:fixme]]: Kennzeichen zur Erledigung
+
* [[Template:DefaultTable]]: Formatting of a default table
* [[Template:stillde]]: Kennzeichen zur Übersetzung DE > EN
+
* [[Template:FeatureBox Phone]]: Template for a default list of features
* [[Template:stillen]]: Kennzeichen zur Übersetzung EN > DE
+
* [[Template:ProcedureTable]]: Template for a procedure table
* [[Template:constr]]: Hinweis für "in Bearbeitung"
+
* [[Template:OpenStage Open Source Software]]: Article structure on OpenStage open source software pages
* [[Template:dontchange]]: Hinweis für "bitte nicht ändern"
+
* [[Template:fixme]]: Means completed
 +
* [[Template:QA]]: Quality assurance required
 +
* [[Template:QAnote]]: Notice of required quality assurance
 +
* [[Template:stillde]]: Means DE > EN translation
 +
* [[Template:stillen]]: Means EN > DE translation
 +
* [[Template:constr]]: Means "in process"
 +
* [[Template:dontchange]]: Means "please do not change"
 +
* [[Wiki:SeeAlso Templates|''SeeAlso'' Templates]]
  
Zur Zeit vorhandene Layoutvorschläge im Namensraum '''Wiki''' (Auswahl):
+
The following proposed layouts are currently available in the '''Wiki''' namespace (selection):
  
 
* [[Wiki:Template Phone]]
 
* [[Wiki:Template Phone]]
  
Um eine Vorlage in den Artikeltext einzufügen, notieren Sie <tt><nowiki>{{Vorlagenname}}</nowiki></tt>.  
+
To insert a template in the article text, use the notation <tt><nowiki>{{template name}}</nowiki></tt>.  
  
Manche Vorlagen erfordern auch Parameter. Weitere Informationen dazu erhalten Sie jeweils auf den Vorlagenseiten.
+
Some templates also require parameters. You will find additional information in this regard on the template pages.

Latest revision as of 07:34, 28 April 2011

Wiki Syntax and HTML

You can only enter simple text in the edit field of an article. In order to convert this text to properly formatted content when presenting the article, you have to insert structuring and formatting instructions in the text. The text field supports the use of two languages here:

  • Wiki's own syntax. This is especially simple and allows even inexperienced authors to create properly structured and formatted text quickly.
  • Parts of HTML including CSS. However, you should only use HTML/CSS if the desired objective cannot be achieved using Wiki's own syntax.

If you actually need HTML/CSS in an article, you will need knowledge of these languages. We will look primarily at the fundamentals of the Wiki syntax here.

You can use the sandbox to familiarize yourself with the formatting options described below.

Breadcrumb

If possible the page should have a breadcrumb link path.

Information about syntax and examples are available on the template page: Template:Breadcrumb.

Headings and Paragraphs

Always split longer articles into a number of sections. Each section is introduced by a section heading. This is how you format a section heading:

== Text of section heading ==

The character sequence == is added before and after the text of the section heading. This corresponds to a Level 2 heading. Level 1 headings are reserved for the page heading.

To insert this type of section heading, you can also click the following symbol in the format bar above the edit field:

Formatierleiste-abschnitt.gif

Depending on the size and complexity, an article may also require subsections or even sub-subsections. These sections are also introduced by a heading and are formatted as follows:

=== Text of subsection heading ===
==== Text of sub-subsection heading ====

You should avoid further hierarchical structuring however.

You do not need any special marking for text paragraphs. Separate the section headings and text sections as well as text paragraphs using a blank line. Example:

== Text of section heading ===
 
This is a text paragraph. The text is wrapped automatically.
 
This is another text paragraph.
 
== This is another section heading ===
 
And another text paragraph

If you want to insert a forced line break at a certain point within a text paragraph, you have to use HTML (more precisely: XHTML). Enter the character string <br /> at the appropriate point.

Separators can be inserted as a more visually efficient means of splitting parts in the running text that do not logically belong together. To do this, simply add four hyphens in succession in a separate text line:

----

This creates the following effect in the presentation view:


Note, however, that section headings are underlined as a result and a visual split appears automatically between sections.

Formatting in the Text

You can highlight individual words or passages within a text using bold, italics or bold and italics. The relevant markings look as follows:

This is an example of text with ''italic'' writing, '''bold''' writing and '''''bold and italic''''' writing.

To insert this formatting, you can also click the following symbols in the format bar:

Formatierleiste-bold.gif = Mark text as bold

Formatierleiste-italic.gif = Mark text as italics

For special formats, you will need to use HTML. These are a few possible options:

  • Use <sup>Text</sup> to mark text as superscript (e.g. 163)
  • Use <sub>Text</sub> to mark text as subscript (e.g. S0)
  • Use <u>Text</u> to mark text as underscored (e.g. underscore)
  • Use <strike>Text</strike> to mark text as struck-through (e.g. invalid)
  • Use <big>Text</big> to mark text as zoomed in (e.g. magnifying glass)
  • Use <small>Text</small> to mark text as zoomed out (e.g. bird's eye view)
  • Use <tt>Text</tt> to mark text as non-proportional (e.g. code example)

Enumerations and Lists

Lists are used to break up text. In addition, they provide structure. Lists are used for itemizing points of equal importance while numbered lists are used for step-by-step descriptions.

Enumeration lists are annotated as follows:

* List item
* Another list item
* Yet another list item

Every list item starts in a new line. The first character is an asterisk. The example above produces the following presentation content:

  • List item
  • Another list item
  • Yet another list item

Numbered lists are annotated in a similar way:

# First list item
# Second list item
# Third list item

The example produces the following presentation content:

  1. First list item
  2. Second list item
  3. Third list item

Nested lists are also possible. Example:

* List item
* Another list item
** Sub-item for "Another list item"
** Another sub-item for "Another list item"
* Yet another list item

The same principle applies for numbered lists. Sub-lists always only have simple numbering however. Numbering such as 1.2 or 1.2.1 cannot be automated.

Tables

Tables are intended for representing tabular data and not for multi-column contents or separate boxes. Tables in this Wiki are therefore provided automatically with reticule lines. The example below shows how a data table is essentially created with Wiki syntax:

 {|
 ! Header cell 1st. column
 ! Header cell 2nd. column
 ! Header cell 3rd. column
 |-
 | Data cell 1st. column
 | Data cell 2nd. column
 | Data cell 3rd. column
 |}

This then looks as follows in the presentation view:

Header cell 1st. column Header cell 2nd. column Header cell 3rd. column
Data cell 1st. column Data cell 2nd. column Data cell 3rd. column

The definition of a table begins in a new text row with the character string {|. The definition of the table is terminated at the end with the character string |}. The | is the vertical bar.

Every table row is introduced in a new text row with the character string |-.

To define a header cell, first enter an exclamation mark in a new text row followed by the desired cell content.

To define a data cell, first enter a vertical bar in a new text row followed by the desired cell content.

Cell contents can contain formatting, links, graphics etc. in addition to pure text.

Make sure that you enter content in every table row for every column. If the content of a cell is to remain blank, enter the starting character (exclamation mark or vertical bar) and leave the following text row blank.

Connecting Cells

You need to insert a HTML attribute to connect cells. An example of this is given below:

 {|
 ! Header cell 1st. column
 ! Header cell 2nd. column
 ! Header cell 3rd. column
 |-
 | colspan="2" | Data cell 1st. row 1st. and 2nd. column
 | Data cell 1st. row 3rd. column
 |-
 | rowspan="2" | Data cell 2nd. and 3rd. row 1st. column
 | Data cell 2nd. row 2nd. column
 | Data cell 2nd. row 3rd. column
 |-
 | Data cell 3rd. row 2nd. column
 | Data cell 3rd. row 3rd. column
 |}

This looks as follows in the presentation view:

Header cell 1st. column Header cell 2nd. column Header cell 3rd. column
Data cell 1st. row 1st. and 2nd. column Data cell 1st. row 3rd. column
Data cell 2nd. and 3rd. row 1st. column Data cell 2nd. row 2nd. column Data cell 2nd. row 3rd. column
Data cell 3rd. row 2nd. column Data cell 3rd. row 3rd. column

You can use colspan="2" to extend a cell within a table row across two columns. You can of course also select a higher value than 2 if the cell is to span more columns. Note that correspondingly fewer remaining cells may be defined in the relevant row.

You can use rowspan="2" to extend a cell across a number of table rows in the same column. You can of course also select a higher value than 2 if the cell is to span more rows. Note that correspondingly fewer cells may be defined in the next table rows.

The combination of colspan and rowspan in a cell is also permitted.

Cells with entries for colspan and/or rowspan start like normal cells with a vertical bar (data cell) or an exclamation mark (header cell). The notation for the HTML attribute then follows this and after that a vertical bar and after that again the cell content.

Borderless Tables

To suppress borders around tables and table cells, you have to insert class="noborder" in this Wiki both in the table and in the table cells. Example:

 {| class="noborder" 
 ! class="noborder" | Header cell 1st. column
 ! class="noborder" | Header cell 2nd. column
 ! class="noborder" | Header cell 3rd. column
 |-
 | class="noborder" | Data cell 1st. column
 | class="noborder" | Data cell 2nd. column
 | class="noborder" | Data cell 3rd. column
 |}

This produces the following output in the presentation view:

Header cell 1st. column Header cell 2nd. column Header cell 3rd. column
Data cell 1st. column Data cell 2nd. column Data cell 3rd. column

Footnotes

Refer to Wikipedia (en) Footnotes in the Wikipedia Help.

Example in this Wiki: optiPoint WL2 professional interoperability matrix.

Other Formatting Options

Please refer also to the following pages within the Help for this Wiki:

Detailed and systematic descriptions can also be found in the following external source:

Structured Formatting, Templates and Standards

The more frequently an article with similar content is produced, the more sense it makes to use templates and standards to give the articles a uniform look and feel. We therefore provide a number of templates in our Wiki to make it easier for you to create such articles.

The following templates are currently available in the Template namespace (selection):

The following proposed layouts are currently available in the Wiki namespace (selection):

To insert a template in the article text, use the notation {{template name}}.

Some templates also require parameters. You will find additional information in this regard on the template pages.