wiki:sintaxis [VideoSeguridad]

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
====== Sintaxis de Formato ======

[[DokuWiki]] soporta un lenguaje de marcas simple, que intenta hacer los ficheros de datos tan legibles como sea posible. Esta página contiene todas las posibles opciones que puedes usar a la hora de editar las páginas. Simplemente, observa el código de esta página pulsando sobre //Editar esta página// en la parte superior y en la parte inferior de la página. Si quieres intentar algo, usa la página de [[playground:playground|pruebas]]. Las marcas más simples también se encuentran accesibles mediante [[doku>toolbar]].

===== Formato básico de texto =====

DokuWiki soporta **negritas**, //cursivas//, __subrayados__ y texto ''monoespaciado''. Por supuesto, puedes **__//''combinarlos''//__** todos.

  DokuWiki soporta **negritas**, //cursivas//, __subrayados__ y texto ''monoespaciado''. 
  Por supuesto, puedes **__//''combinarlos''//__** todos.

También puedes usar <sub>subíndices</sub> y <sup>superíndices</sup>.

  También puedes usar <sub>subíndices</sub> y <sup>superíndices</sup>.

Del mismo modo, también puedes marcar algo como <del>borrado</del>.

  Del mismo modo, también puedes marcar algo como <del>borrado</del>.

Los **párrafos** se crean a partir de líneas en blanco. Si quieres **forzar un salto de línea** sin un párrafo, puedes usar dos barras invertidas seguidas por un espacio en blanco o el final de la línea.

Esto es un texto con algunos saltos de línea.\\ Advierte que las
dos barras invertidas son reconocidas solamente al final de una línea\\
o cuando están seguidas de\\ un espacio en blanco \\Esto sucede sin él.

  Esto es un texto con algunos saltos de línea.\\ Advierte que las 
  dos barras invertidas son reconocidas solamente al final de una línea\\
  o cuando están seguidas de\\ un espacio en blanco \\Esto sucede sin él.

Solamente deberías forzar saltos de línea cuando realmente lo necesites.




===== Enlaces =====

