Skip to content

Commit

Permalink
[rst/*] highlight
Browse files Browse the repository at this point in the history
  • Loading branch information
verhovsky committed Oct 25, 2024
1 parent 39727a7 commit 8e94abc
Show file tree
Hide file tree
Showing 5 changed files with 7 additions and 17 deletions.
2 changes: 1 addition & 1 deletion de-de/rst-de.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ initiiert werden.

Ein einfaches Beispiel für die Dateisyntax:

```
```rst
.. Zeilen, die mit zwei Punkten starten sind spezielle Befehle.
.. Wenn kein Befehl gefunden wird, wird die Zeile als Kommentar gewertet.
Expand Down
10 changes: 3 additions & 7 deletions es-es/rst-es.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ filename: restructuredtext-es.rst
lang: es-es
---


RST, de Restructured Text, es un formato de fichero creado por la comunidad Python para escribir documentación. Es parte del paquete [Docutils](https://docutils.sourceforge.io/rst.html).

RST es un lenguaje de marcas similar a HTML pero mucho más ligero y fácil de leer.
Expand All @@ -30,12 +29,11 @@ Si tu sistema tiene `pip`, también puedes utilizarlo para instalar `docutils`.
$ pip install docutils
```


## Sintaxis.

Un ejemplo simple de sintaxis:

```
```rst
.. Las líneas que empiezan por un punto seguido de otro punto son comandos especiales. Si no se encuentra ningún comando, se considerará que esa línea es un comentario.
========================================================================
Expand Down Expand Up @@ -65,14 +63,14 @@ Recuerda alinear los símbolos de lista (como - o \*) al margen izquierdo del an
- Segundo elemento
- Subelemento
- Tercer elemento
o
* Primer elemento
* Segundo elemento
* Subelemento
* Tercer elemento
Expand All @@ -97,7 +95,6 @@ Hay varias formas de construir enlaces:
.. _GitHub: https://github.com/
```


## Como utilizarlo

RST viene con el paquete `docutils` dentro del cual está el comando `rst2html`, por ejemplo:
Expand All @@ -114,7 +111,6 @@ Hay aplicaciones más complejas que usan el formato RST:
- [Sphinx](http://sphinx-doc.org/), un generador de documentación.
- y muchos otros.


## Otras lecturas

- [Referencia rápida oficial](http://docutils.sourceforge.net/docs/user/rst/quickref.html)
6 changes: 1 addition & 5 deletions id-id/rst-id.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,6 @@ dokumentasi (dan menjadi bagian dari Docutils).
File-file RST adalah sebuah file-file teks simpel dengan sintaks yang ringan
(dibandingkan dengan HTML).


## Pemasangan

Untuk menggunakan RST, anda harus memasang [Python](http://www.python.org) dan
Expand All @@ -33,12 +32,11 @@ Jika sistem anda sudah mempunyai `pip`, anda bisa menggunakannya juga:
$ pip install docutils
```


## Sintaks file

Sebuah contoh sederhana dari sintaks file:

```
```rst
.. Baris yang dimulai dengan dua titik adalah perintah spesial. Tetapi jika
perintah tidak ditemukan, maka baris tersebut akan dianggap sebagai komentar
Expand Down Expand Up @@ -98,7 +96,6 @@ otomatis diubah menjadi sebuah link)
.. _GitHub https://github.com/
```


## Bagaimana Cara Menggunakannya

RST hadir dengan docutils di mana anda mempunyai `rst2html`, sebagai contoh:
Expand All @@ -115,7 +112,6 @@ Tetapi ada beberapa aplikasi kompleks yang menggunakan format RST:
- [Sphinx](http://sphinx-doc.org/), Generator dokumnetasi
- dan masih banyak lainnya


## Bacaan

- [Referensi singkat resmi](http://docutils.sourceforge.net/docs/user/rst/quickref.html)
4 changes: 1 addition & 3 deletions it-it/rst-it.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -31,12 +31,11 @@ Oppure, se hai `pip` installato sul tuo sistema:
$ pip install docutils
```


## Sintassi del file

Ecco un semplice esempio della sintassi RST:

```
```rst
.. Le righe che iniziano con due punti sono comandi speciali. Ma se non è possibile trovare alcun comando, la riga viene considerata come un commento
===============================================================================
Expand Down Expand Up @@ -104,7 +103,6 @@ Ma ci sono applicazioni più complesse che utilizzano il formato RST:
- [Sphinx](http://sphinx-doc.org/), un generatore di documentazione
- e molti altri


## Letture

- [Riferimento ufficiale rapido](http://docutils.sourceforge.net/docs/user/rst/quickref.html)
2 changes: 1 addition & 1 deletion rst.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ $ pip install docutils

A simple example of the file syntax:

```
```rst
.. Lines starting with two dots are special commands. But if no command can be found, the line is considered as a comment.
=========================================================
Expand Down

0 comments on commit 8e94abc

Please sign in to comment.