From 82abc3dd421ef2dd9e4388c3e83ef262c3c93496 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:31 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki.mdwn | 17 ++++++ ikiwiki/directive.mdwn | 46 ++++++++++++++++ ikiwiki/formatting.mdwn | 109 ++++++++++++++++++++++++++++++++++++++ ikiwiki/markdown.mdwn | 13 +++++ ikiwiki/openid.mdwn | 29 ++++++++++ ikiwiki/pagespec.mdwn | 89 +++++++++++++++++++++++++++++++ ikiwiki/pagespec/attachment.mdwn | 39 ++++++++++++++ ikiwiki/pagespec/po.mdwn | 23 ++++++++ ikiwiki/searching.mdwn | 20 +++++++ ikiwiki/subpage.mdwn | 14 +++++ ikiwiki/subpage/linkingrules.mdwn | 37 +++++++++++++ ikiwiki/wikilink.mdwn | 32 +++++++++++ index.mdwn | 8 +++ recentchanges.mdwn | 7 +++ sandbox.mdwn | 33 ++++++++++++ shortcuts.mdwn | 84 +++++++++++++++++++++++++++++ templates.mdwn | 80 ++++++++++++++++++++++++++++ 17 files changed, 680 insertions(+) create mode 100644 ikiwiki.mdwn create mode 100644 ikiwiki/directive.mdwn create mode 100644 ikiwiki/formatting.mdwn create mode 100644 ikiwiki/markdown.mdwn create mode 100644 ikiwiki/openid.mdwn create mode 100644 ikiwiki/pagespec.mdwn create mode 100644 ikiwiki/pagespec/attachment.mdwn create mode 100644 ikiwiki/pagespec/po.mdwn create mode 100644 ikiwiki/searching.mdwn create mode 100644 ikiwiki/subpage.mdwn create mode 100644 ikiwiki/subpage/linkingrules.mdwn create mode 100644 ikiwiki/wikilink.mdwn create mode 100644 index.mdwn create mode 100644 recentchanges.mdwn create mode 100644 sandbox.mdwn create mode 100644 shortcuts.mdwn create mode 100644 templates.mdwn diff --git a/ikiwiki.mdwn b/ikiwiki.mdwn new file mode 100644 index 0000000..26b937e --- /dev/null +++ b/ikiwiki.mdwn @@ -0,0 +1,17 @@ +[[!meta robots="noindex, follow"]] +Este wiki funciona con [ikiwiki](http://ikiwiki.info/). +[[!if test="enabled(version)" + then="(Versión actualmente en funcionamiento [[!version ]].)" +]] + +Alguna documentación sobre el uso de ikiwiki: + +* [[Aplicación de formato a las páginas|ikiwiki/formatting]] +* [[Enlaces Wiki («WikiLinks»)|ikiwiki/wikilink]] +* [[Subpáginas|ikiwiki/subpage]] +* [[Selección de páginas («PageSpec»)|ikiwiki/pagespec]] +* [[Directivas|ikiwiki/directive]] +* [[Lenguaje de marcado|ikiwiki/markdown]] +* [[ikiwiki/openid]] +* [[Búsqueda|ikiwiki/searching]] +* [[templates]] 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: <>, 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. diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..c2a9ee7 --- /dev/null +++ b/index.mdwn @@ -0,0 +1,8 @@ +Bienvenido a su nuevo wiki. + +Se supone que todos los wikis tienen una [[Zona_de_pruebas|SandBox]], así +que éste también la tiene. + +---- + +Este wiki funciona con [[ikiwiki]]. diff --git a/recentchanges.mdwn b/recentchanges.mdwn new file mode 100644 index 0000000..bda2786 --- /dev/null +++ b/recentchanges.mdwn @@ -0,0 +1,7 @@ +[[!if test="enabled(meta)" then=""" +[[!meta title="CambiosRecientes"]] +"""]] +Cambios recientes a este wiki: + +[[!inline pages="internal(recentchanges/change_*) and !*/Discussion" +template=recentchanges show=0]] diff --git a/sandbox.mdwn b/sandbox.mdwn new file mode 100644 index 0000000..7f3c3d4 --- /dev/null +++ b/sandbox.mdwn @@ -0,0 +1,33 @@ +Esta es la Zona de Pruebas («SandBox»), una página que cualquiera puede +editar para aprender a usar el wiki. + +---- + +Aquí podemos ver un párrafo. + +Aquí podemos ver otro con texto *resaltado*. + +# Título + +## Subtítulo + +> Esto es un bloque de cita. +> +> Éste es el primer nivel de citación. +> +> > Esto es un bloque de cita de nivel inferior. +> +> De vuelta al primer nivel. + +Lista numerada + +1. Primer elemento. +1. Otro. +1. Y otro ... + +Lista + +* *elemento* +* elemento + +[[ikiwiki/WikiLink]] diff --git a/shortcuts.mdwn b/shortcuts.mdwn new file mode 100644 index 0000000..8c221f9 --- /dev/null +++ b/shortcuts.mdwn @@ -0,0 +1,84 @@ +[[!if test="enabled(shortcut)" + then="Este wiki tiene los atajos **activados**." + else="Este wiki tiene los atajos **desactivados**."]] + +Algunos ejemplos de uso de los atajos incluyen: + + \[[!google foo]] + \[[!wikipedia War_of_1812]] + \[[!debbug 12345]] + Compruebe la \[[!cia ikiwiki desc="página de CIA para %s"]]. + +Esta página controla qué atajos de enlace se pueden hacer en el wiki. + +* [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]] +* [[!shortcut name=archive url="http://web.archive.org/*/%S"]] +* [[!shortcut name=gmap url="http://maps.google.com/maps?q=%s"]] +* [[!shortcut name=gmsg url="http://groups.google.com/groups?selm=%s"]] +* [[!shortcut name=wikipedia + url="https://secure.wikimedia.org/wikipedia/en/wiki/%s"]] +* [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]] +* [[!shortcut name=wiktionary + url="https://secure.wikimedia.org/wiktionary/en/wiki/%s"]] +* [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian bug + #%s"]] +* [[!shortcut name=deblist url="http://lists.debian.org/debian-%s" + desc="debian-%s@lists.debian.org"]] +* [[!shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]] +* [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[!shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]] +* [[!shortcut name=debrt + url="https://rt.debian.org/Ticket/Display.html?id=%s"]] +* [[!shortcut name=debss url="http://snapshot.debian.net/package/%s"]] + * Usage: `\[[!debss package]]`, `\[[!debss package#version]]`, or `\[[!debss package/version]]`. See http://snapshot.debian.net for details. +* [[!shortcut name=debwiki url="http://wiki.debian.org/%s"]] +* [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[!shortcut name=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]] +* [[!shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]] +* [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]] +* [[!shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]] +* [[!shortcut name=marcmsg url="http://marc.info/?i=%s"]] +* [[!shortcut name=marclist url="http://marc.info/?l=%s"]] +* [[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]] +* [[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]] +* [[!shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] +* [[!shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] +* [[!shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]] +* [[!shortcut name=iki url="http://ikiwiki.info/%S/"]] +* [[!shortcut name=ljuser url="http://%s.livejournal.com/"]] +* [[!shortcut name=rfc url="http://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]] +* [[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]] +* [[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]] +* [[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]] +* [[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]] +* [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]] +* [[!shortcut name=imdb url="http://imdb.com/find?q=%s"]] +* [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]] +* [[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]] +* [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]] +* [[!shortcut name=cve url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]] +* [[!shortcut name=cia url="http://cia.vc/stats/project/%s"]] +* [[!shortcut name=ciauser url="http://cia.vc/stats/user/%s"]] +* [[!shortcut name=flickr url="http://www.flickr.com/photos/%s"]] +* [[!shortcut name=man url="http://linux.die.net/man/%s"]] +* [[!shortcut name=ohloh url="http://www.ohloh.net/projects/%s"]] +* [[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]] +* [[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %s"]] + +Para añadir un nuevo atajo, utilice la [[directiva|ikiwiki/directive]] +`shortcut`. En el url, «%s» se reemplaza con el texto que se pasa al atajo +nombrado, después de codificarlo mediante el [[!wikipedia url_encoding]], y +«%S» se reemplaza con el texto en bruto, no codificado. El parámetro +opcional `desc` controla la descripción del enlace. + +Recuerde que el `name` («nombre») que le dé al atajo se convertirá en una +nueva [[directiva|ikiwiki/directive]]. Evite utilizar un `name` («nombre») +que choque con una directiva que ya exista. Estas directivas también aceptan +un parámetro `desc` que anulará la que se proporcione en la definición. + +Si se le ocurre un atajo que crea que puede ser útil para otros, considere +aportarlo a la [página de atajos en el wiki +ikiwiki](http://ikiwiki.info/shortcuts/), de tal modo que futuras versiones +de ikiwiki puedan incluir su atajo en la base estándar. diff --git a/templates.mdwn b/templates.mdwn new file mode 100644 index 0000000..ae4012b --- /dev/null +++ b/templates.mdwn @@ -0,0 +1,80 @@ +[[Ikiwiki]] uses many templates for many purposes. By editing its templates, +you can fully customise this site. + +Templates are located in `/usr/share/ikiwiki/templates` by default; the +`templatedir` setting can be used to make another directory be searched +first. Customised templates can also be placed inside the "templates/" +directory in your wiki's source. + +Ikiwiki uses the HTML::Template module as its template engine. This supports +things like conditionals and loops in templates and is pretty easy to +learn. All you really need to know to modify templates is this: + +* To insert the value of a template variable, use ``. +* To make a block of text conditional on a variable being set use `text`. +* To use one block of text if a variable is set and a second if it's not, + use `textother text` + +[[!if test="enabled(template)" then=""" +## template pages + +The [[!iki ikiwiki/directive/template desc="template directive"]] allows +wiki pages to be used as templates, filled out and inserted into other pages +in the wiki. +"""]] + +[[!if test="enabled(edittemplate)" then=""" +## default content for new pages + +The [[!iki ikiwiki/directive/edittemplate desc="edittemplate directive"]] +can be used to make new pages default to containing text from a template +page, which can be filled out as the page is edited. +"""]] + +[[!if test="(enabled(template) or enabled(edittemplate)) +and enabled(inline)" then=""" +[[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" +feeds=no archive=yes sort=title template=titlepage +rootpage=templates postformtext="Add a new template named:"]] +"""]] + +## wiki templates + +These templates are used to build the wiki. The aim is to keep almost all +html out of ikiwiki and in the templates. + +* `page.tmpl` - Used for displaying all regular wiki pages. This is the key + template to customise. [[!if test="enabled(pagetemplate)" then=""" + (The [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate directive"]] + can be used to make a page use a different template than `page.tmpl`.)"""]] +* `rsspage.tmpl` - Used for generating rss feeds for blogs. +* `rssitem.tmpl` - Used for generating individual items on rss feeds. +* `atompage.tmpl` - Used for generating atom feeds for blogs. +* `atomitem.tmpl` - Used for generating individual items on atom feeds. +* `inlinepage.tmpl` - Used for displaying a post in a blog. +* `archivepage.tmpl` - Used for listing a page in a blog archive page. +* `titlepage.tmpl` - Used for listing a page by title in a blog archive page. +* `microblog.tmpl` - Used for showing a microblogging post inline. +* `blogpost.tmpl` - Used for a form to add a post to a blog (and rss/atom links) +* `feedlink.tmpl` - Used to add rss/atom links if `blogpost.tmpl` is not used. +* `aggregatepost.tmpl` - Used by the aggregate plugin to create + a page for a post. +* `searchform.tmpl`, `googleform.tmpl` - Used by the search plugin + and google plugin to add search forms to wiki pages. +* `searchquery.tmpl` - This is a Omega template, used by the + search plugin. +* `comment.tmpl` - Used by the comments plugin to display a comment. +* `change.tmpl` - Used to create a page describing a change made to the wiki. +* `recentchanges.tmpl` - Used for listing a change on the RecentChanges page. +* `autoindex.tmpl` - Filled in by the autoindex plugin to make index pages. +* `autotag.tmpl` - Filled in by the tag plugin to make tag pages. +* `calendarmonth.tmpl`, `calendaryear.tmpl` - Used by ikiwiki-calendar to + make calendar archive pages. +* `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`, + `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`, + `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`, + `passwordmail.tmpl`, `openid-selector.tmpl` - Parts of ikiwiki's user + interface; do not normally need to be customised. + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3