Diferències

Ací es mostren les diferències entre la revisió seleccionada i la versió actual de la pàgina.

Link to this comparison view

wiki:mcast [2011/08/04 20:29] (actual)
Línia 1: Línia 1:
 +====== Sintaxis de Formato ======
  
 +[[wiki:DokuWiki]] soporta un lenguaje de marcaje el cual intenta que los datafiles (archivos de datos) sean tan legibles como se pueda. Esta página contiene todas las opciones posibles de sintaxis que se pueda usar en el proceso de edición de las páginas. Para ver el código fuente de esta página presione el botón //Editar esta página// en la parte inferior de la misma. Si desea hacer alguna prueba use la página [[playground:playground|playground]]. El marcaje más sencillo está disponible de modo muy fácil también mediante [[doku>wiki:quickbuttons|quickbuttons]].
 +
 +===== Formato básico de texto  =====
 +
 +
 +
 +DokuWiki soporta los siguientes tipos de textos: **negrita**, //cursiva//, __subrayado__ 
 +
 +y ''monoespaciado''. Por supuesto que también se pueden  **__//''combinar''//__** todos éstos.
 +%% %%
 +%% %%
 +%% %%
 +
 +  DokuWiki soporta los siguientes tipos de textos: **negrita**, //cursiva//, __subrayado__ 
 +  y ''monoespaciado''. Por supuesto que también se pueden  **__//''combinar''//__** todos éstos.
 +
 +Se puede usar <sub>subscript</sub> y <sup>superscript</sup>, también.
 +
 +  Se puede utilizar <sub>subscript</sub> y <sup>superscript</sup>, también.
 +
 +
 +Se puede resaltar algo como <del>borrado</del> del mismo modo.
 +
 +  Se puede resaltar algo como <del>borrado</del> del mismo modo.
 +
 +Los **Párrafos** se crean a partir de líneas en blanco. Si desea **forzar una línea nueva** sin un párrafo puede usar dos contrabarras seguidas por un espacio en blanco al final de la línea.
 +
 +Este es un texto con algunos cortes de línea (linebreaks)\\ Observe que las  
 +dos contrabarras son reconocidas solamente si están situadas al final de la línea\\ 
 +o seguidas de\\ un espacio en blanco \\esto sucede sin el espacio al final.
 +
 +  Este es un texto con algunos cortes de línea (linebreaks)\\ Observe que las 
 +  dos contrabarras son reconocidas solamente si están situadas al final de la     
 +  línea\\ o seguidas de un espacio en blanco \\esto sucede sin el espacio al final. 
 +
 +Se utilizarán las nuevas líneas forzadas solamente si es muy necesario.
 +
 +===== Enlaces =====
 +
 +DokuWiki permite la creación de enlaces de diversos modos.
 +
 +==== Externo ====
 +
 +Los enlaces Externos son reconocidos automáticamente: http://www.google.com o sencillamente www.google.com - Usted puede establecer Linknames, también: [[http://www.google.com|Este Enlace  apunta a google]]. Direcciones de correo electrónico como esta: <andi@splitbrain.org> son igualmente reconocidas.
 +
 +  Los enlaces Externos son reconocidos automáticamente: http://www.google.com o sencillamente 
 +  www.google.com - Se pueden establecer Linknames, también: [[http://www.google.com|Este 
 +  Enlace  apunta a google]]. Direcciones de correo electrónico como esta: <andi@splitbrain.org> 
 +  son igualmente reconocidas. 
 +
 +==== Interno ====
 +
 +Los enlaces internos se crean usando corchetes. Se puede ya sea simplemente indicar un nombre de página [[doku>wiki:nombre de página]] o usar un [[doku>wiki:nombre de página|Texto de Título]] adicional. Los pagenames de Wiki son automáticamente convertidos a minúsculas. No se admiten caracteres especiales.
 +
 +  Enlaces internos se crean usando corchetes. Se puede ya sea simplemente indicar un nombre 
 +  de página [[doku>wiki:nombre de página]] o usar un [[doku>wiki:nombre de página|Texto de 
 +  Título]] adicional. Los pagenames de Wiki son automáticamente convertidos a minúsculas. No se 
 +  admiten caracteres especiales.
 +
 +Se pueden utilizar [[wiki:espacios personales]] o namespaces mediante el uso del símbolo de dos puntos en el nombre de página.
 +
 +  Se pueden utilizar [[wiki:espacios personales]] o namespaces mediante el uso del símbolo de  
 +  dos puntos en el nombre de página.
 +
 +Para más detalles sobre nombres de página ver [[doku>wiki:namespaces]].
 +
 +También es posible enlazar con una sección específica. Para lograrlo se añade el nombre se la sección atrás de un caracter almohadilla como se conoce en HTML. Esto enlaza con [[manualcastellanoini#interno|esta misma Sección]].
 +
 +  Esto enlaza con [[syntax#manualcastellanoini|esSección]] que aún no está creada.
 +
 +Anotaciones:
 +
 +  * Los Enlaces a [[wiki:syntax|páginas existentes]] se muestran en un estilo diferente a los enlaces a [[wiki:no existentes]].
 +  * DokuWiki no utiliza [[wp>CamelCase]] para crear enlaces automáticamente por defecto, pero esta prestación se puede habilitar en el archivo [[doku>wiki:config]]. Atención: Si DokuWiki es un enlace, entonces está habilitado.
 +  * Cuando se cambia la cabecera, también se cambia el marcador. Consecuentemente, que no se confíe demasiado al crear enlaces. 
 +
 +
 +==== Interwiki ====
 +
 +DokuWiki soporta enlaces de tipo [[doku>wiki:interwiki|Interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo, este es un enlace a la página de Wikipedia sobre Wikis: [[wp>Wiki]].
 +
 +  DokuWiki soporta enlaces de tipo [[doku>wiki:interwiki|Interwiki]]. Estos son enlaces rápidos 
 +  a otros Wikis.
 +  Por ejemplo, este es un enlace a la página de Wikipedia sobre Wikis: [[wp>Wiki]].
 +
 +==== Compartición de Ventanas ====
 +
 +Windows shares como [[\\server\share|éste]] también se reconocen. Observe que esto sólo
 +tienen razón de ser en un grupo de usuarios homogéneo como una [[wp>Intranet]] corporativa.
 +
 +  Windows shares como [[\\server\share|este]] también se reconocen. Observe que estas sólo
 +  tienen razón de ser en un grupo de usuarios homogeneo como una [[wp>Intranet]] corporativa.
 +
 +Anotaciones:
 +
 +* Por motivos de seguridad la exploración directa de windows shares sólo funciona en Internet Explorer de Microsoft por defecto (y sólo en la "zona local").
 +* Para Mozilla y Firefox se puede habilitar mediante la opción config [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] pero    
 +no es recomendable.
 +
 +* Para mayor información ver [[bug>151]]
 +
 +==== Enlaces de Imagen ====
 +
 +Se puede utilizar también una imagen para enlazar a otra página interna o externa combinando la sintaxis para enlaces e [[#Imágenes_y_otros_archivos|imágenes]] (ver abajo) de esta manera:
 +
 +
 +  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +Obsérvese que el formato de imagen la única sintaxis de formato aceptable en los nombres de enlace. 
 +
 +Toda la sintaxis de [[#Imágenes_y_otros_archivos|imagen]] y [[#Enlaces|enlaces]] está soportada (incluyendo modificación de tamaño de imagen, imágenes internas y externas, y enlaces URL e interwiki).
 +
 +===== Notas a Pie de Página =====
 +
 +Se pueden añadir notas a pie de página ((Esta es una nota a pie de página)) utilizando doble paréntesis. 
 +
 +  Se pueden añadir notas a pie de página ((Esta es una nota a pie de página)) utilizando doble 
 +  paréntesis. 
 +
 +===== Seccionamiento Estilo Sangría =====
 +
 +Se pueden utilizar hasta cinco niveles diferentes de cabeceras para estructurar el contenido. Si se tienen más de tres cabeceras, se genera automáticamente una tabla de contenido -- esto se puede deshabilitar incluyendo la cadena (string) ''<nowiki>~~NOTOC~~</nowiki>'' en el documento. 
 +
 +
 +==== Cabecera Nivel 3 ====
 +=== Cabecera Nivel 4 ===
 +== Cabecera Nivel 5 ==
 +
 +  ==== Cabecera Nivel 3 ====
 +  === Cabecera Nivel 4 ===
 +  == Cabecera Nivel 5 ==
 +
 +Para dibujar una línea horizontal se utilizan mínimo cuatro guiones.
 +
 +----
 +
 +===== Imágenes y otros archivos =====
 +
 +Se pueden incluir [[doku>wiki:imágenes]] internas y externas con llaves. Opcionalmente se puede especificar su tamaño.
 +
 +Tamaño real:                        {{wiki:dokuwiki-128.png}}
 +
 +Reajustar tamaño la anchura indicada:            {{wiki:dokuwiki-128.png?50}}
 +
 +Reajustar tamaño al anchura y altura indicadas: {{wiki:dokuwiki-128.png?200x50}}
 +
 +Imagen externa reajustada :           {{http://de3.php.net/images/php.gif?200x50}}
 +
 +  Tamaño real:                        {{wiki:dokuwiki-128.png}}
 +  Reajustar tamaño al ancho indicado:            {{wiki:dokuwiki-128.png?50}}
 +  Reajustar tamaño al ancho y altura indicados: {{wiki:dokuwiki-128.png?200x50}}
 +  Imagen externa reajustada :           {{http://de3.php.net/images/php.gif?200x50}}
 +
 +Mediante el uso de espacios en blanco a la derecha o a la izquierda se puede escoger la alineación.
 +
 +
 +{{ 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 que también se puede añadir un título (visualizado como un tooltip en la mayoría de exploradores).
 +
 +{{ wiki:dokuwiki-128.png |Este es un pie de foto (caption)}}
 +
 +  {{ wiki:dokuwiki-128.png |Este es un pie de foto (caption)}}
 +
 +Si se especifica un nombre de archivo (externo o interno) que no sea una imagen (''gif, jpeg, png''), entonces se visualizará (en su lugar) como un enlace.
 +
 +Para enlazar una imagen a otra página diríjase a [[#Enlaces de Imagen]] que se encuentra arriba.
 +
 +===== Listas =====
 +
 +DokuWiki soporta listas enumeradas y no enumeradas. Para crear un artículo de lista inserte una sangría de dos espacios antes del texto y utilice un asterisco ''*'' para listas no enumeradas, o un guión ''-'' para enumeradas.
 +
 +  * Esta es una lista
 +  * Este es el segundo artículo
 +    * Se pueden tener diferentes niveles
 +  * Este es otro artículo
 +
 +  - Esta es la misma lista pero enumerada
 +  - Otro artículo
 +    - Utilice la sangría para niveles más avanzados
 +  - Eso es todo
 +
 +<code>
 +* Esta es una lista
 +  * Este es el segundo artículo
 +    * Se pueden tener diferentes niveles
 +  * Este es otro artículo
 +
 +  - Esta es la misma lista pero enumerada
 +  - Otro artículo
 +    - Utilice la sangría para niveles más avanzados
 +  - Eso es todo
 +</code>
 +
 +===== Emoticonos =====
 +
 +DokuWiki convierte [[wp>emoticon]]os usados comunmente a sus equivalentes gráficos. Se pueden añadir más emoticonos en el directorio ''smiley'', y configurarlos en el archivo ''conf/smileys.conf''. A continuación se muestra una lista de los emoticonos incluidos en DokuWiki.
 +
 +  * 8-) %%  8-)  %%
 +  * 8-O %%  8-O  %%
 +  * :-( %%  :-(  %%
 +  * :-) %%  :-)  %%
 +  * =)  %%  =)   %%
 +  * :-/ %%  :-/  %%
 +  * :-\ %%  :-\  %%
 +  * :-? %%  :-?  %%
 +  * :-D %%  :-D  %%
 +  * :-P %%  :-P  %%
 +  * :-O %%  :-O  %%
 +  * :-X %%  :-X  %%
 +  * :-| %%  :-|  %%
 +  * ;-) %%  ;-)  %%
 +  * ^_^ %%  ^_^  %%
 +  * :?: %%  :?:  %%
 +  * :!: %%  :!:  %%
 +  * LOL %%  LOL  %%        '' - SONRISAS ''
 +  * FIXME %%  Repárame %%              
 +  * DELETEME %% Bórrame %%
 +
 +===== Tipografía =====
 +
 +[[wiki:DokuWiki]] puede convertir caracteres de texto simple a sus entidades tipográficamente correctas. Aquí tenemos un ejemplo de caracteres reconocidos.
 +
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..." 
 +"El penso 'es un mundo de hombres'..."
 +
 +<code>
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..." 
 +
 +"El pensó 'es un mundo de hombres'..."
 +</code>
 +
 +Obsérvese que estas conversiones pueden ser deshabilitadas mediante [[doku>wiki:config#typography|config option]] y [[doku>wiki:entities|pattern file]].
 +
 +===== Citas Textuales =====
 +A veces se necesita señalar algún texto para demostrar que es una respuesta o comentario. Para ello, se puede usar la siguiente sintaxis:
 +
 +  Creo que deberíamos hacerlo 
 +  
 +  > No, no lo deberíamos hacer 
 +  
 +  >> Bueno, yo digo que lo hagamos 
 +  
 +  > De veras?
 +  
 +  >> Sí!
 +  
 +  >>> Entonces, hagámoslo!
 +
 +Creo que deberíamos hacerlo 
 +
 +> No, no lo deberíamos hacer  
 +
 +>> Pues, yo digo que lo hagamos   
 +
 +> ¿De veras? 
 +
 +>> Sí! 
 +
 +>>> Entonces, hagámoslo!
 +
 +===== Tablas =====
 +
 +DokuWiki utiliza una sintaxis sencilla para crear tablas.
 +
 +^ Cabecera 1      ^ Cabecera 2       ^ Cabecera 3          ^
 +| Fila 1 Col 1    | Fila 1 Col 2     | Fila 1 Col 3        |
 +| Fila 2 Col 1    | expansión de col (note la doble barra) ||
 +| Fila 3 Col 1    | Fila 2 Col 2     | Fila 2 Col 3        |
 +
 +Las filas han de comenzar y acabar con una ''|'' barra vertical para filas normales, o con ''^'' para cabeceras.
 +
 +  ^ Cabecera 1      ^ Cabecera 2       ^ Cabecera 3          ^
 +  | Fila 1 Col 1    | Fila 1 Col 2     | Fila 1 Col 3        |
 +  | Fila 2 Col 1    | expansión de col (note la doble barra) ||
 +  | Fila 3 Col 1    | Fila 2 Col 2     | Fila 2 Col 3        |
 +
 +Para conectar celdas horizontalmente, haga que la siguiente celda esté completamente vacía, como se muestra arriba. Asegúrese de tener siempre la misma cantidad de separadores de celda!
 +
 +También se puede crear cabeceras verticales de tabla.
 +
 +
 +|              ^ Cabecera 1            ^ Cabecera 2          ^
 +^ Cabecera 3    | Fila 1 Col 2          | Fila 1 Col 3       |
 +^ Cabecera 4    | no expansión de col ahora |                |
 +^ Cabecera 5    | Fila 2 Col 2          | Fila 2 Col 3       |
 +
 +Como se aprecia, es el separador de celda situado antes de la celda el que decide sobre el formato:
 +
 +  |              ^ Cabecera 1            ^ Cabecera 2          ^
 +  ^ Cabecera 3    | Fila 1 Col 2          | Fila 1 Col 3       |
 +  ^ Cabecera 4    | no expansión de col ahora |                |
 +  ^ Cabecera 5    | Fila 2 Col 2          | Fila 2 Col 3       |
 +
 +Nota: No se permiten expansiones verticales (rowspan).
 +
 +Se puede alinear también el contenido de la tabla. Para lo cual se deben añadir dos espacios en blanco en el lado opuesto de su texto: Añada dos espacios a la izquierda para alinear a la derecha, dos espacios a la derecha para alinear a la izquierda, y al menos dos espacios en ambos extremos para centrar el texto.
 +
 +^           Tabla con alineación                  ^^^
 +|            derecha|    centro    |izquierda       |
 +|izquierda          |         derecha|    centro    |
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx        |
 +
 +Así es como se ve en el código:
 +
 +  ^           Tabla con alineación           ^^^
 +  |       derecha|    centro    |izquierda     |
 +  |izquierda     |       derecha|    centro    |
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +===== Bloques No Analizados =====
 +Se pueden incluir bloques no analizados en sus documentos ya sea indentándolos con una sangría de por lo menos dos espacios en blanco (como en los ejemplos anteriores), o usando etiquetas (tags) como ''code'' o ''file''.
 +
 +<code>
 +Esto es código preformateado, todos los espacios son conservados: como       <-esto
 +</code>
 +
 +<file>
 +Esto es básicamente lo mismo, pero se puede utilizar para mostrar que ha creado una cita de un archivo.
 +</file>
 +
 +Para que el analizador (parser) ignore completamente un área (por ejemplo: que no lo formatee ), encierre este área ya sea con etiquetas ''nowiki'', o incluso con dos signos de porcentaje''<nowiki>%%</nowiki>''.
 +
 +<nowiki>
 +Este es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formateo**, pero no se ha hecho nada con esto.
 +</nowiki>
 +
 +Driríjase al código fuente de esta página para ver como se usan estos bloques.
 +
 +===== Modos de Resaltar la Sintaxis =====
 +
 +[[DokuWiki]] puede resaltar el código fuente, lo cual facilita su lectura. Para ello utiliza el [[http://qbnz.com/highlighter/|GeSHi]] Resaltador Genérico de Sintaxis -- de modo que cualquier lenguaje soportado por GeSHi está igualmente aceptado por DokuWiki. La sintaxis es la misma que en el bloque de código en la sección anterior, pero en este caso el nombre del lenguaje usado está insertado dentro de la etiqueta. Por ejemplo: ''<nowiki><code java></nowiki>''.
 +
 +<code java>
 +/**
 + * La clase HelloWorldApp implementa una aplicación que 
 + * sencillamente exhibe la frase "Hello World!" (Hola a todo el Mundo) en la salida estándar.
 + * /
 +class HelloWorldApp {
 +    public static void main(String[] args) {
 +        System.out.println("Hello World!"); //Display the string.
 +    }
 +}
 +</code>
 +
 +Las siguientes cadenas de lenguaje están actualmente reconocidas: //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, 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, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml//
 +
 +
 +===== Modos de Incrustar HTML y PHP =====
 +
 +Se puede incrustar código sin tratar HTML o PHP  dentro de sus documentos mediante el uso de etiquetas ''html'' or ''php'' como se indica a continuación:
 +
 +
 +<code>
 +<html>
 +Esto es una línea de dódigo <font color="red" size="+1">HTML</font>
 +</html>
 +</code>
 +
 +<html>
 +Esto es un <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>
 +
 +**Observe por favor **: Embedding en HTML y PHP está deshabilitado por defecto en la configuración. Si está deshabilitado, el código se muestra pero no se ejecuta.
 +
 +
 +===== Plugins de Sintaxis =====
 +
 +La sintaxis de DokuWiki se puede ampliar mediante [[doku>wiki:plugins|Plugins]]. El modo de usar los plugins instalados está descrito en sus respectivas páginas de descrpción. Los siguientes plugins de sintaxis están disponibles en esta instalación de DokuWiki:
 +
 +
 +~~INFO:syntaxplugins~~