====== Ayuda: edición de páginas ====== [[doku>DokuWiki]] soporta un lenguaje de marcas simple, que trata de hacer los ficheros de datos tan legibles como sea posible. Esta página contiene todas las posibles opciones que puedes utilizar al editar las páginas. Basta con echar un vistazo al código fuente de esta página pulsando el botón //Editar esta página// en la parte superior o inferior de la página. Si quieres probar algo, sólo tiene que utilizar la [[playground:playground|Zona de pruebas]]. Las marcas de formato pueden ser introducidas fácilmente mediante [[doku>toolbar|la barra de herramientas]]. ===== Formatos de texto ===== DokuWiki soporta **negrita**, //cursiva//, __subrayado__ y ''monoespaciado''. Por supuesto, puedes **__//''combinar ''//__** estos formatos. DokuWiki soporta **negritas**, //cursiva//, __subrayado__ y ''monoespaciado''. Por supuesto, puedes **__//''combinar ''//__** estos formatos. También puedes utilizar subíndices y superíndices. También puedes utilizar subíndices y superíndices. Puedes marcar algo como eliminado. Puedes marcar algo como eliminado. Los **párrafos** se crean a partir de líneas en blanco. Si deseas insertar un **salto de línea**, puedes usar dos barras invertidas seguidas de un espacio o el final de la línea. Este es un texto con algunos saltos de línea.\\ Observa que las dos barras invertidas son reconocidas solamente al final de una línea\\ o seguidas de\\ un espacio en blanco. \\Esto sucede sin él. Este es un texto con algunos saltos de línea.\\ Observa que las dos barras invertidas son reconocidas solamente al final de una línea\\ o seguidas de\\ un espacio en blanco. \\Esto sucede sin él. Sólo necesitas insertar saltos de línea al final de cada párrafo. ===== Enlaces ===== DokuWiki soporta múltiples tipos de enlaces. ==== Externos ==== Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. Puedes configurar el texto del enlace, así: [[http://www.google.com|Este enlace apunta a google]]. También se reconocen las direcciones de correo electrónico como la siguiente: . DokuWiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. Puedes configurar el texto del enlace, así: [[http://www.google.com|Este enlace apunta a google]]. También se reconocen las direcciones de correo electrónico como la siguiente: . ==== Internos ==== Los enlaces internos se crean mediante dobles corchetes. Puedes utilizar el [[nombre de página]] o establecer un [[nombre de página|texto de enlace]]. Los enlaces internos se crean mediante dobles corchetes. Puedes utilizar el [[nombre de página]] o establecer un [[nombre de página|texto de enlace]]. Los [[doku>pagename|nombres de páginas wiki]] se convierten a minúsculas automáticamente, los caracteres especiales no están permitidos. Puedes indicar una carpeta para la [[carpeta:página]] mediante el uso de dos puntos entre el nombre de la carpeta y el de la página. Puedes indicar una carpeta para la [[carpeta:página]] mediante el uso de dos puntos entre el nombre de la carpeta y el de la página. Para obtener más información acerca de las carpetas mira [[doku>namespaces]]. También es posible enlazar con una sección específica de la página. Sólo tienes que añadir el nombre de sección detrás de una almohadilla, como se hace en HTML. Aquí se enlaza con [[syntax#internos|esta Sección]]. Aquí se enlaza con [[syntax#internos|esta Sección]]. Notas: * Los enlaces a [[syntax|páginas existentes]] se muestran en un estilo diferente de los enlaces a [[páginas inexistentes]]. * Por defecto DokuWiki no utiliza [[wp> CamelCase]] para crear enlaces automáticamente, pero este comportamiento puede ser habilitado en el archivo [[doku> config]]. Truco: Si DokuWiki es un enlace, entonces está habilitado. * Cuando se cambia el título de una sección, su marcador también cambia. Así que no confies demasiado en los enlaces a secciones. ==== Interwiki ==== DokuWiki soporta enlaces [[doku>Interwiki]]. Éstos son enlaces rápidos a otras Wikis. Por ejemplo, éste es un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]]. DokuWiki soporta enlaces [[doku>Interwiki]]. Éstos son enlaces rápidos a otras Wikis. Por ejemplo, éste es un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]]. ==== Enlaces con imagen ==== También puedes utilizar una imagen como enlace a otra página interna o externa combinando la sintaxis de enlaces e [[#Imágenes_y_otros_archivos|imágenes]] (ver abajo), así: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Nota: El formato de imagen es el único formato aceptado en los nombres de enlace. Se admite la sintaxis completa de [[#Imágenes_y_otros_archivos|imágenes]] y [[#enlaces|enlaces]] (incluyendo redimensionamiento de la imagen, imágenes internas y externas, URLs y enlaces interwiki). ==== Enlace de recursos con el mapa (Geo-referenciación) ==== Para enlazar un recurso con su situación geográfica en el mapa -conociendo sus coordenadas X e Y- debemos establecer un enlace del tipo: [[http://81.46.222.131/mapawiki/index2.php?bbox=XMIN,YMIN,XMAX,YMAX&mun=MUNICIPIO&wm=CAPA|NOMBRE]] Dónde:\\ XMIN = Coordenada X - 100\\ YMIN = Coordenada Y - 50\\ XMAX = Coordenada X + 100\\ YMAX = Coordenada Y + 50\\ MUNICIPIO = Código INE del Municipio ((Anchuelo:28012, CampoReal:28033, Corpa:28048, Loeches:28075, LosSantos:28137, Olmeda:28101, Pezuela:28111, Pozuelo:28116, Santorcaz:28136, Torres:28154, Valverde:28166))\\ CAPA = Número de Capa ((Naturaleza:1, Cultura:2, Comunicaciones:3, Turismo:4, Servicios:5))\\ NOMBRE = Denominación del recurso\\ \\ Ejemplo: [[http://81.46.222.131/mapawiki/index2.php?bbox=481186,4468968,481386,4469068&mun=28101&wm=2|Iglesia de San Pedro]] en Olmeda de las Fuentes.\\ \\ Nota: Puedes descargar esta {{:wiki:enlaces_wiki-mapa.xls|hoja de cálculo}} para generar fácilmente los enlaces. \\ ===== Notas al pie ===== Puedes agregar notas al pie ((Esto es una nota al pie.)) usando paréntesis dobles. Puedes agregar notas al pie ((Esto es una nota al pie.)) usando paréntesis dobles. ===== Secciones ===== Puedes usar hasta cinco niveles de encabezado distintos para estructurar tus contenidos. Si hay más de tres encabezados, se genera automáticamente una tabla de contenidos - esto se puede desactivar mediante la inclusión de la cadena ''~~NOTOC~~'' en el documento. ==== Título de nivel 3 ==== === Título de nivel 4 === == Título de nivel 5 == ==== Título de nivel 3 ==== === Título de nivel 4 === == Título de nivel 5 == Puedes crear una **línea horizontal**: ---- mediante el uso de cuatro o más guiones seguidos. ---- ===== Imágenes y otros archivos ===== Puedes incluir [[doku>images|imágenes]] externas e internas, entre llaves dobles. Opcionalmente puedes especificar su tamaño. Tamaño real: {{wiki:dokuwiki-128.png}} Anchura redimensionada: {{wiki:dokuwiki-128.png?50}} Anchura y altura redimensionadas ((Cuando la relación de aspecto de la altura y anchura no coincide con la de la imagen, se recortará a la nueva relación antes de redimensionar.)): {{wiki:dokuwiki-128.png?200x50}} Imagen externa redimensionada: {{http://de3.php.net/images/php.gif?200x50}} Tamaño real: {{wiki:dokuwiki-128.png}} Anchura redimensionada: {{wiki:dokuwiki-128.png?50}} Anchura y altura redimensionadas: {{wiki:dokuwiki-128.png?200x50}} Imagen externa redimensionada: {{http://de3.php.net/images/php.gif?200x50}} Puedes establecer la alineación horizontal mediante el uso de espacios en blanco a la izquierda, a la derecha o en ambos lados: {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} También puedes agregar un título (se muestra como un indicador emergente en la mayoría de los navegadores). {{ wiki:dokuwiki-128.png |Este es el título}} {{ wiki:dokuwiki-128.png |Este es el título}} Si especificas un nombre de archivo (externo o interno) que no sea una imagen (''gif, jpeg, png''), se mostrará como un enlace. Para enlazar una imagen a otra página ver [[#enlaces_con_imagen|enlaces con imagen]] más arriba. ===== Listas ===== DokuWiki soporta listas ordenadas y desordenadas. Para crear un elemento de lista, indenta el texto con dos espacios y usa un asterisco (''*'') para las listas desordenadas o un guión (''-'') para las ordenadas. * Esta es una lista * Segundo elemento * Puedes tener diferentes niveles * Otro elemento - La misma lista pero ordenada - Segundo elemento - Basta con usar indentación para obtener más niveles - Eso es todo * Esta es una lista * Segundo elemento * Puedes tener diferentes niveles * Otro elemento - La misma lista pero ordenada - Segundo elemento - Basta con usar indentación para obtener más niveles - Eso es todo Échale un vistazo a [[doku>faq:lists|FAQ sobre listas]]. ===== Conversiones de texto ===== DokuWiki puede convertir ciertos caracteres o cadenas pre-definidos en imágenes o en cualquier otro texto o código HTML. La conversión de texto a imágenes se realiza principalmente para obtener los emoticonos. Y la conversión de texto a HTML se utiliza para cambios en la tipografía, pero puede ser configurada para usar otras etiquetas HTML. ==== Conversiones de texto a imagen ==== DokuWiki convierte los populares [[wp>emoticon|emoticonos]] a sus equivalentes gráficos. Los [[doku>smileys]] y otras imágenes se pueden configurar y extender. Aquí tienes los emoticonos incluidos en DokuWiki: * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ==== Conversiones de texto a HTML ==== Tipografía: DokuWiki puede convertir caracteres de texto simples a su tipografía correcta. He aquí un ejemplo de caracteres reconocidos. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensó 'Es un mundo de hombres'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensó 'Es un mundo de hombres'..." Lo mismo se puede hacer para producir cualquier tipo de código HTML, sólo tienes que añadirlo a la [[doku>entities|plantilla]]. Hay tres símbolos que no se establecen en esa plantilla: multiplicación (640x480), comillas 'simples' y "dobles". Se pueden desactivar a través de una [[doku>config:typography|opción de configuración]]. ===== Citas ===== A veces desearás marcar un texto para indicar que es una respuesta o comentario. Puedes utilizar la siguiente sintaxis: Creo que deberíamos hacerlo. > No, no debemos. >> Bueno, yo digo que debemos. > ¿En serio? >> ¡Sí! >>> ¡Entonces hagámoslo! Creo que deberíamos hacerlo. > No, no debemos. >> Bueno, yo digo que debemos. > ¿En serio? >> ¡Sí! >>> ¡Entonces hagámoslo! ===== Tablas ===== DokuWiki tiene una sintaxis simple para crear tablas. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Columna 1 | Fila 1 Columna 2 | Fila 1 Columna 3 | | Fila 2 Columna 1 | celdas conectadas (nótese la doble barra) || | Fila 3 Columna 1 | Fila 3 Columna 2 | Fila 3 Columna 3 | Las filas tienen que empezar y terminar con una ''|'' para las filas normales o con un ''^'' para los encabezados. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Columna 1 | Fila 1 Columna 2 | Fila 1 Columna 3 | | Fila 2 Columna 1 | celdas conectadas (nótese la doble barra) || | Fila 3 Columna 1 | Fila 3 Columna 2 | Fila 3 Columna 3 | Para conectar celdas horizontalmente, deja la celda siguiente completamente vacía como se muestra arriba ¡Asegúrate de tener la misma cantidad de separadores de celda en todas las filas! Los encabezados verticales también son posibles. | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Columna 2 | Fila 1 Columna 3 | ^ Encabezado 4 | Sin conexión esta vez | | ^ Encabezado 5 | Fila 3 Columna 2 | Fila 3 Columna 3 | Como puedes ver, el separador de celda antes de una celda es el que especifica el formato: | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Columna 2 | Fila 1 Columna 3 | ^ Encabezado 4 | Sin conexión esta vez | | ^ Encabezado 5 | Fila 3 Columna 2 | Fila 3 Columna 3 | Puedes conectar celdas verticalmente, añadiendo '':::'' en las celdas por debajo de aquella a la que deben conectarse. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Columna 1 | esta celda se extiende verticalmente | Fila 1 Columna 3 | | Fila 2 Columna 1 | ::: | Fila 2 Columna 3 | | Fila 3 Columna 1 | ::: | Fila 2 Columna 3 | Aparte del indicador de conexión, esas células no debe contener ninguna otra cosa. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Columna 1 | esta celda se extiende verticalmente | Fila 1 Columna 3 | | Fila 2 Columna 1 | ::: | Fila 2 Columna 3 | | Fila 3 Columna 1 | ::: | Fila 2 Columna 3 | También puedes alinear el contenido de la tabla. Sólo tienes que añadir al menos dos espacios en blanco en el extremo opuesto del 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 ambos extremos para obtener texto centrado. ^ Tabla con alineación ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Así es como se ve en el código fuente: ^ Tabla con alineación ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Nota: La alineación vertical no está soportada. ===== Sin formato ===== Si necesitas mostrar el texto exactamente como se escribe (sin formato) encierra el área entre etiquetas ''%%%%'' o, aún más simple, entre signos de porcentaje doble ''%%''. Este es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con él. Lo mismo es cierto para %%//__este__ texto// con un emoticono ;-)%%. Este es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con él. Lo mismo es cierto para %%//__este__ texto// con un emoticono ;-)%%. ===== Bloques de código ===== Puedes incluir bloques de código en tus documentos, bien indentando por al menos dos espacios (como en los ejemplos anteriores) o usando las etiquetas ''%%%%'' o ''%%%%''. Este texto está indentado por dos espacios. Esto es código preformateado, todos los espacios se preservan: como <-aquí Esto es casi lo mismo, pero lo puedes usar para indicar que has citado un archivo. Los bloques anteriores fueron creados por este código fuente: Este texto está indentado por dos espacios. Esto es código preformateado, todos los espacios se preservan: como <-aquí Esto es casi lo mismo, pero lo puedes usar para indicar que has citado un archivo. ==== Resaltado de código ==== [[wiki:DokuWiki]] puede resaltar el código fuente, lo que hace que sea más fácil de leer. Se utiliza el resaltador de sintaxis genérico [[http://qbnz.com/highlighter/|GeSHi]]- por lo que cualquier lenguaje soportado por GeSHi es compatible. La sintaxis es la misma que en los bloques de código y archivo de la sección anterior, pero esta vez el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Ej. '''' o ''''. /** * La clase HolaMundo implementa una aplicación que * muestra "¡Hola Mundo!" por la salida estándar. */ class HolaMundo { public static void main(String[] args) { System.out.println("¡Hola Mundo!"); //Mostrar la cadena. } } Los lenguajes siguientes son reconocidos actualmente: //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80// ==== Bloques de código descargables ==== Cuando utilices bloques ''%%%%'' o ''%%%%'', como en los ejemplos anteriores, puede que desees que el código que se muestra esté también disponible para su descarga. Puedes hacerlo especificando un nombre de archivo después del código de idioma, como aquí: Si no deseas resaltado, pero sí un archivo descargable, especifica un guión (''-'') como código de idioma: ''%%%%''. ===== Incrustación de HTML y PHP ===== Puedes incrustar código HTML o PHP en tus documentos utilizando las etiquetas ''%%%%'' o ''%%%%''. (Utiliza etiquetas en mayúsculas si necesitas insertar bloques de elementos.) Ejemplo HTML: Esto es un HTML en línea

