„ReStructuredText“ – Versionsunterschied

reStructuredText
Dateiendung:	.rst
MIME-Type:	text/x-rst
Entwickelt von:	David Goodger
Erstveröffentlichung:	2. April 2002
Art:	Vereinfachte Auszeichnungssprache
	https://docutils.sourceforge.io/rst.html
	;

Versionsgeschichte interaktiv durchsuchen

[gesichtete Version]

← Zum vorherigen Versionsunterschied

Inhalt gelöscht Inhalt hinzugefügt

VisuellWikitext

Inline

Aktuelle Version vom 18. April 2025, 14:15 Uhr

reStructuredText (kurz ReST, reST oder RST) ist eine vereinfachte Auszeichnungssprache (englisch markup language) mit dem Ziel, in der reinen Textform besonders lesbar zu sein. Weiterhin soll reStructuredText leicht in andere Formate umwandelbar sein.

Hintergrund

Der reStructuredText-Parser ist eine Komponente der Docutils, einer in der Programmiersprache Python entwickelten Textverarbeitungsbibliothek. Version 0.6 unterstützt die Umwandlung in ODT, Manpage, S5, XHTML, XML sowie LaTeX. Letzteres ermöglicht einen professionellen Schriftsatz mit Exportmöglichkeiten nach PostScript und PDF.

reStructuredText findet verbreitet Einsatz in der Formatierung der docstrings, der Python-typischen Kommentare zur Programmdokumentation. Das Software-Dokumentationswerkzeug Sphinx nutzt reStructuredText. Zudem bieten einige Wiki-Systeme neben ihrer eigenen Wiki-Syntax reStructuredText als Alternative an.

GitHub, Bitbucket und GitLab unterstützen reST.

Vergleichbare leichte Auszeichnungssprachen sind z. B. Markdown, Textile und AsciiDoc.

Syntaxbeispiele

Überschriften:

Abschnitt
=========

Unterabschnitt
--------------

Aufzählungslisten:

- Erster Punkt

- Zweiter Punkt

  - Ein Unterpunkt

- Dritter Punkt

1) Ein Punkt einer nummerierten Liste

2) Zweitens...

   a) Unterpunkt einer nummerierten Liste

      i) Noch eine Ebene tiefer...

3) Dritter Punkt der nummerierten Liste

Benannte Hyperlinks:

Dieser Satz dient zur Demonstration_ von `Hyperlinks in reST`_.

.. _Demonstration: https://de.wikipedia.org/wiki/Demonstration
.. _Hyperlinks in reST: https://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets

Anonyme Hyperlinks:

Ein Satz mit einem `anonymen Link auf die Python-Website`__.

__ https://www.python.org/

Fußnoten:

