learnxinyminutes-docs/de-de/rst-de.html.markdown
2018-11-17 23:55:42 +05:30

3.2 KiB

language filename contributors translators lang
restructured text (RST) restructuredtext-de.rst
DamienVGN
https://github.com/martin-damien
Andre Polykanine
https://github.com/Oire
Dennis Keller
https://github.com/denniskeller
de-de

RST ist ein Dateiformat, das von der Python Community entwickelt wurde,

um Dokumentation zu schreiben (und ist somit Teil von Docutils).

RST-Dateien sind simple Textdateien mit einer leichtgewichtigen Syntax (im Vergleich zu HTML).

Installation

Um Restructured Text zu vewenden musst du Python

installieren und das docutils Packet installieren. docutils kann mit dem folgenden

Befehl auf der Kommandozeile installiert werden:

$ easy_install docutils

Wenn auf deinem System pip installiert kannst du es statdessen auch verwenden:

$ pip install docutils

Dateisyntax

Ein einfaches Beispiel für die Dateisyntax:

.. Zeilen, die mit zwei Punkten starten sind spezielle Befehle. 

.. Wenn kein Befehl gefunden wird, wird die Zeile als Kommentar gewertet. 

============================================================================
Haupttitel werden mit Gleichheitszeichen darüber und darunter gekennzeichnet
============================================================================

Beachte das es genau so viele Gleichheitszeichen, wie Hauptitelzeichen
geben muss.

Titel werden auch mit Gleichheitszeichen unterstrichen
======================================================

Untertitel werden mit Strichen gekennzeichnet
---------------------------------------------

Text in *kursiv* oder in **fett**. Du kannst Text als Code "makieren", wenn
du doppelte Backquotes verwendest ``: ``print()``.

Listen sind so einfach wie in Markdown:

- Erstes Element
- Zweites Element
    - Unterelement

oder

* Erstes Element
* Zweites Element
    * Unterelement

Tabellen sind einfach zu schreiben:

=========== ==========
Land        Hauptstadt 
=========== ==========
Frankreich  Paris
Japan       Tokyo
=========== ========

Komplexere Tabellen (zusammengeführte Spalten und Zeilen) können einfach 
erstellt werden, aber ich empfehle dir dafür die komplette Dokumentation zu lesen :)

Es gibt mehrere Möglichkeiten um Links zu machen:

- Wenn man einen Unterstrich hinter einem Wort hinzufügt: Github_ Zusätzlich 
muss man die Zielurl nach dem Text hinzufügen. 
(Dies hat den Vorteil, dass man keine unnötigen Urls in lesbaren Text einfügt.
- Wenn man die vollständige Url eingibt : https://github.com/
(Dies wird automatisch in ein Link konvertiert.)
- Wenn man es mehr Markdown ähnlich eingibt: `Github <https://github.com/>`_ .

.. _Github https://github.com/

Wie man es verwendet

RST kommt mit docutils, dort hast du den Befehl rst2html, zum Beispiel:

$ rst2html myfile.rst output.html

Anmerkung : Auf manchen Systemen könnte es rst2html.py sein

Es gibt komplexere Anwendungen, die das RST Format verwenden:

  • Pelican, ein statischer Websitengenerator
  • Sphinx, Ein Dokumentationsgenerator
  • und viele Andere

Zum Lesen