reStructuredText

Z Wikipedii, wolnej encyklopedii
Skocz do: nawigacja, szukaj
reStructuredText
Rozszerzenia pliku .rst
Data opracowania 2001-06-02[1]
Ostatnia wersja 0.9.1 (2012-06-17)[2]
Typ Język znaczników
Strona internetowa

reStructuredTextjęzyk znaczników oraz analizator składniowy, przeznaczony do szybkiego tworzenia prostych stron internetowych, samodzielnych dokumentów i dokumentacji technicznej[3].

reStructuredText jako język znaczników, wprowadzanych zwykłym tekstem (ang. plaintext), wykorzystuje proste i intuicyjne konstrukcje do wskazania struktury oraz formatowania dokumentu. Te konstrukcje i znaczniki są równie łatwe do odczytania w formach surowych (ang. raw), jak i przetworzonych (np. do docelowych formatów: HTML, PDF, LaTeX i innych)[4].

Parser reStructuredText wchodzi w skład większego systemu Docutils[3] w języku programowania Python, którego celem jest stworzenie zestawu narzędzi do generowania dokumentacji kodu źródłowego dla Pythona, podobnego do Javadoc dla Javy lub POD dla Perla.

reStructuredText jest czasami skracany jako RST, ReST lub reST. Może to być źródłem zamieszania oraz mylnie wskazywać na niepowiązaną z reStructuredText technologią Representational State Transfer (REST).

Zastosowanie[edytuj | edytuj kod]

reStructuredText jest popularnym i powszechnie używanym językiem do tworzenia dokumentacji technicznej, na przykład w dokumentacji bibliotek, jak i samego języka Python[5]. Jednakże nadaje się również do tworzenia szerokiego zakresu innych, niekoniecznie technicznych tekstów.

reStructuredText jest podstawowym komponentem Pythonowego systemu generowania dokumentacji Sphinx.

System zarządzania projektami i śledzenia błędów Trac wspiera reStructuredText oraz umożliwia wykorzystanie go jako alternatywę dla wikitekstu.

Przykłady składni[edytuj | edytuj kod]

Nagłówki i sekcje[edytuj | edytuj kod]

1. Rozdział pierwszy
====================

1.1. Podrozdział
----------------

1.1.1. Podrozdział
~~~~~~~~~~~~~~~~~~

1.2. Podrozdział
----------------

2. Rozdział drugi
=================

Listy[edytuj | edytuj kod]

Listy numerowane:

1) Pierwszy element listy

2) Drugi element listy

   a) Sub-element

      i) Sub-sub element

3) Trzeci element listy

#. Kolejny (czwarty) element (lista auto-numerowana)

Listy nienumerowane:

- Pierwszy element listy

- Drugi element listy

  - Sub-element

- Trzeci element listy

Definicje[edytuj | edytuj kod]

Pojęcie1 
  Definicja pierwsza
Pojęcie2 
  Definicja druga

Formatowanie tekstu[edytuj | edytuj kod]

*emfaza*
**silna emfaza**
``tekst o stałej szerokości znaków``

Ilustracje[edytuj | edytuj kod]

.. image:: /scieżka/do/pliku/obrazek.jpg

Odnośniki[edytuj | edytuj kod]

Linki nazwane:

Przykład zdania z odnośnikami do Wikipedii_ i strony `Linux kernel archive`_.

.. _Wikipedii: http://www.wikipedia.org/
.. _Linux kernel archive: http://www.kernel.org/

Linki nienazwane (anonimowe):

Przykład zdania z `anonimowym odnośnikiem do strony domowej Pythona`__.
 
__ http://www.python.org/

Odnośniki umieszczać można również jako osadzone umieszczając link między nawiasami ostrokątnymi (< >).

Ekwiwalentny zapis powyższego zdania z osadzonym odnośnikiem do strony domowej `Pythona <http://www.python.org/>`_.

Linki wewnętrzne:

Wewnętrzny link do innej części dokumentu, przykład_.

.. _przykład:

To jest przykład elementu docelowego dla linka wewnętrznego.

Komentarze[edytuj | edytuj kod]

.. Ten tekst nie zostanie wyświetlony

lub

.. 
   Ten tekst
   również nie zostanie wyświetlony

Przypisy

Zobacz też[edytuj | edytuj kod]

Linki zewnętrzne[edytuj | edytuj kod]