✎ wiki:syntax [JOSE MANUEL SANTOS JAEN]

Edita la página y pulsa Guardar. Vaya a syntax para ver la sintaxis del Wiki. Por favor edite la página solo si puedes mejorarla. Si quieres probar algo relacionado a la sintaxis, aprende a dar tus primeros pasos en el playground.

====== Sintaxis de formateado ======

[[wiki:SocratesWebFácil]] soporta un lenguaje de marcado simple, que trata de mantener los ficheros de datos lo más legibles posible. Esta página contiene toda la sintaxis posible que puedes utilizar cuando editas páginas. Simplemente echa un vistazo al fuente de esta página pulsando sobre el botón //Edita esta página// en la parte superior o inferior de la misma. Si quieres probar algo, usa la [[playground|página de pruebas]]. La sintaxis más sencilla está también disponible a través de [[doku>wiki:quickbuttons|botones rápidos]].

===== Formatos de texto básicos =====

SocratesWebFácil soporta texto en **negrita**, //itálica//, __subrayado__ y ''monoespaciado''. Por supuesto puedes **__//''combinar''//__** todos los formatos.

SocratesWebFácil soporta texto en **negrita**, //itálica//, __subrayado__ y ''monoespaciado''.
  Por supuesto puedes **__//''combinar''//__** todos los formatos.

Puedes usar también subíndices y superíndices.

Puedes marcar algo como <del>borrado</del>.

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

Este es un texto con varias rupturas de línea\\ Observa que
las dos barras invertidas sólo son reconocidas al final de la línea\\
o seguidas de\\ un espacio \\esto ocurre sin él.

Este es un texto con varias rupturas de línea\\ Observa que
  las dos barras invertidas sólo son reconocidas al final de la línea\\
  o seguidas de\\ un espacio \\esto ocurre sin él.

Deberías forzar nuevas líneas sólo si realmente es necesario.

===== Enlaces=====

SocratesWebFácil soporta múltiples formas de crear enlaces.

==== Externos ====

Los enlaces externos son reconocidos automágicamente: http://www.google.com o simplemente www.google.com - Puedes cambiar el texto del enlace: [[http://www.google.com|Este enlace apunta a google]]. Las direcciones de correo electrónico como esta: <andi@splitbrain.org> también son reconocidas.

Los enlaces externos son reconocidos automágicamente: http://www.google.com o
 simplemente www.google.com - Puedes cambiar el texto del enlace:
 [[http://www.google.com|Este enlace apunta a google]]. Las direcciones de correo
 electrónico como esta: <andi@splitbrain.org> también son reconocidas.

==== Internos ====

Los enlaces internos se crean usando corchetes. Puedes simplemente utilizar un [[doku>wiki:pagename]] (nombre de página) o usar un [[doku>wiki:pagename|Texto para el Título]]. Los nombres de página son convertidos a minúsculas automáticamente, no permitiéndose caracteres especiales.

Los enlaces internos se crean usando corchetes. Puedes simplemente utilizar
  un [[doku>wiki:pagename]] (nombre de página) o usar un [[doku>wiki:pagename|Texto
  para el Título]]. Los nombres de página son convertidos a minúsculas
  automáticamente, no permitiéndose caracteres especiales.

Puedes usar [[wiki:namespaces|Espacios de nombres]] utilizando "dos puntos" en el nombre de página.

Puedes usar [[wiki:namespaces|Espacios de nombres]] utilizando "dos puntos"
  en el nombre de página.

Para detalles sobre los espacios de nombres, consulta [[doku>wiki:namespaces]].

También es posible enlazar a secciones específicas. Simplemente añade el nombre de la sección después de un carácter almohadilla tal y como se hace 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 con un estilo diferente a los [[wiki:no existentes]].
  * SocratesWebFácil no usa sintaxis [[wp>CamelCase]] (TipoCamello) por defecto para crear automáticamente enlaces, pero este comportamiento es configurable en el [[doku>config|fichero de configuración]]. Pista: Si SocratesWebFácil es un enlace, entonces está habilitado.
  * Cuando cambia el encabezado de una sección, su enlazado cambian también. Por lo tanto, no te bases demasiado en enlazar secciones.

==== Interwiki ====

SocratesWebFácil soporta enlaces [[doku>wiki:interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]].

SocratesWebFácil soporta enlaces [[doku>wiki:interwiki]]. Estos son enlaces rápidos a otros
  Wikis. Por ejemplo un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]].

