wiki-syntax.es

Also in English.

Introducción
Formato del texto
Organizar el artículo
Crear enlaces
Incluir Imágenes
Svnwiki y los lenguajes de programación

Edit Link Top

Introducción

Este documento describe la sintaxis que se usa por svnwiki para representar los contenidos.

Se recomienda leerlo y practicar usando la pagina de pruebas, que puede modificar como quiera.

Edit Link Top

Formato del texto

Edit Link Top

Crear un párrafo

Para crear un párrafo simplemente escriba el texto. Puede colocar un sólo ENTER en cualquier lugar del párrafo sin que esto tenga efectos.

Para dividir un parragrafos, use dos ENTERS consecutivos (una línea vacía).

Los dos párrafos anteriores de pudieron escribir así:

Para crear un párrafo simplemente escriba el texto. Puede colocar
un sólo ENTER en cualquier lugar del párrafo sin que esto
tenga efectos.

Para dividir un parragrafos, use dos ENTERS consecutivos (una línea vacía).

Edit Link Top

Crear títulos

Para crear un título, use una línea que inicie con dos, tres, cuatro o cinco signos igual:

== Título
=== Sub-título
==== Sub-Sub-título
===== Sub-sub-Sub-título

Si usa dos signos igual, creará un título de primer nivel. Mientras más signos, menor importancia tendrá el título.

También se pueden crar títulos usando los tags <h1> <h2>, <h3>, <h4>, <h5> y <h6>.

Hay una diferencia importante con la sintaxis anterior: los tags que se creen de esta manera no se incluiran en la Tabla de Contenido de los artículos. Por esta razon, se recomienda no usar esta sintaxis.

Edit Link Top

Estilo de las fuentes (negrilla, cursiva, técnica)

