PmWiki può essere configurato in modo da permettere agli autori di caricare file e immagini. Questi file sono anche detti “allegati”. Ciascun allegato può essere collegato o mostrato in qualunque pagina.
Attach:
Per aggiungere o inserire un allegato, è sufficiente modificare una pagina ed inserire il marcatore “Attach:
” seguito dal nome dell’allegato (ad es. Attach:file_name.ext
, Attach:Group.NomePagina/file_name.ext
o, nel caso avessimo un’ulteriore sottopagina, Attach:Group.NomePagina1,NomePagina2/file_name.ext
).
Quando la pagina è visualizzata, Attach:
diventerà:
Di default il caricamento dei file con le seguenti estensioni è abilitato:
'gif','jpg','jpeg','png','bmp','ico','wbmp', # immagini 'mp3', 'au','wav', # audio 'mpg','mpeg','wmf','mov','qt','avi', # video 'zip', 'gz','tgz','tar','rpm','hqx', # archivi 'odt','ods','odp', # OpenOffice.org 'doc','ppt','xls','exe','mdb', # MSOffice 'pdf','psd', 'ps','ai','eps', # Adobe 'htm','html','fla','swf', # roba per il web 'txt','rtf','exe','tex','dvi','' # varie
Il comportamento dei link può essere modificato:
[[Attach:immagine.jpg]]
);
Attach:
” all’nizio, inserirlo così: [[(Attach:)file.ext]]
Per inserire un collegamento a un file il cui nome contiene spazi, bisogna usare le doppie parentesi quadre; per esempio:
[[Attach:un file con spazi.txt]]
Per allegare un’immagine che abbia spazi nel proprio nome, facendo sì che venga visualizzata, bisogna usare una di queste due scappatoie:
[[#blank | Attach:immagine con spazi.jpeg]]
[[#1 | Attach:immagine con spazi.jpeg]]
Per elencare i file allegati a una pagina, bisogna usare il markup:
(:attachlist:)
?
Questo genera una lista dei file allegati al gruppo o alla pagina corrente, a seconda di come è configurato PmWiki. Ogni elemento della lista contiene un link al file allegato, per visualizzarlo o scaricarlo. Una lista degli allegati si trova anche nella pagina per caricare file.
È possibile andare direttamente alla pagina di caricamento cliccando su ‘Attach’ in cima alla pagina. Per sovrascrivere un file è sufficiente ri-caricare un file con lo stesso nome. È importante cancellare la cache del browser dopo aver rimpiazzato un allegato. Altrimenti, potrebbe sembrare che il file vecchio si trova ancora al suo posto.