Views

View

State: Public Draft
Actions
- Copy

Document Actions

palestra reST

Documento reST dove allenarsi all'uso della marcatura e formattazione con il re-Structured Text

Il lelit, noto guru del software a sorgente aperto, è un collaboratore del progetto Docutils ed ha tradotto una buona parte della documentazione ufficiale reST in italiano. In quei documenti si possono trovare esempi ed approfondimenti di tutti i costrutti reST. In particolare è utile avere nei propri collegamenti preferiti il breviario che mostra, faccia a faccia, gli esempi di codice con a fronte il risultato. Altro documento particolarmente utile per imparare o per ricordare i vari costrutti reST è http://docit.bice.dyndns.org/ReST/user/rst/quickstart.html

Attenzione!

un piccolo difetto della scheda di modifica, che speriamo verrà presto risolto, costringe ogni volta prima di salvare a re-impostare il campo`Text Format` a text/restructured (altrimenti passa a text/structured).

Per modificare questo documento wiki è necessario essere registrati nel portale.

Prove con il reST

Indice

Prove con il reST

titolo 1

sottotitolo

paragrafo ....

titolo 2

ciao
ciao
1. ciaociao
2. ciaociao
System Message: INFO/1 (<string>, line 60)

Enumerated list start value not ordinal-1: "2" (ordinal 2)
ulla

sbaglio

System Message: INFO/1 (<string>, line 66)

Enumerated list start value not ordinal-1: "3" (ordinal 3)

Prove

o prova corsivo

o prova grassetto

o prova 'codice'

Formattazione

corsivo grassetto 'spaziatura fissa'

altra notazione per spaziatura fissa (configurabile)

Testo preformattato:

questo testo è preformattato

Immagini

Tabelle

tabella semplice

uno	primo
due	secondo
tre	terzo
quattro	quarto che lo faccio anche lungo che va fuori dalle righe

tabella più complessa

uno	primo
due	secondo
tre	terzo
quattro	quarto che lo faccio anche lungo
mentre qui vado su due colonne
elemento altro elemento

Collegamenti

AiutoSuModificaPagina?¿ MoinMoin:InterWiki

http://purl.net/wiki/moin/ [http://www.python.org/ Python]

qualcuno@la.fuori.chissa.dove

[file:///home/lele/public_html/multicgi.html]

file:///tmp/lele.jpg

Permesso Descrizione

Access contents information Questo permesso consente l'accesso ad un oggetto senza necessariamente consentire di vedere l'oggetto. Per esempio un utente potrebbe voler vedere il titolo dell'oggetto in un elenco di risultati, anche se l'utente non può vedere il contenuto di quel file.

Add Ci sono numerosi permessi Add, ciascuno relativo ad un tipo di oggetto che un utente può aggiungere. Per un normale sito Plone tutti i permessi sono raggruppati insieme in Add portal content.
System Message: ERROR/3 (<string>, line 169)

Malformed table. Column span alignment problem at line offset 4.
===========================  ============
 Permesso                     Descrizione
===========================  ============
Access contents information   Questo permesso consente l'accesso ad
                              un oggetto senza necessariamente
                              consentire di vedere l'oggetto.  Per
                              esempio un utente potrebbe voler vedere
                              il titolo dell'oggetto in un elenco di
                              risultati, anche se l'utente non può
                              vedere il contenuto di quel file.

Add                           Ci sono numerosi permessi *Add*,
                              ciascuno relativo ad un tipo di oggetto
                              che un utente può aggiungere.  Per un
                              normale sito Plone tutti i permessi
                              sono raggruppati insieme in *Add portal
                              content*.
===========================  ============

http://artista/new/plone/as/rs/lv_dati/view

embedded link a Grosseto

paragrafo paragrafo paragrafo paragrafo paragrafo paragrafo

quote quote quote

Barbatrucco capoverso

Il reST non prevede l'uso dei capoversi all'interno di uno stesso paragrafo ma è possibile aggirare il problema con una barbatrucco [1]:

Nel testo inserisco un link ad una sostituzione: |br| che viene
risolto nella direttiva `raw:: html`.

.. |br| raw:: html

   <br />

che darà come risultato:

Nel testo inserisco un link ad una sostituzione:
che viene risolto nella direttiva raw:: html.

Ma forse c'è un altro e migliore sistema. Per ottenere ...:

I blocchi di righe sono utili per inserire indirizzi,

versi e semplici elenchi, senza adornamenti.

Ogni riga del blocco inizia con una barra

verticale ("|").

Sia gli a capo che l'indentazione (????)

vengono preservati.

Le righe continuate sono porzioni di righe molto lunghe portate a capo; cominciano con uno spazio anziché con la barra verticale.

Un paragrafo normale rientra normalmente...

Quindi per spezzare [1] con capoversi un paragrafo
basterebbe far rientrare di due posizioni tutto il testo badando di
anteporre "| " (barra verticale+spazio) all'inizio di ogni
capoverso.
Non è un sistema molto comodo e funziona solo se si desidera un
output in html ma quando si ritiene sia necessario questo è l'unico
sistema (per ora).
Ogni volta che si prefissa una riga con "| " verrà inserito un a
capo nel testo.

questo è il codice:

| I `blocchi di righe`_ sono utili per inserire indirizzi,
|  versi e semplici elenchi, senza adornamenti.
| Ogni riga del blocco inizia con una barra
|  verticale ("|").
|     Sia gli a capo che l'indentazione (????)
|     vengono preservati.
| Le righe continuate sono porzioni di
  righe molto lunghe portate a capo; cominciano
  con uno spazio anziché con la barra verticale.

Un paragrafo *normale* rientra normalmente...

| Quindi per spezzare [#raw_html]_ con capoversi un paragrafo
  basterebbe far rientrare di due posizioni tutto il testo badando di
  anteporre `"| "` (barra verticale+spazio) all'inizio di ogni
  capoverso.
| Non è un sistema molto comodo e funziona solo se si desidera un
  output in html ma quando si ritiene sia necessario questo è l'unico
  sistema (per ora).
| Ogni volta che si prefissa una riga con `"| "` verrà inserito un *a
  capo* nel testo.

[1]	(1, 2) NB: Il limite di questo trucco è che vale solo per un output HTML.

Portale Arti e Mestieri

Sections

Personal tools