Creazione di link

Il ruolo wiki converte un testo in un link ad una pagina wiki interna: ad esempio per creare un link a questa pagina è possibile usare la sintassi:

:wiki:`Documentazione Wiki`

Il ruolo è impostato come ruolo di default: questo vuol dire che è sufficiente usare i soli backtick per creare un link, ad esempio:

`Documentazione Wiki`

Se si desidera creare un link dove il testo è diverso dal nome della pagina linkata, occorre usare una sostituzione di testo con la direttiva wiki, ad esempio:

Si veda la |documentazione|.

.. |documentazione| wiki:: Documentazione Wiki

Allegati

Per aggiungere una tabella con l'elenco dei file allegati alla pagina si può usare la direttiva attachmentlist, ad esempio:

.. attachmentlist::

Per creare un link ad un singolo allegato, si può usare la direttiva attachment:

Questo è un allegato alla pagina:

.. attachment:: 1

o anche:

.. attachment:: 1
    :label: questa è un'etichetta alternativa

Se si desidera avere il link come testo corrente in un paragrafo, si può usare anche qui una sostituzione, ad esempio:

Vi consiglio di scaricare |il mio allegato|.

.. |il mio allegato| attachment:: 1

Se l'allegato è un'immagine, si può includere l'anteprima nella pagina con la direttiva img:

.. img:: 1

L'immagine risultante sarà un link all'immagine a risoluzione piena. Se si desidera non creare tale link si può aggiungere l'opzione nolink:

.. img:: 1
    :nolink:

Altre opzioni supportate sono width, height, scale, align, alt, class: il significato è lo stesso della direttiva image.