Regole di base per la modifica

Le pagine di questo sito sono pagine WikiWikiWeb, il che significa che possono essere create ed editate da molti autori. Per modificare una pagina fai clic sul link Modifica posto in alto e in fondo alla pagina. Per modificare alcune pagine può essere necessario possedere una password.

Quando modifichi una pagina vedi il markup text che ne descrive il contenuto. Le regole base sono piuttosto semplici:

  1. Lasciare un rigo bianco tra i paragrafi
  2. Per una lista numerata fare iniziare ogni riga con il simbolo del cancelletto # mentre va usato l’asterisco * per le liste non numerate
  3. Per una intestazione, cominciare la riga con un punto esclamativo !, con due punti esclamativi !! si ottiene un sottotitolo, con tre !!! un sotto-sottotitolo
  4. Per enfatizzare il testo racchiuderlo da due apici singoli '' per avere il corsivo, o tra tre apici singoli ''' per avere il neretto
  5. Per mettere un link ad un altra pagina (link interno al wiki), racchiudere il nome della pagina tra doppie parentesi quadre [[ e ]]; per esempio [[basic editing]] è un link a questa pagina. Link a pagine ancora non esistenti sono mostrati in modo speciale, con un punto interrogativo sopra, per invitare alla creazione di quella pagina.
  6. Per fare un link ad un sito esterno è sufficiente scrivere il suo indirizzo, preceduto sempre da http://, ad esempio: http://www.example.com

Per fare prove, si può usare la WikiSandbox. Questa pagina può essere modificata senza ripercussioni sul resto del sito. Quando modifichi pagine scritte da altri, è cortese “firmare il tuo contributo”. Scrivendo di seguito tre tildi ~~~ (Alt+126 nel tastierino numerico) fai comparire - come firma - il nome che hai inserito nel campo Autore della pagina che stai modificando

Esempi

La tabella che segue mostra molte delle possibilità di formattazione che PmWiki offre. Nella colonna a destra si trovano gli effetti visivi prodotti, in quella a sinistra come ottenerli. Altre informazioni si trovano tra le regole di formattazione ed in altre pagine di documentazione. La lista completa dei marcatori è invece qui: MarkupMasterIndexit.

Uso Generale

Cosa si scrive

Cosa si vede

Andare a capo
semplicemente non si vede.

Per iniziare un nuovo paragrafo bisogna
lasciare una riga vuota.

Andare a capo semplicemente non si vede.

Per iniziare un nuovo paragrafo bisogna lasciare una riga vuota.

Liste

* Le liste puntate si creano con un
asterisco davanti ad ogni singola voce
** Con due o più asterischi si crea un
sottoelenco
*** Una lista viene terminata
dalla prima riga che non è una lista
* una lista si prosegue allineando
  il testo con spazi bianchi
* inserendo due slash \\
  si va a capo
  • Le liste puntate si creano con un asterisco davanti ad ogni singola voce
    • Con due o più asterischi si crea un sottoelenco
      • Una lista viene terminata

dalla prima riga che non è una lista

  • una lista si prosegue allineando il testo con spazi bianchi
  • inserendo due slash
    si va a capo
# Le liste numerate si creano col segno
di cancelletto davanti ad ogni 
# singola voce
## più cancelletti creano sottoliste
*** le liste si possono combinare
-> per mantenere le numerazioni
utilizzare gli [[ListStylesit|stili
delle liste]]
## Inserendo testo tra gli elementi di
una lista, la numerazione riparte da 1
## %item value=3% a questo si può porre
rimedio
  1. Le liste numerate si creano col segno di cancelletto davanti ad ogni
  2. singola voce
    1. più cancelletti creano sottoliste
      • le liste si possono combinare
per mantenere le numerazioni utilizzare gli stili delle liste
  1. Inserendo testo tra gli elementi di una lista, la numerazione riparte da 1
  2. a questo si può porre rimedio
-> Le indentazioni di paragrafo si
fanno  con una freccia a inizio riga
(->)

   Per mantenere l'indentazione bisogna
allineare il testo usando spazi bianchi 

-->una freccia più lunga (-->) fa
rientrare di più

-<Con una freccia rovesciata (-<)
invece si crea un rientro diverso
(paragrafo appeso): perchè è solo la
prima riga che rientra, le altre
rimangono normali
--<Anche qui, frecce più lunghe
aumentano l'indentazione
Le indentazioni di paragrafo si fanno con una freccia a inizio riga (→)
Per mantenere l’indentazione bisogna allineare il testo usando spazi bianchi
una freccia più lunga (→) fa rientrare di più
Con una freccia rovesciata (-<) invece si crea un rientro diverso (paragrafo appeso): perchè è solo la prima riga che rientra, le altre rimangono normali
Anche qui, frecce più lunghe aumentano l’indentazione
: Lista di definizioni : a ciascun
elemento corrisponde una definizione
: termine 1 da definire : la definizione
1
: termine 2 da definire : la definizione
2
:: indentazione : è possibile aumentare
la profondità della lista
Lista di definizioni
a ciascun elemento corrisponde una definizione
termine 1 da definire
la definizione 1
termine 2 da definire
la definizione 2
indentazione
è possibile aumentare la profondità della lista
 Righe che iniziano con uno spazio
 bianco vengono rese esattamente
 come scritte, comprese le andate a
capo,
 in un font tipo Courier monospazio

Attenzione in questo caso a non fare
righe troppo 
lunghe perchè allargano la pagina e
possono perciò 
renderla difficile da leggere
Righe che iniziano con uno spazio
bianco vengono rese esattamente
come scritte, comprese le andate a capo,
in un font tipo Courier monospazio

Attenzione in questo caso a non fare righe troppo lunghe perchè allargano la pagina e possono perciò renderla difficile da leggere

%rfloat% Questo testo è in un box
allineato a destra

%rframe% Questo testo è in un box a
destra, con bordi

Questo testo non è allineato, serve per
chiarire l'esempio.

%center% Testo centrato

%right% Testo allineato a destra (è
necessario indentarlo -> se il testo
precedente non è indentato)

Questo testo è in un box allineato a destra

Questo testo è in un box a destra, con bordi

Questo testo non è allineato, serve per chiarire l’esempio.

Testo centrato

Testo allineato a destra (è necessario indentarlo → se il testo precedente non è indentato)

Quattro o più trattini (segno meno)
ad inizio riga
----
producono una linea orizzontale

Quattro o più trattini (segno meno) ad inizio riga


producono una linea orizzontale

Link

Cosa si scrive

Cosa si vede

* Il testo tra doppie parentesi quadre
diventa un link ad una pagina
* Il titolo della pagina viene
visualizzato con l'iniziale maiuscola
Esempio: fai pratica nella [[wiki
sandbox]].
  • Il testo tra doppie parentesi quadre diventa un link ad una pagina
  • Il titolo della pagina viene visualizzato con l’iniziale maiuscola

Esempio: fai pratica nella wiki sandbox.

  • Quando si fa un collegamento a una pagina in un altro wikigroup diverso, bisogna specificare il nome di tale gruppo, seguito da un separatore e dal nome della pagina.
  • Se il separatore è uno slash (/) apparirà solo il nome della pagina.
  • Se il separatore è un punto (.) allora apparirà anche il nome del gruppo.
Fai pratica nella [[Main/WikiSandbox]].

In quale?
Nella [[Main.WikiSandbox]].

Fai pratica nella WikiSandbox.

In quale? Nella Main.WikiSandbox.

  • Il testo inserito dopo una barra diritta (|) o prima di una freccia (→) è il testo del link.
  • PmWiki mette automaticamente lettere maiuscole nei link
Esercitati nell'[[WikiSandbox | area di
pratica]].

Esercitati nell'[[Main.WikiSandbox |
area di pratica]].

Esercitati nell'[[area di pratica ->
Wiki sandbox]].

Le direttive avanzate per costruire
tabelle sono descritte nella pagina
[[TableDirectivesit]].

Esercitati nell’area di pratica.

Esercitati nell’area di pratica.

Esercitati nell’area di pratica.

Le direttive avanzate per costruire tabelle sono descritte nella pagina TableDirectivesit.

  • I suffissi diventano parte del testo del link
  • Le parentesi tonde nascondono parti del testo del link.
esercitati nelle [[wiki sandbox]]es;

esercitati nella [[(wiki) sandbox]]
# a riferimenti: [[Tables |#]]
# al titolo di una pagina [[Basic
editing|+]]

esercitati nelle wiki sandboxes;

esercitati nella sandbox

  1. a riferimenti: [1]
  2. al titolo di una pagina Basic Editing
  • Si possono usare speciali InterMap prefixes che hanno un preciso significato.
  • Le parentesi tonde possono nascondere anche questi.
Cosa significa [[(Wikipedia:)aardvark]]?

Cosa significa aardvark?

Link a siti esterni:
# indicazione semplice dell'url:
http://www.google.com
# link di testo [[http://www.google.com
| Google]]
# come riferimento, in nota:
[[http://www.google.com |#]]

Link a siti esterni:

  1. indicazione semplice dell’url: http://www.google.com
  2. link di testo Google
  3. come riferimento, in nota: [1]
Si possono aprire i siti esterni in una
nuova finestra,
come in %newwin% http://www.pmwiki.org 

Si possono aprire i siti esterni in una nuova finestra, come in http://www.pmwiki.org

Andare a capo

Due backslash \\
interrompono una linea, andando a capo.

I wikistyle e altre
'''%red%formattazioni\\
continuano%% sulla linea''' seguente

In alternativa, per andare a capo si può
usare [[<<]].

Aggiungendo backslash\\\\
si aggiungono linee vuote.

Due backslash
interrompono una linea, andando a capo.

I wikistyle e altre formattazioni
continuano
sulla linea
seguente

In alternativa, per andare a capo si può usare
.

Aggiungendo backslash


si aggiungono linee vuote.

Un singolo backslash unisce la \
prossima linea; in questo modo, più \
linee vengono trattate come una sola.

Un singolo backslash unisce la prossima linea; in questo modo, più linee vengono trattate come una sola.

Formattazione caratteri

Cosa si scrive

Cosa si vede

  • Negli esempi che seguono si usano solo apostrofi (‘) e mai virgolette (“)
Si può ''enfatizzare'', '''molto''' o
'''''moltissimo''''' i

Si può enfatizzare, molto o moltissimo i

@@Testo a grandezza fissa
(monospaziato)@@

[@Questo è un blocco
  di testo
    preformattato@]

Testo a grandezza fissa (monospaziato)

Questo è un blocco
  di testo
    preformattato
* Testo con '^apici^'
* Testo con '_pedici_'
* Testo{-cancellato-} 
* Testo {+sottolineato+}
* Testo [+grande+], [++molto grande++], 
[-piccolo-], [--piccolissimo--]
  • Testo con apici
  • Testo con pedici
  • Testocancellato
  • Testo sottolineato
  • Testo grande, molto grande,

piccolo, piccolissimo

Wiki styles

I [[WikiStylesit | WikiStyles]]
permettono al %red% testo
%blue% di %green% avere
%color=#ff7f00% differenti %%colori.

I WikiStyles permettono al testo di avere differenti colori.

Intestazioni e blocchi

Cosa si scrive

Cosa si vede

  • Le intestazioni sono utili per creare pagine “ben strutturate”. Non servono solamente a inserire testo ingrandito.
!! Intestazione principale
!! [-Intestazione principale con testo
rimpicciolito-]
!!! Intestazione secondaria
!!!! E altri
!!!!! sottotitoli minori

Intestazione principale

Intestazione principale con testo rimpicciolito

Intestazione secondaria

E altri

sottotitoli minori

Titolo della pagina

  • La direttiva (:title:), qui ad es. (:title Regole di base per la modifica:) mette come titolo della pagina qualcosa di diverso dal suo nome
(:Title Regole di base per la modifica:)
Il titolo di questa pagina è {$Title};
con spazi {$Titlespaced}.

Il titolo di questa pagina è Regole di base per la modifica; con spazi Regole di base per la modifica.

Sommario di una pagina

  • La direttiva (:Summary:Inserisci il sommario qui:) imposta il sommario della pagina. Questo viene visualizzato nelle liste di pagine e durante le ricerche.
(:Summary: Sintassi di base PmWiki:)
Il sommario di questa pagina è
{$:Summary}.

Il sommario di questa pagina è Sintassi di base PmWiki.

Stili di blocco

  • i blocchi permettono di applicare uno stile a un numero arbitrario di linee, paragrafi e immagini.
>>purple<<
Tutto il testo in questo blocco è viola
* Mucche viola e fiori viola
* Mangiatori di gente viola
>>red<<
* Adesso questa lista è rossa
>>center<<
* e questa è centrata
>>right green<<
* e questa è verde e allineata a destra.
>><<
* E questa è normale.

Tutto il testo in questo blocco è viola

  • Mucche viola e fiori viola
  • Mangiatori di gente viola
  • Adesso questa lista è rossa
  • e questa è centrata
  • e questa è verde e allineata a destra.
  • E questa è normale.