Table Of Contents

Previous topic

reStrukturitaTeksto

Next topic

Ekzempla artikolo en reStrukturitaTeksto

Komparo de reST kaj txt2tags

Jena dokumento estas provo de komparo inter du markadosistemoj: txt2tags kaj reStructuredText (Esperante: reStrukturitaTeksto).

Pro tio, mi uzis demonstradon de txt2tags kaj preparis similan de reStrukturitaTeksto.

reStrukturitaTeksto povas esti tiel simpla kaj facila kiel txt2tags, sed ĝi ankaŭ povas esti multe pli komplika.

Oni povas aldonadi bildojn, krei listojn, citaĵojn kaj eĉ tabelojn. Kaj ĉio danke al kelkaj kromaj elementoj en la teksto. Oni ne devas memori diversajn nomojn de markilojn kaj iliajn atribuojn.

Lernu reST nun

La subaj ekzemploj estas veraj demonstracioj de la markado.

  • maldekstre: plata teksto kun kelkaj ornamaĵoj (la markado)
  • dekstre: la markita teksto konvertita al HTML per Docutils

BAZO

==================
Titolo de nivelo 1
==================

------------------
Titolo de nivelo 2
------------------

Titolo de nivelo 3
==================

Titolo de nivelo 1

Titolo de nivelo 2

Titolo de nivelo 3
En reStrukturitaTeksto, oni kreas
memnumerantajn sekciotitolojn aldonante
direktivon `.. sectnum::` ie ajn en la
dokumento.

.. "sectnum::" tie ĉi, ĝi estas
   forŝaltita (por ke ĉiuj titoloj ne
   numeriĝu).

==================
Titolo de nivelo 1
==================

------------------
Titolo de nivelo 2
------------------

Titolo de nivelo 3
==================

En reStrukturitaTeksto, oni kreas memnumerantajn sekciotitolojn aldonante direktivon .. sectnum:: ie ajn en la dokumento.

Titolo de nivelo 1

Titolo de nivelo 2

Titolo de nivelo 3
Alineo konsistas de unu aŭ pli da linioj
de teksto ŝovitajn maldekstren.

Kun malplenaj linioj antaŭ kaj post ĝi.

Alineo konsistas de unu aŭ pli da linioj de teksto ŝovitajn maldekstren.

Kun malplenaj linioj antaŭ kaj post ĝi.

.. komencu linion per

du punktoj kaj spaceto

.. kaj ĝi estos ignorita

Tre utilas por marki FARENDAĴOJN!

du punktoj kaj spaceto

Tre utilas por marki FARENDAĴOJN!

Por ornamado, oni povas uzi **fortan
emfazon** kaj *emfazon*.

En baza reST, mankas substreko kaj
forstreko sed estas ``egallarĝa
tiparo``.

Por ornamado, oni povas uzi fortan emfazon kaj emfazon.

En baza reST, mankas substreko kaj forstreko sed estas egallarĝa tiparo.

LISTOJ

- Jen la unua elemento de listo.

- Simple uzu strekosignon (minuson)

  - Deŝovo kreas subliston.

Malplena linio finas la liston.
  • Jen la unua elemento de listo.
  • Simple uzu strekosignon (minuson)
    • Deŝovo kreas subliston.

Malplena linio finas la liston.

#. Ŝanĝu strekon al kradon

#. Kaj jen estas memnumerita
   (ordigita) listo

  #. Aplikas la samaj reguloj

Malplena linio finas la liston.
  1. Ŝanĝu strekon al kradon
  2. Kaj jen estas memnumerita (ordigita) listo
  1. Aplikas la samaj reguloj

Malplena linio finas la liston.

Difinlisto
  Listo kun kapvortoj

Komencu kapvorton
  Kaj ĝia difino sekvas post deŝovo

Difinlisto
Listo kun kapvortoj
Komencu kapvorton
Kaj ĝia difino sekvas post deŝovo

AREOJ

  Citata alineo kreiĝas
  per deŝovo:

    pli deŝovita, pli citita

Forigo de deŝovo kaj malplena linio
finiĝas citaĵon.

Citata alineo kreiĝas per deŝovo:

pli deŝovita, pli citita

Forigo de deŝovo kaj malplena linio finiĝas citaĵon.

::

  Bloko de kruda teksto, estas deŝovita
  teksto, post linio finiĝanta per du
  dupunktoj

  oni ne pritraktas *markadon*
    kaj konservas spacetojn

Ĝi daŭras ĝis malplena linio kaj forigo
de deŝovo.
Bloko de kruda teksto, estas deŝovita
teksto, post linio finiĝanta per du
dupunktoj

oni ne pritraktas *markadon*
  kaj konservas spacetojn

Ĝi daŭras ĝis malplena linio kaj forigo de deŝovo.

Unulinia kruda teksto bone taŭgas por
komandoj::

  $ cat /etc/passwd | tr : ,

Simple aldonu du dupunktojn al la antaŭa
linio.

Unulinia kruda teksto bone taŭgas por komandoj:

$ cat /etc/passwd | tr : ,

Simple aldonu du dupunktojn al la antaŭa linio.

.. raw:: html

  Kruda tekstobloko estas deŝovita
  teksto post speciala direktivo.

  **Markado** ne estas pritraktata
  kaj spacetoj ne konserviĝas.

Ĝi finiĝas per malplena linio kaj forigo
de deŝovo.
Kruda tekstobloko estas deŝovita teksto post speciala direktivo. **Markado** ne estas pritraktata kaj spacetoj ne konserviĝas.

Ĝi finiĝas per malplena linio kaj forigo de deŝovo.

.. raw:: html

  Oni povas enmeti ankaŭ unulinian
  **krudan** tekston.
Oni povas enmeti ankaŭ unulinian **krudan** tekston.

ALIAJ

============= =============
 Tabela kapo   Tabela kapo   
============= =============
Linioj               deŝovo
de la tabelo       en ĝi
kun ĉeloj      ne funkcias!
============= =============
Tabela kapo Tabela kapo
Linioj deŝovo
de la tabelo en ĝi
kun ĉeloj ne funkcias!
.. image:: rst.png
   :align: left

Maldekstren deŝovita bildo.

Centrita (enlinia) |rst| bildo.

.. |rst|  image:: rst.png

Dekstren ŝovita bildo.

.. image:: rst.png
   :align: right
../../_images/rst.png

Maldekstren deŝovita bildo.

Centrita (enlinia) rst bildo.

Dekstren ŝovita bildo.

../../_images/rst.png
Ligilo estas plej ofte rekonata aŭtomate
adreso@servilo.net.

`Nomita ligilo`_

.. _`nomita ligilo`: http://mia.servilo.net

Bilda ligilo

.. image:: rst.png
   :target: http://mia.servilo.net

Ligilo estas plej ofte rekonata aŭtomate adreso@servilo.net.

Nomita ligilo

Bilda ligilo

../../_images/rst.png
Dividolinio 

--------------------

(almenaŭ 4 sinsekvaj interpunkciaj
signoj)

reST ne distingiĝas ĝian dikecon en
eligo, tamen oni povas uzi diversajn
interpunkciajn signojn en plata teksto.

Dividolinio


(almenaŭ 4 sinsekvaj interpunkciaj signoj)

reST ne distingiĝas ĝian dikecon en eligo, tamen oni povas uzi diversajn interpunkciajn signojn en plata teksto.

Iru al docutils paĝaro.