==== Compartidos Windows ====

Los compartidos Windows como [[\\server\share|este]] también se reconocen. Por favor, ten en cuenta que esto sólo tiene sentido en un grupo homogéneo de usuarios como los de una [[wp>Intranet]] corporativa.

Los compartidos Windows como [[\\server\share|este]] también se reconocen.

Notas:

* Por razones de seguridad, la navegación directa de compartidos windows solo funciona en Internet Explorer por defecto (y sólo en la "zona local").
  * Para Mozilla y Firefox se puede habilitar a través de la opción de configuración [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] pero no se recomienda hacerlo.
  * Consulta [[bug>151]] para más información.

==== Enlaces de Imagen ====

También puedes usar una imagen para enlazar a otra página interna o externa combinando la sintaxis para los enlaces y las imágenes (ver más abajo) como esta:

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

Nota: El formato de imágenes es la única sintaxis de formateo aceptada como nombre de enlace.

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

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

===== Secciones =====

Puedes utilizar hasta cinco niveles diferentes de encabezado para estructurar el contenido. Si tienes más de tres encabezados, una tabla de contenidos es generada automáticamente -- esta puede ser desactivada incluyendo el texto ''<nowiki>~~NOTOC~~</nowiki>'' en el documento.

==== Encabezado Nivel 3 ====
=== Encabezado Nivel 4 ===
== Encabezado Nivel 5 ==

==== Encabezado Nivel 3 ====
  === Encabezado Nivel 4 ===
  == Encabezado Nivel 5 ==

Utilizando cuatro o más guiones, puedes hacer una linea horizontal:

----

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

Puedes incluir [[doku>images|imágenes]] externas e internas con llaves. Opcionalmente puedes especificar el tamaño de las mismas.

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

Redimensionado a un ancho dado:            {{wiki:dokuwiki-128.png?50}}

Redimensionado a un ancho y auna altura dadas: {{wiki:dokuwiki-128.png?200x50}}

Redimensionado de una imagen externa:           {{http://de3.php.net/images/php.gif?200x50}}

Tamaño original:                               {{wiki:dokuwiki-128.png}}
  Redimensionado a un ancho dado:                 {{wiki:dokuwiki-128.png?50}}
  Redimensionado a un ancho y auna altura dadas: {{wiki:dokuwiki-128.png?200x50}}
  Redimensionado de una imagen externa:          {{http://de3.php.net/images/php.gif?200x50}}

Usando espacios en blanco a la izquierda o la derecha puedes elegir el alineamiento

Por supuesto, puedes especificar un título (que se muestra como un tooltip por muchos navegadores.)

Si especificas un nombre de fichero (externo o interno) que no es un formato de imagen (''gif,jpeg,png''), se mostrará un enlace en su lugar.

===== Listas =====

SocratesWebFácil soporta listas ordenadas y no ordenadas. Para crear un elemento de lista, indenta tu texto con dos espacios y utiliza ''*'' para listas no ordenadas o ''-'' para listas ordenadas.

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

- La misma lista pero ordenada
  - Otro elemento
    - Simplemente indenta para niveles más profundos
  - Eso es

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

- La misma lista pero ordenada
 - Otro elemento
 - Simplemente indenta para niveles más profundos
 - Eso es
</code>

===== Smileys =====

SocratesWebFácil convierte [[wp>emoticon]]s usados comúnmente a sus equivalentes gráficos. Más smileys pueden situarse en el directorio ''smiley'' y configurarse en el fichero ''conf/smileys.conf''. Estos son los incluidos en SocratesWebFácil.

* 8-) %%  8-)  %%
  * 8-O %%  8-O  %%
  * :-( %%  :-(  %%
  * :-) %%  :-)  %%
  * =)  %%  =)   %%
  * :-/ %%  :-/  %%
  * :-\ %%  :-\  %%
  * :-? %%  :-?  %%
  * :-D %%  :-D  %%
  * :-P %%  :-P  %%
  * :-O %%  :-O  %%
  * :-X %%  :-X  %%
  * :-| %%  :-|  %%
  * ;-) %%  ;-)  %%
  * ^_^ %%  ^_^  %%
  * :?: %%  :?:  %%
  * :!: %%  :!:  %%
  * LOL %%  LOL  %%
  * FIXME %%  FIXME %%
  * DELETEME %% DELETEME %%

