summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
blob: 91adb5e569222a418d643478359883485e29bc3e (plain)

[[!meta robots="noindex, follow"]] Las directivas tienen una forma similar a un [[ikiwiki/WikiLink]], pero empiezan con ! y pueden contener parámetros. La forma general es:

\[[!directive param="value" param="value"]]

Esto se expande antes de que el resto de la página sea procesada, y puede utilizarse para transformar la página de diferentes maneras.

Se pueden omitir las comillas en torno a un valor si éste consiste en una sola palabra. Además, algunas directivas pueden usar parámetros sin valores, como por ejemplo:

\[[!tag foo]]

No es necesario que una directiva ocupe una sola línea, si lo desea puede ocupar varias líneas:

\[[!directive foo="baldersnatch"
bar="supercalifragilisticexpialidocious" baz=11]]

Además, se pueden usar múltiples líneas de texto entrecomillado como valor. Para que se permitan las comillas dentro del texto citado, delimite el bloque de texto con comillas triples:

\[[!directive text="""
1. "foo"
2. "bar"
3. "baz"
"""]]

ikiwiki tiene además una sintaxis más antigua para las directivas, que requiere un espacio en las directivas para distinguirlas de los [[wikilinks|ikiwiki/wikilink]]. Esta sintaxis tiene varias desventajas: requiere un espacio después de las directivas sin parámetros (tales como \[[pagecount ]]), y prohíbe espacios en los [[wikilinks|ikiwiki/wikilink]]. ikiwiki proporciona ahora de manera predeterminada la sintaxis que utiliza el prefijo ! mostrada arriba. Sin embargo, ikiwiki todavía es compatible con los wikis que utilizan la antigua sintaxis, si se desactiva la opción prefix_directives.

[[!if test="enabled(listdirectives)" then=""" Ésta es una lista de las directivas actualmente disponibles en este wiki:

[[!listdirectives ]] """]]