<<TableOfContents: execution failed [list index out of range] (see also the log)>>
Questa macro è utilizzata per includere (incorporare) un oggetto in una pagina wiki (gli oggetti in questo caso sono elementi solitamente gestiti da plug-in) come Flash, PDF o filmati. La dimensione dell'oggetto può essere modificata se si desidera, mentre altri parametri dipendono dal tipo dell'applicazione.
Se l'allegato non è stato ancora caricato, verrà mostrata la riga per caricarlo.
Nuovo in 1.6: MoinMoin ha una nuova sintassi (per alcuni tipi di allegati sperimentali) di inclusione come: {{target|desc|params}}.
Abilitare EmbedObject
EmbedObject è un macro standard inclusa in moin. Ma, per motivi di sicurezza, i tipi mime devono essere esplicitamente abilitati nel proprio file wikiconfig.py per poter sfruttare EmbedObject.
Nel file wikiconfig.py, nella sezione "Content options", aggiungere le seguenti righe:
mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', 'application/xhtml+xml',] mimetypes_embed = ['application/x-dvi', 'application/postscript', 'application/pdf', 'application/ogg', 'application/vnd.visio', 'image/x-ms-bmp', 'image/svg+xml', 'image/tiff', 'image/x-photoshop', 'audio/mpeg', 'audio/midi', 'audio/x-wav', 'video/fli', 'video/mpeg', 'video/quicktime', 'video/x-msvideo', 'chemical/x-pdb', 'x-world/x-vrml',]
È utile aggiungere o rimuovere specifici tipi mime da mimetypes_embed tenendo solo quelli strettamente necessari all'interno del proprio sito. Per esempio, se è necessario Flash, spostare 'application/x-shockwave-flash' da mimetypes_xss_protect a mimetypes_embed.
Consultare: HelpOnConfiguration
Tipi MIME supoprtati:
- application/x-shockwave-flash
- application/x-dvi
- application/postscript
- application/pdf
- application/ogg
- application/vnd.visio
- image/x-ms-bmp
- image/svg+xml
- image/tiff
- image/x-photoshop
- audio/mpeg
- audio/midi
- audio/x-wav
- video/fli
- video/mpeg
- video/quicktime
- video/x-msvideo
- chemical/x-pdb
- x-world/x-vrml
Sintassi e uso
<<EmbedObject(attachment[,opzione][,opzione])>>
Parametri:
In base alla classe del tipo mime possono essere usati dei parametri diversi da quelli predefiniti:
width = None, float height = None, float pagename = None, unicode align = middle alt = '' play = False loop = False quality = high op = True repeat = False autostart = False menu = True hidden = False
Tutti i tipi mime supportano i parametri "width" e "height".
Dalla versione 1.7 MoinMoin supporta anche l'utilizzo delle unità. Le unità accettate per i parametri "width" e "height" sono px, em, pt, in, mm e %.
Se non viene fornita un'unità, quella predefinita è px.
Inoltre:
'video' supporta repeat, autostart, menu, op
'audio' supporta play, repeat, autostart, op, hidden
- il valore di "width" predefinito è 60 e quello per "height" è 20
'application' supporta play, menu, autostart
Esempi
Esempi di base:
<<EmbedObject(example.swf)>> <<EmbedObject(example.pdf)>> <<EmbedObject(example.svg)>>
Esempi più complessi:
<<EmbedObject(testpdf.pdf,width=100%,height=600px)>> <<EmbedObject(example.swf,width=637px,height=392px,play=true,loop=true)>>