DokuWiki soporta múltiples formas de crear enlaces.
==== Externos ====

Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com - También puedes establecer enlaces con un nombre: [[http://www.google.com|Este enlace apunta a google]]. Las direcciones de correo electrónico como ésta: <andi@splitbrain.org> también son reconocidas.

  Dokuwiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen 
  automáticamente: http://www.google.com o simplemente www.google.com - También puedes
  establecer enlaces con nombre: [[http://www.google.com|Este enlace apunta a google]]. 
  Las direcciones de correo electrónico como ésta: <andi@splitbrain.org> 
  también son reconocidas.

**Nota**: para los enlaces con nombre hay que usar el caracter separador | (barra vertical). A la izquierda del separador va la dirección del enlace y a la derecha el nombre del enlace.\\
Algunos teclados lo tienen en la tecla del número 1 y se obtiene presionando dicha tecla simultánemamnte con AltGr.\\
Si no tuvieras en tu teclado el caracter separador, **en Windows** se consigue mediante la combinación //alt+124// (tecleando con el teclado numérico).\\
Si no te funcionaran ninguno de los dos métodos anteriores (puede ocurrir en Mac, en Linux y en notebooks sin teclado numérico) puedes copiar el siguiente texto para construir un enlace con nombre:
<code>[[http://direccion|nombre enlace]]</code>
Pégalo en tu documento y luego reemplaza 'dirección' y 'nombre enlace' por los correspondientes que desees poner.

==== Internos ====

Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar [[doku>es:pagename|pagename]] como usar el extendido[[doku>es:pagename|Texto de título]]. Los nombres de páginas wiki son convertidos a minúsculas automáticamente y no se permiten caracteres especiales.

  Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar [[doku>es:pagename|pagename]] 
  como usar el extendido[[doku>es:pagename|Texto de título]]. Los nombres de páginas wiki son convertidos
  a minúsculas automáticamente y no se permiten caracteres especiales.
  
Puedes usar [[doku>es:pagename|pagename]] mediante dos puntos en el nombre de la página.

  Puedes usar [[doku>es:pagename|pagename]] mediante dos puntos en el nombre de la página.

Para más detalles sobre espacios de nombres mira [[doku>es:namespaces|namespaces]].

Es también posible enlazar con una sección específica. Basta con añadir el nombre de sección detrás de una almohadilla, como se hace en HTML. Esto enlaza a [[es:syntax#Internos|Esta sección]].

  Esto enlaza a [[es:syntax#Internos|Esta sección]].

Notas:

  * Los enlaces a [[es:syntax|páginas existentes]] se muestran de forma diferente a los [[no existentes]].
  * DokuWiki no utiliza [[wp>es:CamelCase]] para crear enlaces automáticamente por defecto, pero este comportamiento puede ser habilitado en el fichero [[doku>es:config]]. Truco: Si DokuWiki es un enlace, entonces está habilitado.
  * Cuando se cambia el encabezamiento de una sección, su bookmark también cambia. Así que no dependas demasiado del enlace de secciones.

==== Interwiki ====

DokuWiki permite enlaces [[doku>es:interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo, esto es un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]].

  DokuWiki permite enlaces [[doku>es:interwiki]]. Estos son enlaces rápidos a otros Wikis. 
  Por ejemplo, esto es un enlace a la página web de la Wikipedia sobre Wikis: [[wp>Wiki]].

==== Recursos compartidos de Windows ====

Los recursos compartidos de Windows como [[\\server\share|este]] también son reconocidos. Por favor, date cuenta de que éstos solamente tienen sentido en un grupo de usuarios homogéneo, tales como una [[wp>Intranet]] corporativa.

  Los recursos compartidos de Windows como [[\\server\share|este]] también son reconocidos.
  
Nota:

  * Por motivos de seguridad, la navegación directa por recursos compartidos solamente funciona en Microsoft Internet Explorer.
  * Para Mozilla y Firefox puede ser habilitada a través de una opción de configuración [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] pero no es recomendado.
  * Ver [[bug>151]] para más información.



==== Enlaces imagen ====

También puedes usar una imagen como enlace a otra página externa o interna combinando la sintaxis de enlaces e imágenes (ver abajo) así:

  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Por favor, ten en cuenta que el formato de imagen es la única sintaxis de formato aceptada en los nombres de enlace.

Está soportada la sintaxis completa de [[#imagenes_y_otros_ficheros|imagen]] y [[#enlaces|enlace]] (incluyendo modificar el tamaño de la imagen, e imágenes, URLs y enlaces interwiki internas y externas).

===== Notas al pie =====

Puedes añadir notas al pie ((Esto es una nota al pie)) usando paréntesis dobles.

  Puedes añadir 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. 
Cada encabezado se hace encerrando el titular entre signos de igual (caracter "=")\\
La cantidad de signos de igual (caracter "=") determina el nivel del encabezado.

Si tienes más de tres encabezados, un índice se genera automáticamente -- se puede deshabilitar incluyendo la cadena ''<nowiki>~~NOTOC~~</nowiki>'' en el documento.



==== Titular Nivel 3 ====
=== Titular Nivel 4 ===
== Titular Nivel 5 ==

   ==== Titular Nivel 3 ====
   === Titular Nivel 4 ===
   == Titular Nivel 5 ==

Usando cuatro o más guiones, puedes hacer una línea horizontal:

----

<code> ---- </code>


===== Imágenes y otros ficheros =====

Puedes incluir [[doku>images|imágenes]] externas e internas usando llaves. De manera opcional, puede especificar sus tamaños.

Tamaño real:                        {{wiki:dokuwiki-128.png}}

Redimensionando el ancho:           {{wiki:dokuwiki-128.png?50}}

Redimensionando altura y ancho:     {{wiki:dokuwiki-128.png?200x50}}

Imagen externa redimensionada:      {{http://de3.php.net/images/php.gif?200x50}}

  Tamaño real:                      {{wiki:dokuwiki-128.png}}
  Redimensionando la anchura:       {{wiki:dokuwiki-128.png?50}}
  Redimensionando altura y anchura: {{wiki:dokuwiki-128.png?200x50}}
  Imagen externa redimensionada:    {{http://de3.php.net/images/php.gif?200x50}}

Usando espacios en blanco a derecha o izquierda puedes escoger el alineamiento:

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

  {{ wiki:dokuwiki-128.png}}
  {{wiki:dokuwiki-128.png }}
  {{ wiki:dokuwiki-128.png }}

Naturalmente, también puedes añadir un título (se muestra como tooltip 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 fichero (externo o interno) que no es una imagen (''gif,jpeg,png''), entonces será mostrado como un enlace.

Para enlazar una imagen a otra página ver mas arriba en [[#Enlaces imagen]].





===== Listas =====

Dokuwiki soporta listas ordenadas y desordenadas. Para crear un elemento de lista, indenta tu texto con dos espacios y usa un ''*'' para listas desordenadas o un ''-'' para las listas ordenadas.

  * Esto es una lista
  * El segundo elemento
    * Puedes tener diferentes niveles
  * Otro elemento

  - La misma lista pero ordenada
  - Otro elemento
    - Basta con usar sangría para obtener niveles más anidados
  - Listo

<code>
  * Esto es una lista
  * El segundo elemento
    * Puedes tener diferentes niveles
  * Otro elemento

  - La misma lista pero ordenada
  - Otro elemento
    - Basta con usar indentación para obtener niveles más anidados
  - Listo
</code>



===== Smileys =====

DokuWiki convierte los [[wp>emoticon|emoticonos]] usados habitualmente a sus equivalentes gráficos. Se pueden poner más smileys en el directorio ''smiley'' y configurarlos en el fichero ''conf/smileys.conf''. Aquí tienes 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 =====

[[DokuWiki]] puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos.

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"El pensó 'It's a man's world'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"El pensó 'It's a man's world'..."
</code>

Por favor, advierte: Estas conversiones pueden ser deshabilitadas en las opciones de configuración.

===== Citas =====

A veces desea marcar algún texto para indicar que es una respuesta o comentario. Puede usar la siguiente sintaxis:

  Pienso que deberíamos hacerlo
  
  > No deberíamos
  
  >> Bueno, yo digo que deberíamos
  
  > En serio?
  
  >> Si!
  
  >>> Entonces hagámoslo!

Pienso que deberíamos hacerlo

> No deberíamos

>> Bueno, yo digo que deberíamos

> En serio?

>> Si!

>>> Entonces hagámoslo!

===== Tablas =====

DokuWiki soporta 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, haz la celda siguiente completamente vacía 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 de celda antes de una celda es quien decide cómo es 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   |

Puedes combinar celdas verticalmente (rowspans) añadiendo '':::'' en las celdas debajo de la que deseas combinar.

^Encabezado 1         ^Encabezado 2                        ^Encabezado 3       ^
|Fila 1 Columna 1     |Esta celda se combina verticalmente |Fila 1 Columna 3   |
|Fila 2 Columna 1     |:::                                 |Fila 2 Columna 3   |
|Fila 3 Columna 1     |:::                                 |Fila 2 Columna 3   |

<code>
^Encabezado 1         ^Encabezado 2                        ^Encabezado 3       ^
|Fila 1 Columna 1     |Esta celda se combina verticalmente |Fila 1 Columna 3   |
|Fila 2 Columna 1     |:::                                 |Fila 2 Columna 3   |
|Fila 3 Columna 1     |:::                                 |Fila 2 Columna 3   |
</code>


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 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:
  * Indentando con al menos dos espacios (como se usa en los ejemplos a lo largo de toda esta página) 
  * Usando las etiquetas ''code'' o ''file''.

  Esto es texto no analizado que se hizo indentando con dos espacios.
<code>
Esto se hizo con etiquetas code. Los espacios se preservan: como         <-este
</code>

<file>
Esto con etiquetas file. Se usa para indicar que estás mostrando un fichero.  
</file>

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 duplicados ''<nowiki>%%</nowiki>''.

<nowiki>
Esto es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con ellos.
</nowiki>

Echa un vistazo al fuente de esta página para ver cómo usar estos bloques.
===== Resaltado de Sintaxis =====

[[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 soportado por GeSHi es soportado. La sintaxis es muy parecida a la del bloque de código de la sección anterior, pero esta vez el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Por ejemplo ''<nowiki><code java></nowiki>''.

<code java>
/** 
 * 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.
    }
}
</code>

Los lenguajes siguientes son reconocidos actualmente: //actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, groovy, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, tsql, reg, robots, ruby, vb, vbnet, vhdl, visualfoxpro, winbatch, xml//

===== Agregar fuentes RSS/ATOM =====
DokuWiki puede integrar información de fuentes XML externas. Para procesar las fuentes XML, se ocupa [[http://simplepie.org/|SimplePie]]. Todos los formatos entendidos por SimplePie, pueden usarse también en DocuWiki. Se puede afectar el despliegue por medio de varios parámetros separados por espacios:

^ 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.

**Ejemplo:**

  {{rss>http://barrapunto.com/index.rss 10 author date 2h }}

{{rss>http://barrapunto.com/index.rss 10 author date 2h }}
===== Incrustar HTML y PHP =====

Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas ''html'' o ''php'' de este modo:
<code>
<html>
Esto es <font color="red" size="+1">HTML</font>
</html>
</code>

<html>
Esto es <font color="red" size="+1">HTML</font>
</html>

<code>
<php>
echo 'Un logo generado por PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>

<php>
echo 'Un logo generado por PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

**Por favor observa**: La inclusión de HTML y PHP se encuentra deshabilitada predeterminadamente en la configuración. Si se encuentra deshabilitado, el código se muestra en lugar de ejecutarse.



===== Macros de Control =====

Algunas expresiones afectan la manera en que DokuWiki despliega una página, sin producir una salida //per se//. Se cuenta con las siguientes macros de control:

^ Macro           ^ Descripción |
| %%~~NOTOC~~%%   | Si ésta macro se encuentra en la página, no se generará una tabla de contenidos |
| %%~~NOCACHE~~%% | DokuWiki, por omisión, hace un caché de todo lo que despliega. A veces esto no es deseable (por ejemplo, cuando se usa la sintaxis %%<php>%% descrita arriba); añadir esta macro forzará a DokuWiki a regenerar la página cada vez que sea solicitada |

===== Plugins de Sintaxis =====

La sintaxis de DokuWiki puede extenderse con [[doku>plugins|Plugins]]. Como se usan los plugin instalados se describe en sus correspondientes páginas descriptivas. Los siguientes plugins de sintaxis están disponibles en esta particular instalación de DokuWiki:

~~INFO:syntaxplugins~~