diff options
author | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:31 +0200 |
---|---|---|
committer | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:31 +0200 |
commit | 82abc3dd421ef2dd9e4388c3e83ef262c3c93496 (patch) | |
tree | bdac59d518d036dce535c61a28c6f9307f7a2164 /ikiwiki |
Diffstat (limited to 'ikiwiki')
-rw-r--r-- | ikiwiki/directive.mdwn | 46 | ||||
-rw-r--r-- | ikiwiki/formatting.mdwn | 109 | ||||
-rw-r--r-- | ikiwiki/markdown.mdwn | 13 | ||||
-rw-r--r-- | ikiwiki/openid.mdwn | 29 | ||||
-rw-r--r-- | ikiwiki/pagespec.mdwn | 89 | ||||
-rw-r--r-- | ikiwiki/pagespec/attachment.mdwn | 39 | ||||
-rw-r--r-- | ikiwiki/pagespec/po.mdwn | 23 | ||||
-rw-r--r-- | ikiwiki/searching.mdwn | 20 | ||||
-rw-r--r-- | ikiwiki/subpage.mdwn | 14 | ||||
-rw-r--r-- | ikiwiki/subpage/linkingrules.mdwn | 37 | ||||
-rw-r--r-- | ikiwiki/wikilink.mdwn | 32 |
11 files changed, 451 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 ]] +"""]] diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn new file mode 100644 index 0000000..7c64c1d --- /dev/null +++ b/ikiwiki/formatting.mdwn @@ -0,0 +1,109 @@ +[[!meta title="Aplicación de formato a las páginas wiki"]] +[[!meta robots="noindex, follow"]] + +El texto de este wiki está escrito, de manera predeterminada, en una forma +muy parecida a cómo se escribe texto para un mensaje de correo +electrónico. Este estilo de asignación de formato al texto se llama +[[MarkDown]] y funciona así: + +Deje líneas vacías entre párrafos. + +Puede *\*resaltar*\* o **\*\*resaltar fuertemente\*\*** el texto colocándolo +entre asteriscos simples o dobles. + +Para crear una lista, inicie cada línea con un asterisco: + +* "* Ésta es mi lista" +* "* Otro elemento" + +Para hacer una lista numerada, inicie cada línea con un número (cualquier +número servirá) seguido de un punto: + +1. "1. Primera línea" +2. "2. Segunda línea" +2. "2. Tercera línea" + +Para crear un título, inicie una línea con uno o más caracteres `#` seguidos +de un espacio y el texto del título. El número de caracteres `#` controla el +tamaño del título: + +# # h1 +## ## h2 +### ### h3 +#### #### h4 +##### ##### h5 +###### ###### h6 + +Para crear una línea horizontal, simplemente escriba tres o más guiones o +estrellas en su propia línea: + +---- + +Para citar a alguien, ponga delante de la cita ">": + +> Ser o no ser, +> ésa es la cuestión. + +Para escribir un bloque de código, sangre cada línea con una tabulación o +con 4 espacios: + + 10 PRINT "Hola mundo!" + 20 GOTO 10 + +Para enlazar a un url o a una dirección de correo electrónico, puede poner simplemente el +url entre paréntesis angulares: <<http://ikiwiki.info>>, o puede usar la +forma \[link text\]\(url\) + +---- + +Además de la aplicación de formato html básico utilizando [[MarkDown]], este +wiki le permite usar las siguientes características adicionales: + +* Para enlazar a otra página del wiki, coloque el nombre de la página entre + dobles corchetes. Así, puede utilizar `\[[WikiLink]]` para enlazar a + [[WikiLink]]. + +[[!if test="enabled(smiley) and smileys" then=""" +* Inserte [[smileys]] y algunos otros símbolos útiles. :-) +"""]] + +[[!if test="enabled(shortcut) and shortcuts" then=""" +* Use [[atajos|shortcuts]] para enlazar a recursos comunes. + + \[[!wikipedia War\_of\_1812]] +"""]] + +[[!if test="enabled(template) and templates" then=""" +* Cree y rellene [[plantillas|templates]] para bloques repetidos de texto + wiki con parámetros. +"""]] + +* Inserte varias [[directivas|directive]] en una página para realizar + acciones útiles. +[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then=""" + Por ejemplo, puede: +"""]] + +[[!if test="enabled(toc)" then=""" + * Añadir una tabla de contenidos a una página: + + \[[!toc]] +"""]] + + +[[!if test="enabled(meta)" then=""" + * Cambiar el título de una página: + + \[[!meta title="full page title"]] +"""]] + +[[!if test="enabled(inline)" then=""" + * Crear un blog insertando un conjunto de páginas en otra: + + \[[!inline pages="blog/*"]] +"""]] + +[[!if test="enabled(listdirectives)" then=""" + Lista completa de [[directivas|directive]] activadas en este wiki: + [[!listdirectives ]] +"""]] diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn new file mode 100644 index 0000000..b5d1ea5 --- /dev/null +++ b/ikiwiki/markdown.mdwn @@ -0,0 +1,13 @@ +[[!meta robots="noindex, follow"]] +[Markdown](http://daringfireball.net/projects/markdown/) es un lenguaje +mínimo de marcado que se parece al texto plano utilizado en los mensajes de +correo electrónico. Es el lenguaje de marcado utilizado en este wiki de +manera predeterminada. + +Si desea consultar documentación sobre la sintaxis de markdown, vea +[[Aplicación_de_formato|formatting]] y [Markdown: +syntax](http://daringfireball.net/projects/markdown/syntax). + +Tenga en cuenta que los [[WikiLinks|WikiLink]] y las +[[directivas|directive]] no son parte de la sintaxis de markdown, y son los +únicos elementos de marcado que este wiki maneja internamente. diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn new file mode 100644 index 0000000..192f47f --- /dev/null +++ b/ikiwiki/openid.mdwn @@ -0,0 +1,29 @@ +[[!meta title="OpenID"]] +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(openid)" + then="Este wiki tiene OpenID **activado**." + else="Este wiki tiene OpenID **desactivado**."]] + +[OpenID](http://openid.net) es un mecanismo descentralizado de +identificación que le permite tener un acceso («login») que puede usar en un +número creciente de sitios web. + +If you have an account with some of the larger web service providers, you +might already have an OpenID. [Directory of OpenID +providers](http://openiddirectory.com/openid-providers-c-1.html) + +[[!if test="enabled(openid)" then=""" +Para identificarse en este wiki usando OpenID, simplemente introdúzcalo en +el Campo OpenID del formulario de identificación. Si usa OpenID, no es +necesario que proporcione ninguna contraseña a este wiki, ni que realice +ningún proceso de registro. +"""]] + +--- + +También es posible hacer una página del wiki utilizable como un url OpenID, +asignándolo a un servidor openid. Éste es un ejemplo de cómo hacerlo: + + \[[!meta openid="http://yourid.myopenid.com/" + server="http://www.myopenid.com/server"]] diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn new file mode 100644 index 0000000..83648aa --- /dev/null +++ b/ikiwiki/pagespec.mdwn @@ -0,0 +1,89 @@ +[[!meta robots="noindex, follow"]] +Para seleccionar un conjunto de páginas, como páginas que están bloqueadas, +páginas a cuyo envío de correo electrónico quiere suscribirse, o páginas +para combinar en un blog, el wiki utiliza una PageSpec. Ésta consiste en una +expresión que se corresponde con un conjunto de páginas. + +La PageSpec más simple es una lista simple de páginas. Por ejemplo, ésta se +corresponde con cualquiera de las tres páginas listadas: + + foo or bar or baz + +A menudo querrá seleccionar cualquier página que tenga alguna particularidad +en su nombre. Puede hacerlo utilizando un patrón «glob». "`*`" representa +cualquier parte del nombre de una página, y "`?`" cualquier letra del nombre +de una página. Así, esto se corresponde con todas las páginas sobre música, +y cualquier [[subpágina|SubPage]] de la [[zona de pruebas +(«SandBox»)|SandBox]], pero no con la zona de pruebas («SandBox») misma: + + *music* or SandBox/* + +También puede utilizar "`!`" delante de un elemento para que no se incluyan +las páginas que se correspondan con ese elemento. Así, para seleccionar +todas las páginas excepto las de Discusión y la Zona de pruebas («SandBox»): + + * and !SandBox and !*/Discussion + +Se pueden añadir límites más elaborados para seleccionar páginas utilizando +estas funciones: + +* "`glob(someglob)`" - matches pages and other files that match the given glob. + Just writing the glob by itself is actually a shorthand for this function. +* "`page(glob)`" - like `glob()`, but only matches pages, not other files +* "`link(page)`" - matches only pages that link to a given page (or glob) +* "`tagged(tag)`" - matches pages that are tagged or link to the given tag (or + tags matched by a glob) +* "`backlink(page)`" - matches only pages that a given page links to +* "`creation_month(month)`" - matches only files created on the given month +* "`creation_day(mday)`" - or day of the month +* "`creation_year(year)`" - or year +* "`created_after(page)`" - matches only files created after the given page + was created +* "`created_before(page)`" - matches only files created before the given page + was created +* "`internal(glob)`" - like `glob()`, but matches even internal-use + pages that globs do not usually match. +* "`title(glob)`", "`author(glob)`", "`authorurl(glob)`", + "`license(glob)`", "`copyright(glob)`", "`guid(glob)`" + - match pages that have the given metadata, matching the specified glob. +* "`user(username)`" - tests whether a modification is being made by a + user with the specified username. If openid is enabled, an openid can also + be put here. Glob patterns can be used in the username. For example, + to match all openid users, use `user(*://*)` +* "`admin()`" - tests whether a modification is being made by one of the + wiki admins. +* "`ip(address)`" - tests whether a modification is being made from the + specified IP address. +* "`comment(glob)`" - matches comments to a page matching the glob. +* "`comment_pending(glob)`" - matches unmoderated, pending comments. +* "`postcomment(glob)`" - matches only when comments are being + posted to a page matching the specified glob + +Por ejemplo, para seleccionar todas las páginas de un blog que enlazan a la +página sobre música y que fueron escritas en 2005: + + blog/* and link(música) and creation_year(2005) + +Fíjese en el uso de "and" en el ejemplo anterior, que significa que sólo son +seleccionadas las páginas que se corresponden con cada una de las tres +expresiones. Utilice "and" cuando quiera combinar una expresión como ésa; +utilice "or" cuando sea suficiente que una página se corresponda con una de +las expresiones. Fíjese en que no tiene sentido decir "index and SandBox", +puesto que ninguna página puede corresponderse con ambas expresiones. + +También se pueden crear expresiones más complejas, utilizando paréntesis +para agruparlas. Por ejemplo, para seleccionar páginas de un blog que están +etiquetadas con alguna de dos etiquetas, utilice: + + blog/* and (tagged(foo) or tagged(bar)) + +Tenga en cuenta que los nombres de página en las PageSpecs se seleccionan +según los nombre de archivo absolutos de las páginas del wiki, de tal modo +que una «pagespec» "foo" utilizada en la página "a/b" no seleccionará una +página llamada "a/foo" o "a/b/foo". Para seleccionar de manera relativa al +directorio de la página que contiene la «pagespec», puede utilizar "./". Por +ejemplo, "./foo" en la página "a/b" selecciona la página "a/foo". + +To indicate the name of the page the PageSpec is used in, you can use a +single dot. For example, `link(.)` matches all the pages linking to the page +containing the PageSpec. diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn new file mode 100644 index 0000000..6333929 --- /dev/null +++ b/ikiwiki/pagespec/attachment.mdwn @@ -0,0 +1,39 @@ +[[!meta robots="noindex, follow"]] +[[!if test="enabled(attachment)" + then="Este wiki tiene los archivos adjuntos **activados**." + else="Este wiki tiene los archivos adjuntos **desactivados**."]] + +Si los archivos adjuntos están activados, el administrador del wiki puede +controlar qué tipos de archivos adjuntos serán aceptados a través de la +opción de configuración `allowed_attachments`. + +For example, to limit most users to uploading small images, and nothing +else, while allowing larger mp3 files to be uploaded by joey into a specific +directory, and check all attachments for viruses, something like this could +be used: + + virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (mimetype(image/*) and maxsize(50kb))) + +La sintaxis normal de [[ikiwiki/PageSpec]] se amplía con las comprobaciones +adicionales siguientes: + +* "`maxsize(tamaño)`" - comprueba que el archivo adjunto no sea más grande + que el tamaño especificado. De manera predeterminada el tamaño se expresa + en bytes, pero se puede utilizar «kb», «mb», «gb», etc., para especificar + las unidades. + +* "`minsize(tamaño)`" - comprueba que el archivo adjunto no sea más pequeño + que el tamaño especificado. + +* "`ispage()`" - comprueba si el archivo adjunto será tratado por ikiwiki + como una página wiki. (Es decir, si tiene una extensión ".mdwn", o la de + cualquier otro formato de página activado). + + Así, si no quiere permitir que se envíen páginas wiki como archivos adjuntos, + utilice `!ispage()` ; si sólo quiere permitir el envío de páginas wiki como + archivos adjuntos, utilice `ispage()`. + +* "`mimetype(foo/bar)`" - comprueba el tipo MIME del archivo adjunto. Puede + incluir un «glob» en el tipo, por ejemplo `mimetype(image/*)`. + +* "`virusfree()`" - comprueba el archivo adjunto con un programa antivirus. diff --git a/ikiwiki/pagespec/po.mdwn b/ikiwiki/pagespec/po.mdwn new file mode 100644 index 0000000..12b584a --- /dev/null +++ b/ikiwiki/pagespec/po.mdwn @@ -0,0 +1,23 @@ +[[!if test="enabled(po)" + then="Este wiki tiene **activada** la compatibilidad con po." + else="Este wiki tiene **desactivada** la compatibilidad con po."]] + +Si el complemento («plugin») [[!iki plugins/po desc=po]] está activado, la +sintaxis normal de [[ikiwiki/PageSpec]] se amplía con las comprobaciones +adicionales siguientes, que se pueden utilizar para mejorar la navegación +del usuario en un wiki multilingüe: + +* "`lang(LL)`" - comprueba si una página está escrita en el idioma + especificado según el código ISO639-1 (dos letras). +* "`currentlang()`" - comprueba si una página está escrita en el mismo + idioma que la página actual. +* "`needstranslation()`" - tests whether a page needs translation work. Only + slave pages match this PageSpec. A minimum target translation percentage + can optionally be passed as an integer parameter: "`needstranslation(50)`" + matches only pages less than 50% translated. + +Tenga en cuenta que se considera que cualquier página que no sea de tipo +«po» está escrita en `po_master_language`, según se especifica en +`ikiwiki.setup`. + +[[!meta robots="noindex, follow"]] diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn new file mode 100644 index 0000000..6f4a894 --- /dev/null +++ b/ikiwiki/searching.mdwn @@ -0,0 +1,20 @@ +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(search)" +then="Este wiki tiene la búsqueda **habilitada**." +else="Este wiki tiene la búsqueda **deshabilitada**."]] + +Si la búsqueda está habilitada, puede introducir el texto a buscar en el +campo de búsqueda, tal y como cabría esperar. Hay además algunas reglas que +puede usar para construir búsquedas más sofisticadas. + +* Para buscar una frase exacta, pongala entre comillas dobles. +* `AND` se puede usar para buscar documentos que contengan dos expresiones. +* `OR` se puede usar para buscar documentos que contengan cualquiera de las + dos expresiones. +* Los paréntesis se pueden usar para construir expresiones de búsqueda más + complicadas. Por ejemplo, "(foo AND bar) OR (me AND you)" +* Ponga "-" antes de un término de búsqueda para evitar que aparezca en los + resultados. Por ejemplo, "-discussion" omitirá "discussion". +* Para buscar una página con un determinado título, use "title:foo". +* Para buscar páginas que contengan un enlace a "bar", use "link:bar". diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn new file mode 100644 index 0000000..ef17788 --- /dev/null +++ b/ikiwiki/subpage.mdwn @@ -0,0 +1,14 @@ +[[!meta robots="noindex, follow"]] +ikiwiki permite colocar páginas en una jerarquía de directorios. Por +ejemplo, bajo esta página, [[SubPage]] («subpágina»), hay algunas páginas +relacionadas, como [[SubPage/LinkingRules]]. Ésta es una manera práctica de +poner un poco de orden en el wiki, en lugar de tener simplemente un gran +directorio lleno de páginas. + +To add a SubPage, just make a subdirectory and put pages in it. For example, +this page is subpage.mdwn in this wiki's source, and there is also a subpage +subdirectory, which contains subpage/linkingrules.mdwn. Subpages can be +nested as deeply as you'd like. + +La creación de un enlace a y desde una subpágina se explica en +[[LinkingRules]] (Reglas para la creación de enlaces). diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn new file mode 100644 index 0000000..4dca81c --- /dev/null +++ b/ikiwiki/subpage/linkingrules.mdwn @@ -0,0 +1,37 @@ +[[!meta robots="noindex, follow"]] +Para crear un enlace a o desde una [[subpágina|SubPage]], usualmente puede +usar un [[WikiLink]] normal que no contenga el nombre del directorio +superior de la [[subpágina|SubPage]]. Ikiwiki desciende por la jerarquía de +directorios buscando una página que se corresponda con su enlace. + +Por ejemplo, si «FooBar/SubPagina» enlaza a «OtraPagina», ikiwiki preferirá +primero dirigir el enlace a «FooBar/SubPagina/OtraPagina» si existe, a +continuación a «FooBar/OtraPagina», y finalmente a «OtraPagina» en el +directorio raíz del wiki. + +Tenga en cuenta que esto significa que si un enlace en «FooBar/AlgunaPagina» +a «OtraPagina» enlaza actualmente a «OtraPagina» en el directorio raíz del +wiki, y se crea «FooBar/OtraPagina», el enlace _cambiará_ para dirigir a +«FooBar/OtraPagina». Por otra parte, un enlace desde «BazBar» a «OtraPagina» +no cambiará por esta creación de una [[subpágina|SubPage]] de «FooBar». + +También puede especificar un enlace que contenga un nombre de directorio, +como «FooBar/OtraPagina» para especificar con más exactitud a qué página +enlazar. Ésta es la única manera de enlazar a una [[subpágina|SubPage]] no +relacionada. + +Puede utilizar esto, por ejemplo, para enlazar desde «BazBar» a +«FooBar/SubPagina», o desde «BazBar/SubPagina» a «FooBar/SubPagina». + +También puede utilizar «/» al principio de un enlace, para especificar +exactamente a qué página enlazar, cuando existen múltiples páginas con +nombres similares y el enlace conduce a la página equivocada de manera +predeterminada. Por ejemplo, crear un enlace desde «FooBar/SubPagina» a +«/OtraPagina» conducirá a la «OtraPagina» del directorio raíz del wiki, +incluso aunque haya una «FooBar/OtraPagina». + +Además, si el wiki está configurado con un directorio «userdir», puede +enlazar a páginas dentro del «userdir» sin especificar una ruta hasta +ellas. Esto ocurre para permitir la creación sencilla de enlaces a la página +de un usuario en el «userdir», para firmar un comentario. Estos enlaces se +comprueban en último lugar. diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn new file mode 100644 index 0000000..d746971 --- /dev/null +++ b/ikiwiki/wikilink.mdwn @@ -0,0 +1,32 @@ +[[!meta robots="noindex, follow"]] +Los WikiLinks proporcionan enlaces fáciles entre páginas del wiki. Para +crear un [[WikiLink]], ponga simplemente el nombre de la página a enlazar +entre corchetes dobles. Por ejemplo, `\[[WikiLink]]`. + +Si necesita crea algo como `\[[WikiLink]]` sin crear un link wiki, +simplemente añada `\` como prefijo, de la siguiente manera: +`\\[[WikiLink]]`. + +Hay algunas [[Reglas para la creación de enlaces|SubPage/LinkingRules]] +especiales que entran en juego al enlazar [[Subpáginas|SubPage]]. + +Los WikiLinks se corresponden con nombres de página sin tener en cuenta si +se usan letras mayúsculas o minúsculas, así que no tiene que preocuparse por +esto, y puede por ejemplo utilizar mayúsculas en un enlace si se encuentra +al principio de una frase. + +También es posible escribir un WikiLink que use otra cosa en lugar del +nombre de la página como texto del enlace. Por ejemplo +`\[[foo_bar|SandBox]]` enlaza a la página de la zona de pruebas («SandBox»), +pero el enlace aparece así: [[foo_bar|SandBox]]. + +Para enlazar a un punto («anchor») dentro de una página, puede utilizar algo +como `\[[WikiLink#foo]]` . + +If the file linked to by a WikiLink looks like an image, it will be +displayed inline on the page. + +--- + +You can also put an url in a WikiLink, to link to an external page. Email +addresses can also be used to generate a mailto link. |