Regole per la formattazione

Questa pagina contiene una lista più completa delle sequenze di marcatori disponibili in PmWiki. Si noti che è facile creare e modificare pagine anche senza usare alcuno dei marcatori seguenti; in caso di necessità, esistono anche questi.

Paragrafi

Per creare un paragrafo, basta scriverne il testo. Inserendo una linea vuota, si dà inizio a un altro paragrafo. Le righe di testo vengono adattate alla larghezza della finestra e giustificate (è il comportamento standard dell’XHTML). Per evitare la giustificazione automatica, inserire la direttiva (:linebreaks:) all’inizio del paragrafo.

Per agire sulla formattazione dei paragrafi si possono dare i seguenti comandi:

  • \ (una sola barra) se inserita alla fine di una linea, la unisce a quella seguente.
  • \\ (due barre) alla fine di una linea forzano un ritorno a capo, ma mantenendo il paragrafo e la formattazione corrente (ad es. si possono usare per rimanere all’interno dell’attuale elenco puntato).
  • \\\ (tre barre) alla fine di una linea forzano due ritorni a capo consecutivi.
  • [[<<]] manda a capo e interrompe lo scorrimento del testo attorno a elementi floating.

Paragrafi indentati (Citazioni)

Le frecce (->) all’inizio di un paragrafo possono essere usate per creare un paragrafo indentato. Più trattini all’inizio (--->) generano una maggiore indentazione

->Ottantasette anni fa, i nostri padri fondarono su questo continente
una nuova nazione, concepita in libertà e dedicata all'idea che tutti gli
uomini sono stati creati uguali.
Ottantasette anni fa, i nostri padri fondarono su questo continente una nuova nazione, concepita in libertà e dedicata all’idea che tutti gli uomini sono stati creati uguali.

Le frecce invertite (-<) inserite all’inizio di un paragrafo indentano tutto tranne la prima linea. Aggiungendo trattini all’inizio delle frecce (---<) si indenta tutto il paragrafo.

-<Ottantasette anni fa, i nostri padri fondarono su questo continente
una nuova nazione, concepita in libertà e dedicata all'idea che tutti gli
uomini sono stati creati uguali.
Ottantasette anni fa, i nostri padri fondarono su questo continente una nuova nazione, concepita in libertà e dedicata all’idea che tutti gli uomini sono stati creati uguali.
---<Ottantasette anni fa, i nostri padri fondarono su questo continente
una nuova nazione, concepita in libertà e dedicata all'idea che tutti gli
uomini sono stati creati uguali. E che il cibo deve essere buono.
Ottantasette anni fa, i nostri padri fondarono su questo continente una nuova nazione, concepita in libertà e dedicata all’idea che tutti gli uomini sono stati creati uguali. E che il cibo deve essere buono.

Per indentare un blocco di testo al quale è applicato (:linebreaks:), bisogna inserire la freccia (->) all’inizio della prima linea e allineare tutte le altre linee sotto la prima. La prima linea non indentata conclude l’indentazione del blocco.

Elenchi puntati e numerati

