Sintassi pmwiki

due backslash \\ a fine riga mandano a capo

''parola o frase'' fra due virgolette diventa italic
'''parola o frase''' fra tre virgolette diventa bold
@@parola o frase@@ tra due chiocciole e' monospaced
%text-decoration=line-through% mi ci fa una riga sopra, lo stoppo con %%
[-parola o frase-] tra due quadre e meno rimpicciolisce
[+parola o frase+] tra due quadre e più ingrandisce

----
quattro dashes fanno una linea

Headers

per fare un header precedi la riga con un ! (dal +grande al +piccolo)
! un punto esclamativo
!! due punti esclamativi
!!! tre punti esclamativi
!!!! quattro punti esclamativi

un punto esclamativo

due punti esclamativi

tre punti esclamativi

quattro punti esclamativi

Elenchi

per fare liste (elenchi) usi gli asterischi a inizio riga
* con un asterisco crei una lista
** piu' asterischi creano liste + profonde

• lista con un asterisco
  • lista con due asterischi
    • lista con tre asterischi
      • lista con quattro asterischi

Links

si crea un link mettendo una parola o una frase tra due quadre [[link]]

quando il link è vuoto, ha un piccolo punto interrogativo sopra link?
cliccandolo si va ad editare.

per rinominare un link si aggiunge nelle quadre pipe + nuovo nome [[link | link nuovo]]

per fare un link esterno basta scriverlo
sempre usare il segno pipe + altro nome per darci il nome voluto
[[http://www.il_link_esterno.org | nome del link]]

per fare un link che si apre in una altra finestra
%newwin%http://www.example.net
http://www.example.net

per fare un link all'interno dello stesso server usa [[Path:../dir/foo | foo]

Colori

scrivi il nome del colore tra due % prima della parola che vuoi colorare
es: %red% parola

colori disponibili:
red blue green purple black white yellow gray silver maroon navy

puoi anche usare i colori web colla sintassi: %color=#ff7f00% color mandarino

definire il colore background
%bgcolor=yellow% evidenziatore
%bgcolor=green yellow% testo giallo su sfondo verde.. iihhh! %%
usa doppia percento %% per interrompere lo stile

puoi anche definire interi blocchi oppure usare delle scorciatoie
per esempio qui definiamo uno stile che chiameremo rediguana
%right bgcolor=#ffffcc border='1px dotted red' padding=5px define=rediguana%

olé. dunque %rediguana% pensa dei pensieri molto belli.

più semplice: %bgcolor=yellow define=evid% per evidenziare

la pagina dei wiki style colors, alcuni esempi di wikistyles

Scorciatoie

conviene creare delle scorciatoie per gli stili usati più di frequente
ancora non so come dare queste scorciatoie globalmente

esempio:
%define=rediguana bgcolor=#ffffcc border='1px dotted red' padding=5px%
%define=strike text-decoration=line-through%

adesso posso fare solo %strike% per tirare le righe

e scrivere %rediguana% per avere l'effetto rosso

sempre che si usa il doppio percento %% per interrompere lo stile

more info

Immagini

Le foto (uplodate nella default directory uploads) si mostrano con la sintassi:
Attach:foto.jpg

Le foto nello stesso server si può usare
Path:/path/to/foto.jpg

Altrimenti basta scrivere l'url assoluto
www.il-sito/foto.jpg

Si può anche aggiungere tra virgolette attaccate una descrizione per elinks
es: http://il_mio_link_alla_foto"che bella foto"
Se si vuole un link, in entrambi i metodi, si mette tra due quadre.
La caption la ottieni con pipe e scritta

Ecco qui una foto d'esempio, con url relativo, descrizione e caption grassettata
Path:../media/feel_good_th.jpg"io sto bene" | '''felicità è un gatto caldo'''

felicità è un gatto caldo

Uguale senza descrizione ma con caption a lato della foto
%lfloat% Path:../media/feel_good_th.jpg '''felicità è un gatto caldo'''[[<<]] questa descrizione andrà sotto la foto

felicità è un gatto caldo
questa descrizione andrà sotto la foto

Altre spiegazioni nella pagina di howto di pmwiki

uso di thumblist
per le foto uplodate con pmwiki basta attivare thumblist cookbook in config.php
e aggiungere (:thumblist:) alla pagina
altre info

altri cookbooks per le foto

per listare le foto uplodate basta creare una pagina con (:attachlist:)

Editing mannaro (sintassi sospesa)

puoi usare la sintassi markup per fare dei bei quadretti azzurrini
all'interno dei quali la sintassi è sospesa

che magnifico quadretto azzurrino

puoi mettere delle sintassi sospese tra quadra-uguale per visualizzarle
%red%

puoi mettere delle sintassi sospese tra quadra-chiocciola per visualizzarle
e averle monospaced
%red%

Amministrazione

come spiegato qui http://pmwiki.com/wiki/PmWiki/Passwords

settiamo delle conf per tutto il sito in /local/config

e delle pswd per page editando gli attributi della pagina stessa:
aggiungi all'url: ?action=attr
e setta o leva il read, edit, attr della pagina

per rimuovere dei settaggio e tornare ai default del sito enter: clear
per creare delle pagine editabili o leggibili senza password enter: @nopass
per loccare una pagine a tutti tranne admin enter: @lock
per assegnare come psw quella default site-wide edit-password enter: @_site_edit

per fare multiple passwd semplicemente scrivile separate da spazio
(per dare a un user read only e a un altro read/edit senza dover dare due password al secondo

per vedere le revisioni alla pagina (solo utenti con edit capacity)
usa ?action=diff

per creare delle pwd crittate nel local/config.php file aggiungi all'url: ?action=crypt
per esempio: http://daniele.freeshell.org/wiki/?action=crypt

Rimuovere le pagine obsolete o la history

ci sono diversi modi:

puoi copiare tutto il contenuto della pagina e al suo posto
lasciare solo la riga: delete
la pagina viene cancellata, poi la riediti e incolli.
in questo modo viene creata una pagina di backup che però è facilmente individuabile.

oppoure puoi via ssh editare direttamente la pagina rimuovendo le ultime tre
o le plurime ultime tre righe:
author:
diff:
host:

questo è pmwiki-2.1.27, verifica la versione disponibile

pagina per Editare vari layout, tipo la SideBar, la pagina dei quick-edit-reference e altri appunti.

backup-layout
sandbox

grazie a PM per aver creato pmwiki
grazie a quelli di dream-logic per i colori