Pagine in Markdown

Questo wiki può salvare le pagine in Markdown oltre che nella sintassi wiki di MoinMoin. I due tipi di pagina convivono: si collegano tra loro, compaiono nelle ricerche, nelle modifiche recenti e nei backlink, e hanno cronologia, differenze e allegati.

Contents

  1. Pagine in Markdown
    1. Scrivere una pagina in Markdown
    2. Testo
    3. Collegamenti
    4. Allegati e immagini
    5. Macro
    6. Codice e altre sintassi
    7. Cosa non è supportato

Scrivere una pagina in Markdown

Basta scrivere la pagina in Markdown: MoinMoin legge il testo e riconosce da solo se una pagina è scritta in Markdown o nella sintassi wiki di MoinMoin (per esempio dai titoli # Titolo, dal **grassetto**, dai link [testo](link), dagli elenchi a inizio riga, dai blocchi di codice ```). Le pagine wiki esistenti restano come sono.

Se una pagina è troppo corta o semplice per essere riconosciuta (viene allora mostrata come sintassi wiki), metti questa riga all'inizio della pagina (non viene mostrata):

#format markdown

oppure crea la pagina dal MarkdownTemplate. Una riga #format vale sempre più del riconoscimento automatico (#format moin impone la sintassi wiki di MoinMoin; vale anche il vecchio #format wiki). L'amministratore può disattivare il riconoscimento con markup_autodetect = False, e rendere Markdown il formato delle pagine senza riga #format con default_markup = 'markdown'.

Le righe # Titolo e ## Sezione in una pagina Markdown sono intestazioni Markdown (le istruzioni di MoinMoin, come #acl, non hanno uno spazio dopo il #).

Testo

Markdown Risultato
**grassetto** grassetto
*corsivo* corsivo
`codice` codice
> citazione citazione
* voce oppure 1. voce elenchi
--- linea orizzontale

Sono supportate anche tabelle, note a piè di pagina1, liste di definizioni e abbreviazioni.

Collegamenti

  • [[NomePagina]] e [[NomePagina|testo]], come nella sintassi wiki: FrontPage
  • [testo](NomePagina): la pagina principale
  • [testo](/SottoPagina) e [testo](../PaginaSorella): nomi relativi
  • [[NomePagina#ancora|testo]]: una sezione di una pagina
  • [[MoinMoin:HelpOnMacros]]: collegamenti interwiki
  • [testo](https://example.org) e <https://example.org>: collegamenti esterni

Un indirizzo senza schema (https: ecc.) è una pagina del wiki. Per sicurezza sono ammessi solo schemi sicuri (http, https, ftp, mailto, ...).

Allegati e immagini

  • [[attachment:file.pdf|testo]] oppure [testo](attachment:file.pdf)
  • ![descrizione](attachment:immagine.png) mostra un'immagine allegata
  • ![descrizione](https://example.org/immagine.png) mostra un'immagine esterna

Macro

Le macro di MoinMoin funzionano come nella sintassi wiki, per esempio <<TableOfContents>>, <<RecentChanges>>, <<FullSearch(testo)>> o <<Date(...)>>. Dentro `codice` non vengono eseguite.

Codice e altre sintassi

Un blocco delimitato con il nome di un linguaggio viene evidenziato:

   1 def saluta(nome):
   2     return "Ciao, %s!" % nome

Un blocco chiamato wiki (o creole, rst, csv) usa quella sintassi, quindi dentro una pagina Markdown si può scrivere in sintassi wiki:

Sintassi wiki di MoinMoin, con un'icona :-).

Cosa non è supportato

L'HTML grezzo viene mostrato come testo e non interpretato (così nessuno può inserire script nel wiki). L'editor grafico funziona solo con le pagine in sintassi wiki: le pagine Markdown si modificano con l'editor di testo.

  1. Come questa nota. ↩