Para crear textos en negrilla, use tres apóstrofes ('), así:

'''negrilla'''

Use 2 para cursiva:

''cursiva''

Para texto de máquina de escribir, que es útil para documentación técnica, use esta sintaxis:

{{text}}

Usted puede marcar párrafos completos para que se muestren como máquina de escribir. Se usa para líneas que corresponden a la salida de un programa o comandos que uno debería escribir. Para que esto pase, inicie sus parrafos con un espacio. Los párrafos que se escriben de esa manera se muestran así:

> uptime
 23:04:03 up 14:18,  1 user,  load average: 0.02, 0.06, 0.18
> uname -a
Linux azul 2.6.10 #1 Mon Feb 7 00:20:16 COT 2005 i686 GNU/Linux
>

Edit Link Top

Tamaño de la fuente (grande, pequeña)

Para incrementar o decrementar el tamaño del texto usted puede dejarlo dentro de un par de tags <big>...</big> y <small>...</small>, respectivamente.

Ejemplo:

<big>Este texto es grande...</big>

<small>... y este es pequeño.</small>

Se muestra así:

Este texto es grande...

... y este es pequeño.

Edit Link Top

Centrando texto

Para centrar texto puede encerrar múltiples párrafos (y listas, títulos, etc.) con un par de tags <center>...</center>, así:


 un texto
 * item
 * otro

Esto se mostrará así:

un texto
item
otro

Edit Link Top

Caracteres especiales

svnwiki automáticamente reemplaza algunas secuencias de caracteres con las entidades HTML correspondientes para que se vean mejor en los navegadores. La siguiene es la lista de las secuencias:

(R) (C) <- <-> -> <= <=> => -- --- << 1/4 1/2 3/4 >>

Que se reemplazan por los siguientes caracteres: ® © ← ↔ → ⇐ ⇔ ⇒ – — « 1/4 1/2 3/4 »

Edit Link Top

Citas

Si quiere citar, puede inciar las líneas con > (el caracter estándar para citas en email). Alternativamente, usted puede rodear el texto con <blockquote> ... </blockquote>

El texto quedaría así:

I am enough of an artist to draw freely upon my imagination. Imagination is more important than knowledge. Knowledge is limited. Imagination encircles the world.

Edit Link Top

Código literal

Para incluir algo en una página literalmente (evitando que svnwiki lo convierta de wiki a HTML), escribalo dentro de los tags <nowiki> ... </nowiki>.

Edit Link Top

Organizar el artículo

Edit Link Top

Tabla de contenidos

Si quiere mostrar la tabla de contenido de un artículo, use el siguiente código:

[[toc:]]

Este código se reemplazará por la tabla de contenido. Puede ver un ejemplo al inicio de esta página..

Edit Link Top

Listas de items

Puedes crear listas con viñetas o números comenzando las líneas con los símbolos asterisco (*) o número (#):

* Un item
* Otro item
** Un Sub item
** Otro sub item
**# Un sub sub item numerado
**# Otro sub sub item numerado
* El último item

La siguiente lista se verá así:

Un item
Otro item
- Un Sub item
- Otro sub item
  1. Un sub sub item numerado
  2. Otro sub sub item numerado
El último item

Como se puede ver, se pueden mezclar viñetas y listas numeradas.

Edit Link Top

Listas de definiciones

Se puede crear una lista de definiciones usando múltiples lineas con la siguiente sintaxis:

; TERMINO : DEFINICION

Esto es útil para escribir una lista de términos con sus respectivas definiciones:

Ejemplo:

; Lassie : Una perra muy inteligente.
; Garfield : Un gato pesimista.
; Tux : Un pingüino simpático.

Esta lista se ve así:

Lassie: Una perra muy inteligente.
Garfield: Un gato pesimista.
Tux: Un pingüino simpático.

Edit Link Top

Usando tablas

Puedes crear una tabla usando la sintáxis estándar para tablas, usando los tags:

<table>

, <tr> y <td>.

Ejemplo:


País Número de ciudades
Colombia 16
Argentina 16
Brasil 31

Se muestra:

País	Número de ciudades
Colombia	16
Argentina	16
Brasil	31

Actualmente no es posible incluir parámetros en estos tags. Probablemente esto se arregle en una versión posterior.

Edit Link Top

Línea Horizontal

Puede incluir una línea horizontal así:

 ----

Se muestra así:

Edit Link Top

Crear enlaces

Para crear enlaces use [[destino]], donde destino es el enlace. Puede usar URLs relativas o absolutas.

Si usted quiere que su enlace muestre un texto diferente al destino, use [[destino|Algún texto]]. Y se mostrará: Algún texto.

Algunos ejemplos:

[[http://wiki.freaks-unidos.net/svnwiki]]
[[default|Home Page]]

Edit Link Top

Incluir Imágenes

Para incluir imágenes en sus artículos use el siguiente texto:

[[image:URL|ALT]]

Debe reemplazar URL con la URL de su imagen (puede ser absoluta o relativa) y ALT con una descripción simple de la imagen.

Ejemplo:

[[image:http://orfeo.superservicios.gov.co:81/wiki/images/cabecera-super.jpg|Image]]

Se ve así:

Edit Link Top

Svnwiki y los lenguajes de programación

Edit Link Top

Resalte de sintaxis

Puede embeber código o información en varios formatos o lenguajes de programación. Svnwiki usará GNU Enscript para resaltarlo. Use el tag <enscript> e indique el lenguaje de programación o formato con el parámetro highlight.

Por ejemplo,

<enscript highlight=c>
static void
pinst_check ( void )
{
  pid_t pinst = pinst_find();
  if (pinst != -1 && kill(pinst, 0) != -1)
    printf("%s: server alive (%d)\n", program_name, pinst);
  else
    printf("%s: server is not running\n", program_name);
  exit(EXIT_SUCCESS);
}
</enscript>

se muestra así:

static void
pinst_check ()
{
  pid_t pinst = pinst_find();
  if (pinst != -1 && kill(pinst, 0) != -1)
    printf("%s: server alive (%d)\n", program_name, pinst);
  else
    printf("%s: server is not running\n", program_name);
  exit(EXIT_SUCCESS);
}

Note que para hacer esto usted necesitará tener GNU enscript instalado. Si no lo tiene, la información se verá sin resaltar.

Los siguientes lenguajes están soportados: ada asm awk bash c changelog cpp csh delphi diff diffs diffu dylan eiffel elisp erlang forth fortran fortran_pp haskell html icon idl inf java javascript ksh lua m4 mail makefile matlab nroff oberon2 objc outline oz pascal perl postscript pyrex python rfc scheme sh skill smalltalk sml sql states synopsys tcl tcsh tex vba verilog vhdl vrml wmlscript zsh.

Edit Link Top

Embeber código de Scheme

Es posible embeber programas completos en lenguaje de programación Scheme dentro de las páginas del wiki. Svnwiki lo ejecutará seguramente (en un entorno seguro) y lo reemplazará por la salida que produzca.

Por ejemplo, puede incluir código que imprima algunos números:

<scheme>

(let loop ((a 0) (b 1) (i 0))
  (cond
    ((< i 10) (format #t "<p>~A: ~A~%" i a) (loop b (+ a b) (+ i 1)))))

</scheme>

que se reemplazaría por lo siguiente:

0: 0

1: 1

2: 1

3: 2

4: 3

5: 5

6: 8

7: 13

8: 21

9: 34

Note que la salida de código Scheme se incluirá literalmente en la página (así que puede imprimir tags de HTML).

Edit Link Top

Código literal

Para incluir algo en una página literalmente (evitando que svnwiki lo convierta de wiki a HTML), escribalo dentro de los tags <nowiki> ... </nowiki>.

Si tiene sugerencias para mejorar Svnwiki, por favor cuéntenos.

Last update: 2008-02-06 (Rev 13582)