===== Tipografía =====

[[SocratesWebFácil]] convierte caracteres sencillos de texto a sus entidades tipográficas correctas. Este es un ejemplo de caracteres reconocidos.

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"El pensó 'Tengo que hacerlo'..."

Nota: Estas conversiones puedes desactivarse en el fichero de configuración.

===== Citando =====

Algunas veces quieres marcar un texto para indicar que es una respuesta o un comentario. Puedes usar la siguientes sintaxis:

Creo que deberíamos hacerlo
  
  > No deberíamos
  
  >> Bien, he dicho que deberíamos
  
  > ¿De verdad?
  
  >> Sí
  
  >>> Entonces hagámoslo

Creo que deberíamos hacerlo 
> No deberíamos
>> Bien, he dicho que deberíamos
> ¿De verdad? 
>> Sí 
>>> Entonces hagámoslo

===== Tablas =====

SocratesWebFácil soporta 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    | un colspan (notar el doble pipe)      ||
| Fila 3 Col 1    | Fila 2 Col 2     | Fila 2 Col 3        |

Las filas de las tablas deben comenzar con un ''|'' para una fila normal o un ''^'' para una fila de cabecera.

^ Cabecera 1      ^ Cabecera 2       ^ Cabecera 3          ^
  | Fila 1 Col 1    | Fila 1 Col 2     | Fila 1 Col 3        |
  | Fila 2 Col 1    | un colspan (notar el doble pipe)      ||
  | Fila 3 Col 1    | Fila 2 Col 2     | Fila 2 Col 3        |

Para conectar celdas horizontalmente, simplemente haz la siguiente cela completamente vacía como se muestra arriba. ¡Asegúrate de tener siempre el mismo número de separadores de celda!

También es posible crear encabezados verticales.

Como puedes ver, es el separador antes de cada celda lo que decide el formato:

Nota: Los spans verticales (rowspan) no son posibles.

Puedes alinear los contenidos de la tabla también. Simplemente añade 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 a cada lado para centrar el texto.

Así es como se ve en el fuente:

===== Bloques no interpretados =====

Puedes incluir bloques no interpretados en tus documentos identándolos con al menos dos espacios (como se ha usado en los ejemplo previos) o usando las etiquetas ''code'' o ''file''.

<code>
Esto es código preformateado con todos los espacios preservados: como <-estos
</code>

<file>
Esto es más o menos lo mismo, pero lo puedes utilizar para indicar que pertenece a un fichero.
</file>

Para que el analizador ignore completamente un área (es decir, que no haga ningún formateo en ella), inclúyela entre las etiquetas ''nowiki'' o más sencillamente, con dobles signos de porcentaje ''<nowiki>%%</nowiki>''.

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

Mira el fuente de esta página para ver cómo se usan estos bloques.

===== Resaltado de Sintaxis =====

[[SocratesWebFácil]] puede resaltar el código fuente, lo que lo hace más fácil de leer. Utiliza el Resaltado Genérico de Sintaxis [[http://qbnz.com/highlighter/|GeSHi]] -- por lo tanto cualquier lenguaje soportado por GeSHi es soportado. La sintaxis es la misma que la del bloque de código en la sección previa, pero en este caso se inserta el nombre del lenguaje dentro de la etiqueta. 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("Hello World!"); //Display the string.
 }
}
</code>

Los siguiente lenguajes son reconocidos: //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml//

===== Embebiendo HTML y PHP =====

Puedes embeber código HTML y PHP en tus documentos usando las etiquetas ''html'' o ''php'' así:

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

**Nota**: El embebido HTML y PHP está deshabilitado por defecto en esta instalación. Cuando está desactivado, **el código es mostrado** en lugar de ejecutado.

Resumen de la edición

Nota: Al editar esta página, estás de acuerdo en autorizar su contenido bajo la siguiente licencia: GNU Free Documentation License 1.3