Sync with ikiwiki 3.20100926.HEADmasterikiwiki

1 files changed, 46 insertions, 0 deletions

diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..91adb5e
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,46 @@
+[[!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 ]]
+"""]]