Hier steht nicht viel [#]_. Schauen sie einfach mal ans Ende der Seite.

.. [#] Fußnoten können automatisch durchnummeriert werden. Mehr dazu in der reST-Kurzreferenz

Weblinks

@@ Zeile 1: / Zeile 1: @@
-{{DISPLAYTITLE:reStructuredText}}
+{{SEITENTITEL:reStructuredText}}
+{{Belege fehlen}}
-'''reStructuredText''' (kurz: ''ReST'', ''reST'' oder ''RST'') ist eine [[vereinfachte Auszeichnungssprache]] (Markup) mit dem Ziel, in der reinen Textform besonders lesbar zu sein. Weiterhin soll reStructuredText leicht in andere Formate umwandelbar sein.
+{{Infobox Dateiformat
+| Name = reStructuredText
+| Icon =
+| Logo = [[Datei:ReStructuredText Logo.svg|rahmenlos|reStructuredText logo]]
+| Screenshot =
+| Beschreibung =
+| Dateiendung = .rst
+| MIME = text/x-rst
+| MIME-Anm =
+| MagischeZahl =
+| MagischeZahlNotation =
+| MagischeZahlHex =
+| Entwickler = David Goodger
+| Veröffentlicht = 2002-04-02
+| LetzteVersion =
+| LetzteVersionDatum =
+| Art = [[Auszeichnungssprache#Vereinfachte Auszeichnungssprachen|Vereinfachte Auszeichnungssprache]]
+| Container für =
+| Enthalten in =
+| Erweitert von =
+| Erweitert zu =
+| Standard =
+| Website = https://docutils.sourceforge.io/rst.html
+}}
+'''reStructuredText''' (kurz ''ReST'', ''reST'' oder ''RST'') ist eine [[vereinfachte Auszeichnungssprache]] ({{enS|markup language}}) mit dem Ziel, in der reinen Textform besonders lesbar zu sein. Weiterhin soll reStructuredText leicht in andere Formate umwandelbar sein.
+== Hintergrund ==
-Der reStructuredText-[[Parser]] ist eine Komponente der Docutils, einer in der [[Programmiersprache]] [[Python (Programmiersprache)|Python]] entwickelten Textverarbeitungsbibliothek. In Version 0.6 unterstützt die Umwandlung in [[OpenDocument|ODT]], [[Manpage]], [[S5 (Dateiformat)|S5]], [[XHTML]], [[Extensible Markup Language|XML]] sowie [[LaTeX]]. Letzteres ermöglicht einen professionellen Schriftsatz mit Exportmöglichkeiten nach [[PostScript]] und [[PDF]]. Die aktuelle Version von Docutils ist 0.8.1 (vom 8. Juli 2011).
+Der reStructuredText-[[Parser]] ist eine Komponente der Docutils, einer in der [[Programmiersprache]] [[Python (Programmiersprache)|Python]] entwickelten Textverarbeitungsbibliothek. Version 0.6 unterstützt die Umwandlung in [[OpenDocument|ODT]], [[Manpage]], [[S5 (Dateiformat)|S5]], [[XHTML]], [[Extensible Markup Language|XML]] sowie [[LaTeX]]. Letzteres ermöglicht einen professionellen Schriftsatz mit Exportmöglichkeiten nach [[PostScript]] und [[PDF]].
-reStructuredText findet verbreitet Einsatz in der Formatierung der docstrings, der Python-typischen Kommentare zur Programmdokumentation. Zudem bieten einige [[Wiki|Wiki-Systeme]] neben ihrer eigenen [[Wiki-Syntax]] reStructuredText als Alternative an.
+reStructuredText findet verbreitet Einsatz in der Formatierung der docstrings, der Python-typischen Kommentare zur Programmdokumentation. Das [[Software-Dokumentationswerkzeug]] [[Sphinx (Software)|Sphinx]] nutzt reStructuredText. Zudem bieten einige [[Wiki|Wiki-Systeme]] neben ihrer eigenen [[Wiki-Syntax]] reStructuredText als Alternative an.
+[[GitHub]], [[Bitbucket]] und [[GitLab]] unterstützen reST.
-Vergleichbare leichte Auszeichnungssprachen sind z.B. [[Markdown]], [[Textile]] und [[AsciiDoc]].
+Vergleichbare leichte Auszeichnungssprachen sind z.&nbsp;B. [[Markdown]], [[Textile]] und [[AsciiDoc]].
-== Syntaxbeispiele ==
+== Syntaxbeispiele ==
 Überschriften:
  Abschnitt
- =========
+ <nowiki>=========</nowiki>
  Unterabschnitt
  --------------
@@ Zeile 21: / Zeile 48: @@
  - Erster Punkt
  - Zweiter Punkt
    - Ein Unterpunkt
  - Dritter Punkt
 ) Ein Punkt einer nummerierten Liste
-) Zweites...
+) Zweitens...
     a) Unterpunkt einer nummerierten Liste
        i) Noch eine Ebene tiefer...
 ) Dritter Punkt der nummerierten Liste
@@ Zeile 42: / Zeile 69: @@
  Dieser Satz dient zur Demonstration_ von `Hyperlinks in reST`_.
- .. _Demonstration: http://de.wikipedia.org/wiki/Demonstration
+ .. _Demonstration: https://de.wikipedia.org/wiki/Demonstration
- .. _Hyperlinks in reST: http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets
+ .. _Hyperlinks in reST: https://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets
 Anonyme Hyperlinks:
- Ein Satz mit einem `anonymen Link auf die Python Website`__.
+ Ein Satz mit einem `anonymen Link auf die Python-Website`__.
- __ http://www.python.org/
+ __ https://www.python.org/
-Fußnoten:
+[[Fußnote]]n:
- Hier steht nicht viel [#]_.  Schauen sie einfach mal ans Ende der Seite.
+ Hier steht nicht viel [#]_. Schauen sie einfach mal ans Ende der Seite.
- .. [#] Fußnoten können automatisch durchnummeriert werden. Mehr dazu in der [http://docutils.sourceforge.net/docs/user/rst/quickref.html reST Kurzreferenz]
+ .. [#] Fußnoten können automatisch durchnummeriert werden. Mehr dazu in der [https://docutils.sourceforge.net/docs/user/rst/quickref.html reST-Kurzreferenz]
 == Weblinks ==
-* [http://docutils.sourceforge.net/ Docutils]
+* [https://docutils.sourceforge.net/ Docutils]
-* [http://docutils.sourceforge.net/rst.html reStructuredText]
+* [https://docutils.sourceforge.net/rst.html reStructuredText]
-* [http://docutils.sourceforge.net/docs/user/rst/quickref.html ReST-Kurzreferenz]
+* [https://docutils.sourceforge.net/docs/user/rst/quickref.html ReST-Kurzreferenz]
 [[Kategorie:Vereinfachte Auszeichnungssprache]]
-[[en:ReStructuredText]]
-[[es:ReStructuredText]]
-[[fr:ReStructuredText]]
-[[it:ReStructuredText]]
-[[ja:ReStructuredText]]
-[[pt:ReStructuredText]]
-[[ru:ReStructuredText]]