====== Sintaxis de formato ====== [[wiki:DokuWiki]] usa una variante sencilla del lenguaje de marcas con el objetivo de facilitar al máximo la lectura de los archivos. Este artículo contiene toda la sintaxis que puedas llegar a necesitar cuando edites páginas. Puedes echarle una ojeada al código fuente de este artículo clicando en el botón //Editar// en la parte inferior del mismo. Si estás dando tus primeros pasos y deseas probar algo, puedes hacerlo en el [[playground:playground|playground]]. El marcado más simple también es accesible mediante [[https://www.dokuwiki.org/toolbar|toolbar]]. ===== Formato básico de texto ===== DokuWiki permite el uso de **negrita**, //cursiva//, __subrayado__ y ''monoespaciado''. Por supuesto, también puedes **__//''combinarlos''//__**. DokuWiki permite el uso de **negrita**, //cursiva//, __subrayado__ y ''monoespaciado''. Por supuesto, también puedes **__//''combinarlos''//__**. Puedes usar subíndice y superíndice. Puedes usar subíndice y superíndice. Puedes señalar algo como borrado. Puedes señalar algo como borrado. Los **párrafos** se crean a partir de líneas en blanco. Si deseas **forzar una nueva línea** sin un párrafo, usa dos barras invertidas seguidas por un espacio en blanco o un carácter 'fin de línea'. Este es un texto en líneas separadas\\ Observa cómo las dos barras invertidas sólo se tienen en cuenta al final de la línea\\ o seguidas por\\ un espacio en blanco \\esto es lo que ocurre sin el espacio en blanco. Este es un texto en líneas separadas\\ Observa cómo las dos barras invertidas sólo se tienen en cuenta al final de la línea\\ o seguidas por\\ un espacio en blanco \\esto es lo que ocurre sin el espacio en blanco. Sólo deberías forzar nuevas líneas si es imprescindible. ===== Enlaces ===== Puedes crear enlaces en DokuWiki de diversas maneras. ==== Externos ==== Los enlaces externos son detectados automáticamente: http://dead-code.org o simplemente www.dead-code.org. También puedes especificar el nombre del enlace: [[http://dead-code.org|Este enlace señala a WME]]. Las direcciones de correo electrónico como ésta: también son detectadas. Puedes crear enlaces en DokuWiki de diversas maneras. Los enlaces externos son detectados automáticamente: http://dead-code.org o simplemente www.dead-code.org. También puedes especificar el nombre del enlace: [[http://dead-code.org|Este enlace señala a WME]]. Las direcciones de correo electrónico como ésta: también son detectadas. ==== Internos ==== Los enlaces internos se crean mediante el uso de corchetes. Puedes usar un [[https://www.dokuwiki.org/es:pagename|nombre de página]] o añadirle también un [[https://www.dokuwiki.org/es:pagename|Título de texto]]. Los nombres de página Wiki pasan automáticamente a minúsculas. No se permite el uso de caracteres especiales. Los enlaces internos se crean mediante el uso de corchetes. Puedes usar un [[doku>wiki:nombre de página]] o añadirle también un [[doku>wiki:nombre de página|Título de texto]]. Los nombres de página Wiki pasan automáticamente a minúsculas. No se permite el uso de caracteres especiales. Para crear un [[https://www.dokuwiki.org/es:pagename|espacio de nombres]], escribe dos puntos seguidos del nombre de la página. Para crear un [[wiki:espacio de nombres]], escribe dos puntos seguidos del nombre de la página. Para más detalles sobre los espacios de nombres: [[https://www.dokuwiki.org/es:namespaces|espacios de nombres]]. También es posible crear un enlace a una sección determinada. Simplemente escribe el nombre de la sección precedido del carácter almohadilla, cómo se conoce en HTML. Esto enlaza a [[syntax#internos|esta Sección]]. Esto enlaza a [[syntax#internos|esta Sección]] Notas: * Los enlaces a [[wiki:syntax|páginas existentes]] se muestran usando un estilo distinto de los [[wiki:no existentes]]. * DokuWiki no usa [[wp>CamelCase]] para crear automáticamente enlaces por defecto, pero esta opción se puede activar en el archivo [[https://www.dokuwiki.org/es:config|config]]. Pista: Si DokuWiki es un enlace, eso significa que está activada. * Cuando se modifica la cabecera de la sección, la marca de la página (o bookmark, en inglés) también cambia. Por lo que no cuentes demasiado con crear enlaces a las distintas secciones. ==== Interwiki ==== DokuWiki permite el uso de enlaces [[https://www.dokuwiki.org/es:interwiki|Interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo, este es un enlace a una página de Wikipedia sobre Wikis: [[wp>Wiki]]. DokuWiki permite el uso de enlaces [[doku>wiki:interwiki|Interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo, este es un enlace a una página de Wikipedia sobre Wikis: [[wp>Wiki]]. ==== Recursos compartidos de Windows ==== Los recursos compartidos de Windows como [[\\server\share|éste]] también se detectan automáticamente. Observa que estos sólo tienen sentido en el contexto de un grupo de usuarios homogéneo tal como una [[wp>Intranet]] corporativa. Los recursos compartidos de Windows como [[\\server\share|éste]] también se detectan automáticamente. Notas: * Por motivos de seguridad la navegación directa por recursos compartidos sólo funciona en Microsoft Internet Explorer por defecto (y sólo en la "zona local"). * Para Mozilla y Firefox puede ser habilitada mediante la opción de configuración [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] pero no se recomienda. * Consulta [[http://bugs.dokuwiki.org/index.php?do=details&task_id=151|151]] para más información. ==== Enlaces de imagen ==== También puedes usar una imagen como enlace a otra página interna o externa, combinando la sintaxis para enlaces y [[#imagenes_y_otros_archivos|imágenes]] (ver abajo) de la siguiente manera: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Ten en cuenta: El formato de imágenes es la única sintaxis aceptada en nombres de enlace. Se permite el uso tanto de la sintaxis de [[#imagenes_y_otros_archivos|imágenes]] como la de [[#enlaces|enlaces]] (incluyendo la modificación del tamaño de la imagen, imágenes internas y externas y URLs, y enlaces interwiki). ===== Notas a pie de página ===== Puedes añadir notas a pie de página ((Esta es una nota a pie de página)) mediante el uso de dobles paréntesis. Puedes añadir notas a pie de página ((Esta es una nota a pie de página)) mediante el uso de dobles paréntesis. ===== Dividir en secciones ===== Puedes usar hasta cinco niveles distintos de encabezado para estructurar tu contenido. Si tienes más de tres cabeceras, se generará una tabla de contenidos automáticamente -- se puede desactivar esta opción añadiéndole al documento la cadena de carácteres: ''~~NOTOC~~'' ==== Nivel de cabecera 3 ==== === Nivel del cabecera 4 === == Nivel de cabecera 5 == ==== Nivel de cabecera 3 ==== === Nivel del cabecera 4 === == Nivel de cabecera 5 == Al encadenar cuatro guiones o más, crearás una línea horizontal: ---- De esta manera: ---- ===== Imágenes y otros archivos ===== Se pueden incluir [[https://www.dokuwiki.org/images|imágenes]] externas o internas mediante el uso de llaves. De forma opcional se puede especificar su tamaño. Tamaño real: {{wiki:dokuwiki-128.png}} Modificación de la anchura: {{wiki:dokuwiki-128.png?50}} Modificación de la anchura y la altura: {{wiki:dokuwiki-128.png?200x50}} Imagen externa cuyo tamaño ha sido modificado: {{http://www.dead-code.org/forum/Smileys/default/wave.gif?200x50}} Tamaño real: {{wiki:dokuwiki-128.png}} Modificación de la anchura: {{wiki:dokuwiki-128.png?50}} Modificación de la anchura y la altura: {{wiki:dokuwiki-128.png?200x50}} Imagen externa cuyo tamaño ha sido modificado: {{http://www.dead-code.org/forum/Smileys/default/wave.gif?200x50}} Para indicar la alineación, añade espacios en blanco a la izquierda o a la derecha. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} Por supuesto, también puedes darle un título (que será mostrado como descripción emergente por la mayoría de los navegadores de internet). {{ wiki:dokuwiki-128.png |Ésta es una descripción emergente}} {{ wiki:dokuwiki-128.png |Ésta es una descripción emergente}} Si especificas un nombre de archivo (externo o interno) que no sea una imagen (''gif, jpeg, png''), éste será mostrado como enlace. Para enlazar una imagen con otra página ver [[#Enlaces de imagen]] arriba. ===== Listas ===== Dokuwiki permite el uso de listas ordenadas y desordenadas. Para crear un artículo de la lista, ponle sangría de dos espacios a tu texto y usa un ''*'' para listas desordenadas o un ''-'' para las ordenadas. * Ésta es una lista * El segundo artículo * Puede tener diferentes niveles * Otro artículo - La misma lista pero ordenada - Otro artículo - Usa sangría para niveles más profundos - Ya está * Ésta es una lista * El segundo artículo * Puede tener diferentes niveles * Otro artículo - La misma lista pero ordenada - Otro artículo - Usa sangría para niveles más profundos - Ya está ===== Smileys ===== DokuWiki convierte [[wp>emoticon|emoticones]] comunmente usados a sus equivalentes gráficos. Se pueden añadir más smileys al directorio ''smiley'' y configurarlos en el archivo ''conf/smileys.conf''. Aquí tienes una lista de los Smileys incluidos en DokuWiki. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ===== Tipografía ===== [[https://www.dokuwiki.org/es:wiki:dokuwiki|DokuWiki]] puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensó 'No debo girarme, ¿y si hubiera detrás un mono de tres cabezas?'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensó 'No debo girarme, ¿y si hubiera detrás un mono de tres cabezas?'..." Ten en cuenta: La conversión automática se puede desactivar en las opciones de configuración. ===== Citas ===== A veces, se puede querer indicar que cierto texto es una respuesta o un comentario. Aquí tienes la sintaxis para ello: Creo que deberíamos hacerlo > No, no deberíamos >> Bueno, pues yo digo que sí > ¿De verdad? >> ¡Sí! >>> Vale, ¡hagámoslo pues! Creo que deberíamos hacerlo > No, no deberíamos >> Bueno, pues yo digo que sí > ¿De verdad? >> ¡Sí! >>> Vale, ¡hagámoslo pues! ===== Tablas ===== DokuWiki usa una sintaxis simple para crear tablas. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado ^ | Fila 1 Col 1 | Fila 1 Col 2 | Fila 1 Col 3 | | Fila 2 Col 1 | una combinación(mira la barra doble)|| | Fila 3 Col 1 | Fila 2 Col 2 | Fila 2 Col 3 | Las filas tienen que empezar y terminar con un ''|'' para las filas normales o con un ''^'' para los encabezados. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado ^ | Fila 1 Col 1 | Fila 1 Col 2 | Fila 1 Col 3 | | Fila 2 Col 1 | una combinación(mira la barra doble)|| | Fila 3 Col 1 | Fila 2 Col 2 | Fila 2 Col 3 | Para conectar celdas horizontalmente, vacía la siguiente celda como se muestra arriba. ¡Asegúrate de tener siempre el mismo número de separadores de celda! Los encabezados verticales también son posibles. | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Col 2 | Fila 1 Col 3 | ^ Encabezado 4 | Sin combinación ahora| | ^ Encabezado 5 | Fila 2 Columna 2 | Fila 2 Columna 3 | Como puedes ver, el separador antes de la celda es el que determina el formato: | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Col 2 | Fila 1 Col 3 | ^ Encabezado 4 | Sin combinación ahora| | ^ Encabezado 5 | Fila 2 Columna 2 | Fila 2 Columna 3 | Ten en cuenta: La combinación de celdas vertical no es posible. También puedes alinear los contenidos de la tabla. Basta con añadir al menos dos espacios en blanco en el lado opuesto de tu texto: Añade dos espacios a la izquierda para alinear a la derecha, dos espacios a la derecha para alinear a la izquierda y dos espacios en cada extremo para obtener texto centrado. ^ Tabla con alineamiento ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Así es como aparece en el código fuente: ^ Tabla con alineamiento ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | ===== Bloques no analizados ===== Puedes incluir en tus documentos bloques sin analizar de varias maneras: * Añadiendo al menos dos espacios al inicio de cada línea del bloque (como se usa en los ejemplos a lo largo de toda esta página) * Usando las etiquetas ''code'' o ''file''. Este texto no analizado se dispuso mediante el uso de dos espacios. Este texto lleva etiquetas code. Los espacios se preservan: como <-este Este texto lleva etiquetas file. Se usan para mostrar un archivo. Para que el analizador ignore por completo una zona (es decir, no le aplique ningún formato), encierra el área entre etiquetas ''nowiki'' o, incluso más simple, con signos de porcentaje dobles ''%%''. Este texto contiene direcciones como ésta: http://dead-code.org/ y **formatos**, pero no se analizan. Échale un vistazo al código fuente de esta página para ver cómo usar estos bloques. ===== Resaltado de sintaxis ===== [[https://www.dokuwiki.org/es:wiki:dokuwiki|DokuWiki]] puede resaltar el código fuente, que lo hace más sencillo de leer. Usa [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- por lo que cualquier lenguaje aceptado por GeSHi se resalta. La sintaxis es muy parecida a la del bloque de código de la sección anterior, pero en este contexto el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Por ejemplo ''''. /** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("hola mundo"); //Display the string. } } Ésta es la lista de los lenguajes reconocidos actualmente //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80// ==Para resaltar código del lenguaje WME usa:== Escribe aquí tus líneas de código WME ===== Agregar fuentes RSS/ATOM ===== DokuWiki puede ofrecer información de fuentes XML externas. Para procesar dichas fuentes, se usa [[http://simplepie.org/|SimplePie]]. Todos los formatos aceptados por SimplePie, también pueden usarse en DocuWiki. Estos parámetros (separados por espacios) te permitirán configurar la entrega de la información: ^ Parámetro ^ Descripción ^ | cualquier número | número de artículos a mostrar como máximo; por omisión, 8 | | reverse | mostrar los últimos artículos al principio | | author | mostrar los nombres de los autores de los artículos | | date | mostrar las fechas de los artículos | | description | mostrar las descripciones de los artículos. Si el HTML está deshabilitado, toda etiqueta se rasurará | | //n//[dhm] | periodo de actualización, donde d=días, h=horas, m=minutos. (ej. 12h = 12 horas). | El periodo de actualización por omisión es de 4 horas. Cualquier valor menor a 10 minutos será tratado como 10 minutos. DokuWiki generalmente tratará de entregar una versión en caché de la página; obviamente esto no es apropiado cuando la página incluye contenido dinámico externo. El parámetro le dice a DokuWiki que regenere la página si hace más de //periodo de actualización// desde que la página se generó por última vez. **Por ejemplo:** {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }} ===== Incrustar HTML y PHP ===== Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas ''html'' o ''php'' de este modo: Esto es HTML Esto es HTML echo 'Un logo generado por PHP:'; echo 'PHP Logo !'; echo 'Un logo generado por PHP:'; echo 'PHP Logo !'; **Ten en cuenta**: La inclusión de HTML y PHP se encuentra deshabilitada por defecto en la configuración. Si se encuentra deshabilitado, el código se muestra en lugar de ejecutarse. ===== Plugins de Sintaxis ===== La sintaxis de DokuWiki puede extenderse con [[https://www.dokuwiki.org/plugins|Plugins]]. La descripción del uso de los plugins instalados se halla en sus respectivas páginas. Estos son los plugins de sintaxis disponibles en esta instalación de DokuWiki: ~~INFO:syntaxplugins~~