Gli elenchi puntati si realizzano inserendo asterischi all’inizio di ciascuna riga. Gli elenchi numerati si fanno con il cancelletto (#). Più asterischi o cancelletti aumentano l’indentazione dell’elenco:

* elemento del primo livello
** elemento del secondo livello
### ordina questo
#### anche questo (opzionale)
### poi questo
** altro elemento del secondo livello
* nuovo elemento del primo livello
## Prepara l'esperimento
### Rimuovi il pop-tart dall'involucro
### Inserisci il pop-tart nel tostapane
## Inizia a cuocere il pop tart
## Allontanati dal tostapane
  • elemento del primo livello
    • elemento del secondo livello
      1. ordina questo
        1. anche questo (opzionale)
      2. poi questo
    • altro elemento del secondo livello
  • nuovo elemento del primo livello
    1. Prepara l’esperimento
      1. Rimuovi il pop-tart dall’involucro
      2. Inserisci il pop-tart nel tostapane
    2. Inizia a cuocere il pop tart
    3. Allontanati dal tostapane

Liste di definizioni

Le liste di definizioni si realizzano inserendo duepunti all’inizio di ciascuna linea da definire, e tra ciascun termine e la definizione.

:termine:definizione del termine
::elemento di secondo livello: definizione dell'elemento di secondo livello
termine
definizione del termine
elemento di secondo livello
definizione dell’elemento di secondo livello

Regole per le spaziature

Indentazione con spazi nelle liste. Se una linea inizia con spazi, che la allineano con un elemento precedente di una lista (puntata, numerata o di definizioni), allora tale linea si considera “all’interno” dell’elemento. Il testo viene formattato normalmente e viene applicata la direttiva (:linebreaks:).

# Elemento di primo livello\\
  Gli spazi fanno sì che questo sia ancora dentro l'elemento
# Un altro elemento di primo livello
  # Gli spazi, insieme a un singolo # creano un elemento di livello
inferiore
  1. Elemento di primo livello
    Gli spazi fanno sì che questo sia ancora dentro l’elemento
  2. Un altro elemento di primo livello
    1. Gli spazi, insieme a un singolo # creano un elemento di livello inferiore

In alternativa, le linee che iniziano con spazi vengono trattate come testo pre-formattato, cioè vengono mostrate con un carattere monospaziato, andando a capo soltanto quando esplicitamente richiesto nel markup. Nota per gli amministratori: dalla versione 2.2.0-beta41, questo comportamento può essere modificato usando $EnableWSPre. (Un altro modo per inserire testo preformattato è usando il markup [@...@]).

Linee orizzontali

Quattro o più trattini (----) all’inizio di una riga producono una linea orizzontale.

Rilievi (Emphasis)

  • Due apici (''), es. , due apostrofi, per enfatizzare (generalmente corsivo)
  • Tre apici ('''), es. , tre apostrofi, per enfatizzare molto (generalmente grassetto)
  • Cinque apici ('''''), or tre con altri due (cinque apostrofi), per un’ultriore enfatizzazione (generalmente grassetto corsivo)
  • Doppia chiocciola (at) (@@) per testo monospaziato
  • Usa [+...+] per ottenere testo più grande, [++...++] per testo ancora più grande, [-...-] per testo più piccolo e [--...--] per testo ancora più piccolo.
  • I rilievi si possono usare più volte nella stessa linea, ma vengono interrotti dai marcatori che interrompono la linea (es. non si può mettere un ritorno a capo a metà di un testo in grassetto).
  • '~corsivo~' e '*grassetto*' possono essere abilitati nel config.php.

Altri stili

'+grande+', '-piccolo-', '^apice^', '_pedice_', 

{+inserito o sottolineato+}, 

{-cancellato o barrato-}

grande, piccolo, apice, pedice,

inserito o sottolineato,

cancellato o barrato

  • `WikiWord neutralizzazione parole chiave WikiWord

Vedi anche WikiStyles per le opzioni avanzate di formattazione.

Collegamenti

  • Parole e frasi tra parentesi quadre doppie (es.[[regole di formattazione ]]) diventano collegamenti ad altre pagine di questo wiki.
  • Su alcuni siti, parole unite e con le iniziali maiuscole (es. WikiWord) possono anche essere usate per creare collegamenti ad altre pagine, senza bisogno delle doppie parentesi quadre
  • Le URL che iniziano con “http:”, “ftp:”, “gopher:”, “mailto:”, o “news:” diventano link automaticamente, come http://www.pmichaud.com/toast.
  • URL che terminano con .gif, .jpg, o .png sono visualizzati come immagini nella pagina.
  • Per i collegamenti si può specificare un testo: [[destinazioneCollegamento | testo]] o [[testodestinazioneCollegamento]]. testo può essere un collegamento ad un’immagine, in tal caso l’immagine diventa un link all’indirizzo remoto (URL o WikiWord).
  • Collegamenti a etichette poste all’interno della stessa pagina (#-links) possono essere creati usando [[#nome_etichetta]].

Titoli

I titoli sono realizzati mettendo punti esclamativi (!) ad inizio riga. Più punti esclamativi aumentano il livello del titolo. Per esempio,

! Livello Titolo 1
!! Livello Titolo 2
!!! Livello Titolo 3

Livello Titolo 1

Livello Titolo 2

Livello Titolo 3

Sequenze di Escape

Qualsiasi cosa messa tra [= e =] non viene interpretata da PmWiki. Ciò permette facilmente di scrivere delle parole chiave WikiWords che non sono collegamenti (per questo l’alternativa più veloce è usare un apostrofo, ad es: `WikiWord) e disabilita ogni altro stile di formattazione.

Per inserire blocchi di testo preformattato si deve usare il markup [@...@].

[@
Qui ci può andare codice, come [[PmWikiIt.PmWikiIt]]
'$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]'; #un po' di codice
@]
Qui ci può andare codice, come [[PmWikiIt.PmWikiIt]]
'$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]'; #un po' di codice

Il markup [= =] è utile anche all’interno di altre strutture wiki, perché permette di inserire ritorni a capo nei campi testuali. L’esempio che segue mostra come includere un valore su più linee in un campo nascosto di un form.

(:input hidden message "[=Linea1
Linea2=]":)

Tabelle

Le tabelle sono definite circondando le celle con ‘||’. Il testo di una cella che inizia e finisce con uno spazio è allineato al centro; una cella che inizia con uno spazio dopo ‘||’ allinea a destra il testo; tutti gli altri tipi di cella sono allineati a sinistra. Una cella vuota invece, genera una cella che si allarga su più colonne della tabella. (Attualmente non esiste la possibilità di realizzare celle che si distribuiscano su più righe). Una linea che inizia con ‘||’ specifica le caratteristiche delle tabelle che seguono. Un punto esclamativo ‘!’ all’inizio di una cella ne mette in rilievo il contenuto; questa funzione è utile per fare titoli.

||border=1 width=50%
||!Esempio||!di||!titolo||
||Sinistra   || Centro ||  Destra||
||A      ||    B   ||      C||
||       || singola || ||
||       || multi colonna ||||
Esempiodititolo
SinistraCentroDestra
ABC
 singola 
 multi colonna