[rst/*] highlight
Some checks failed
Trigger site build / deploy (push) Has been cancelled
CI / lint (push) Has been cancelled

This commit is contained in:
Boris Verkhovskiy 2024-10-25 11:30:04 -06:00
parent 39727a7971
commit 8e94abc88b
5 changed files with 7 additions and 17 deletions

View File

@ -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.

View File

@ -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.
@ -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.
========================================================================
@ -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
@ -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:
@ -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)

View File

@ -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
@ -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
@ -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:
@ -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)

View File

@ -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
===============================================================================
@ -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)

View File

@ -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.
=========================================================