mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2025-04-27 15:43:58 +00:00
[rst/de] light extension of export formats docutils offers (#4654)
This commit is contained in:
parent
21c588354c
commit
89857f5e24
@ -10,30 +10,27 @@ lang: de-de
|
|||||||
---
|
---
|
||||||
|
|
||||||
RST ist ein Dateiformat, das von der Python Community entwickelt wurde,
|
RST ist ein Dateiformat, das von der Python Community entwickelt wurde,
|
||||||
|
|
||||||
um Dokumentation zu schreiben (und ist somit Teil von Docutils).
|
um Dokumentation zu schreiben (und ist somit Teil von Docutils).
|
||||||
|
RST-Dateien sind simple Textdateien mit einer leichtgewichtigen Syntax (im
|
||||||
RST-Dateien sind simple Textdateien mit einer leichtgewichtigen Syntax (im Vergleich zu HTML).
|
Vergleich zu HTML).
|
||||||
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Um Restructured Text zu verwenden, musst du [Python](http://www.python.org)
|
Um Restructured Text zu verwenden, musst du [Python](http://www.python.org)
|
||||||
|
installieren und das `docutils` Paket installieren. `docutils` kann mit dem
|
||||||
installieren und das `docutils` Paket installieren. `docutils` kann mit dem folgenden
|
folgenden Befehl auf der Kommandozeile installiert werden:
|
||||||
|
|
||||||
Befehl auf der Kommandozeile installiert werden:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ easy_install docutils
|
easy_install docutils
|
||||||
```
|
```
|
||||||
|
|
||||||
Wenn auf deinem System `pip` installiert kannst du es stattdessen auch verwenden:
|
Ebenso kann die Installation mit `pip`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ pip install docutils
|
pip install docutils
|
||||||
```
|
```
|
||||||
|
|
||||||
|
initiiert werden.
|
||||||
|
|
||||||
## Dateisyntax
|
## Dateisyntax
|
||||||
|
|
||||||
@ -82,7 +79,8 @@ Japan Tokyo
|
|||||||
=========== ========
|
=========== ========
|
||||||
|
|
||||||
Komplexere Tabellen (zusammengeführte Spalten und Zeilen) können einfach
|
Komplexere Tabellen (zusammengeführte Spalten und Zeilen) können einfach
|
||||||
erstellt werden, aber ich empfehle dir dafür die komplette Dokumentation zu lesen :)
|
erstellt werden, aber ich empfehle dir dafür die komplette Dokumentation zu
|
||||||
|
lesen :)
|
||||||
|
|
||||||
Es gibt mehrere Möglichkeiten um Links zu machen:
|
Es gibt mehrere Möglichkeiten um Links zu machen:
|
||||||
|
|
||||||
@ -96,16 +94,20 @@ muss man die Zielurl nach dem Text hinzufügen.
|
|||||||
.. _GitHub https://github.com/
|
.. _GitHub https://github.com/
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Wie man es verwendet
|
## Wie man es verwendet
|
||||||
|
|
||||||
RST kommt mit docutils, dort hast du den Befehl `rst2html`, zum Beispiel:
|
Mit der Installation von [docutils](https://docutils.sourceforge.io/) bietet
|
||||||
|
sich beispielsweise die Umwandlung zu html (mehrere Standards stehen zur
|
||||||
|
Auswahl) an:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ rst2html myfile.rst output.html
|
rst2html myfile.rst output.html
|
||||||
```
|
```
|
||||||
|
|
||||||
*Anmerkung : Auf manchen Systemen könnte es rst2html.py sein*
|
*Anmerkung: Auf manchen Systemen könnte es `rst2html.py` sein.*
|
||||||
|
|
||||||
|
Weitere Exporte bieten beispielsweise `rst2latex`, `rst2man`, `rst2odt`,
|
||||||
|
`rst2pdf` und `rst2xml`.
|
||||||
|
|
||||||
Es gibt komplexere Anwendungen, die das RST Format verwenden:
|
Es gibt komplexere Anwendungen, die das RST Format verwenden:
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user