Y esto es un bloque HTML

Esto es un HTML en línea

Y esto es un bloque HTML

Ejemplo PHP: echo 'Logo generado por PHP:'; echo '¡Logo PHP!'; echo '(HTML en línea)'; echo ''; echo ''; echo '
Lo mismo, pero utilizando un bloque de elementos:¡Logo PHP!
';
echo 'Logo generado por PHP:'; echo '¡Logo PHP!'; echo '(HTML en línea)'; echo ''; echo ''; echo '
Lo mismo, pero utilizando un bloque de elementos:PHP Logo !
';
** Nota **: La incrustación de HTML y PHP está desactivada en la configuración por defecto. Si está deshabilitada, el código se muestra en lugar de ejecutarse. ===== Agregación de fuentes RSS/ATOM ===== [[DokuWiki]] puede integrar datos de fuentes externas XML. Para el análisis de las fuentes XML se utiliza [[http://simplepie.org/|SimplePie]]. Todos los formatos soportados por SimplePie se pueden utilizar también en DokuWiki. Puedes definir la presentación mediante parámetros adicionales, separados por espacios: ^ Parámetro ^ Descripción ^ | cualquier número | número máximo de elementos a mostrar, por defecto 8 | | reverse | mostrar primero los últimos artículos de la fuente | | author | mostrar el nombre de los autores de los artículos | | date | mostrar la fecha de los artículos | | description | mostrar la descripción de los artículos. Si [[doku>config:htmlok|HTML]] está desactivado se ignorarán todas las etiquetas | | //n//[dhm] | intervalo de refresco, dónde d=días, h=horas, m=minutos. (e.g. 12h = 12 horas). | El intervalo de refresco por defecto es de 4 horas. Cualquier valor por debajo de 10 minutos será tratado como 10 minutos. [[wiki:DokuWiki]] tratará, en general, de proporcionar una versión en caché de las páginas; obviamente esto no es apropiado cuando la página tiene contenido dinámico externo. Este parámetro indica a [[wiki:DokuWiki]] que actualice la página si se ha excedido el //intervalo de refresco// desde la última vez que la página fue accedida. **Ejemplo:** {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }} ===== Macros de control ===== Las macros de control siguientes están disponibles: ^ Macro ^ Descripción | | %%~~NOTOC~~%% | Si esta macro se encuentra en la página, no se creará la tabla de contenidos | | %%~~NOCACHE~~%% | DokuWiki cachea todos los datos por defecto. A veces esto no es lo deseable (por ejemplo, cuando se utiliza la etiqueta %%%% anterior), la adición de esta macro fuerza a DokuWiki a volver a procesar la página en cada llamada | ===== Plugins ===== La funcionalidad de DokuWiki puede extenderse con [[doku>plugins|Plugins]]. Cómo utilizar los plugins instalados se detalla en sus correspondientes páginas descriptivas. Los siguientes plugins están disponibles en esta Wiki: ~~INFO:syntaxplugins~~ ====== Más información ====== [[http://www.dokuwiki.org/es:dokuwiki|Página oficial de DokuWiki en español]].