Formato Wiki

El marcado o sintáxis Wiki es una del núcleo de Trac, firmemente integrada a todas las otras partes de Trac en una poderosa y flexible funcionalidad.

Trac tiene un pequeño pero poderoso motor de Wiki. Este motor Wiki implementa un siempre creciente subconjunto de comandos de otros wikis muy populares, especialmente MoinMoin.

Esta pagina demuestra la sintaxis del Wiki, en cualquier lugar donde el formato Wiki este permitido.

El Wiki de Trac soporta los siguientes estilos de Fuente o Caracter:

 * '''Negrita''', '''!''' las comillas también pueden estar en negrita''', y '''! '''
 * ''Cursiva'
 * '''''Negrita y Cursiva'''''
 * __subrayado__
 * {{{monospace}}} or `monospace`
 * ~~tachado~~
 * ^superíndice^ 
 * ,,subíndice,,

Muestra:

Negrita, ''' las comillas también pueden estar en negrita, y !
Cursiva'
Negrita y Cursiva
subrayado
monospace or monospace
~~tachado~~
^superíndice
_subíndice

Notas:

Los comandos o etiquetas... y ... no sólo seleccionan el tipo de letra monospace, también tratan su contenido como texto literal, esto significa que ningún procesamiento wiki es hecho a dicho texto.
! (signo de admiración) le dice al interprete (procesador) wiki que no tome los siguientes caractéres como formato Wiki, por lo tanto ten cuidado de colocar un espacio despues de !, por ejemplo cuando culminas un texto en Negrita.

Encabezados (Títulos)

Tu puedes crear encabezados comenzando una línea con, de uno a cinco caracteres de igual ("=") seguidos de un espacio en blanco y el texto de encabezado o título. La línea debería terminar con un espacio en blanco seguido de la misma cantidad de caracteres =. El encabezado podría opcionalmente estar seguido de un id explícito. Si no, uno implicito más sin embargo legible id será generado.

Ejemplos:

= Título =
== Sub-Título ==
=== Acerca de "esto" ===
=== Id Explícito === #id-explícito-del-encabezado

Display:

Título

Sub-Título

Acerca de "esto"

Id Explícito

Parrafos

Un nuevo parrfo es creado donde sea que dos bloques de texto estén separados por uno o mas líneas vacías.

Un salto de línea o una línea nueva puede ser insertada usando:

Línea 1[[BR]]Línea 2

Muestra:

Línea 1
Línea 2

Listas

El Wiki soporta ambas listas, ordenada/numerada y desordenada.

Ejemplo:

 * Elemento 1
   * Elemento 1.1
      * Elemento 1.1.1   
      * Elemento 1.1.2
      * Elemento 1.1.3
   * Elemento 1.2
 * Elemento 2

 1. Elemento 1
   a. Elemento 1.a
   a. Elemento 1.b
      i. Elemento 1.b.i
      i. Elemento 1.b.ii
 1. Elemento 2
Y también se le puede asignar un número en específico.
3. Item 3

Muestra

Elemento 1
- Elemento 1.1
  - Elemento 1.1.1
  - Elemento 1.1.2
  - Elemento 1.1.3
- Elemento 1.2
Elemento 2

Elemento 1
1. Elemento 1.a
2. Elemento 1.b
  1. Elemento 1.b.i
  2. Elemento 1.b.ii
Elemento 2

Y también se le puede asignar un número en específico. 3. Item 3

Fijate que debes dejar uno o más espacios en blanco antes de comenzar cada uno de los elementos de la lista, sino la lista será tratada como un parrafo normal.

Listas de Definición

El Wiki también soporta las listas de definición.

Ejemplo:

 llama::
   tipo de mamífero con cabello.
 python::
    tipo de reptil, sin cabello

Muestra:

llama: tipo de mamífero con cabello.
python: tipo de reptil, sin cabello

Note que se necesita un espacio en frente del término a definir.

Texto Preformateado

Son Bloques de texto sin formato, es utilizable para fragmentos de código fuente, notas y ejemplos. Para crear un bloque de estos coloque el texto entre tres llaves. Las tres llaves necesitan estar en una línea separada. Ejemplo:

{{{
def HolaMundo():
    print "Hola Mundo"
}}}

Muestra

def HolaMundo():
    print "Hola Mundo"

Sangría

Para crear un parrafo con sangría se debe identar dicho parrafo con dos espacios en blanco.

Ejemplo:

  Este texto tiene, a diferencia de cualquier otro, sangría.

Muestra:

Este texto tiene, a diferencia de cualquier otro, sangría.

Citar Discusiones

Delinear una cita en un hilo de discusión en curso, tal como el área de comentarios de los tickets, pueden ser usadas las marcas o etiquetas para la citación (">", ">>", etc.) como en los correos electrónicos.

Ejemplo:

>> Texto Original
> Cualquier otra respuesta del texto.
El texto de mi respuesta.

Muestra:

Texto Original

Cualquier otra respuesta del texto.

El texto de mi respuesta.

Nota: algunos elementos del formato Wiki, tal como las listas y el texto pre-formateado, se pierden en las areas de citado. Algún reformato puede ser necesario para crear una citación clara.

Tablas

Tablas Sencillas pueden ser creadas de la siguiente manera:

||Celda 1||Celda 2||Celda 3||
||Celda 4||Celda 5||Celda 6||

Muestra:

Celda 1	Celda 2	Celda 3
Celda 4	Celda 5	Celda 6

Nota que tablas más complejas pueden ser creadas usando texto reestructurado.

Enlaces

Hiperenlaces son automaticamente creados a través de NombresDePaginaWiki y URLs. EnlacesDePaginasWiki pueden ser deshabilitados colocando previamente un signo de exclamación "!", tal como !EnlacePaginaWiki.

Ejemplo:

	TituloInicial, http://www.edgewall.com/, !NoEsUnEnlace

Muestra:

TituloInicial?, http://www.edgewall.com/, NoEsUnEnlace

A los enlaces se le pueden asignar más de un título descriptivo escribiendo el link seguido por un espacio en blanco y un title, todo esto dentro dentro de unos corchetes. Si el título descriptivo es omitido entonces el prefijo explicito es descartado, a menos que el enlace sea un enlace externo. Esto puede ser útil para las páginas wiki no apegadas a las convenciones de los NombresDePaginasWiki.

Ejemplo

 * [http://www.edgewall.com/ Edgewall Software]
 * [wiki:TitleIndex Title Index]
 * [wiki:ISO9000]

Muestra:

Enlaces Trac

Las páginas Wiki pueden enlazar directamente a otras partes del sistema Trac. Las páginas pueden hacer referencia a tickets, reportes, cambios, hitos, archivos fuentes y otras páginas Wiki usando las siguientes notaciones:

 * Tickets: #1 or ticket:1
 * Reportes: {1} or report:1
 * Cambios: r1, [1] or changeset:1
 * ...

Muestra:

Tickets: #1 or ticket:1
Reportes: {1} or report:1
Cambios: r1, [1] or changeset:1
...

Existe una variada gama de enlaces trac, vea TracLinks para información más detallada.

Escapando Enlaces y NombresDePaginasWiki

Tu puedes evadir hacer hiperenlaces externos de los TracLinks antecediendo una expersión con un sencillo "!" (signo de exclamación).

Ejemplo:

 !NoHiperEnlace
 !#42 no es un enlace

Muestra:

NoHiperEnlace

#42 no es un enlace

Imagenes

Urls finalizan con un .png, .gif o .jpg no serán interpretadas automaticamente como enlaces a imagenes, y convertidos a etiquetas <img>.

Ahora se debe usar el macro . La forma más simple de incluir una imagen es subiendola como un adjunto a la página actual, y luego colocando el nombre del archivo en una llamada a la macro como .

Además de a la página, también es posible referirla a otros recursos:

    * [[Image(wiki:WikiFormatto:picture.gif)]] (refiriendose al adjunto en otra página)
    * [[Image(ticket:1:picture.gif)]] (archivo adjuntado a otro ticket)
    * [[Image(htdocs:picture.gif)]] (archivo en el directorio htdocs del proyecto)
    * [[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]] (un archivo en el repositorio)

Ejemplo

Muestra: trac_logo_mini.png

Para mayor información del macro ver WikiMacros.

Macros

Los Macros son funciones propias que insertan contenido dinámico a la página.

Ejemplo:

  [[RecentChanges(Trac,3)]]

Muestra:

04/04/09
TracQuery (diff)
TracTickets (diff)
01/12/08
TracModPython

Para mayor información ver WikiMacros, y la lista de macros instalados.

Procesadores

Trac soporta formatos alternativos de lenguajes de marcas, usando WikiProcessors. Por ejemplo, procesadores son usados para escribir páginas en TextoRestrcuturado o HTML.

Example 1:

{{{
#!html
<h1 style="text-align: right; color: blue">Prueba HTML</h1>
}}}

Display:

Prueba HTML

Example:

{{{
#!python
class Test:

    def __init__(self):
        print "Hola Mundo"
if __name__ == '__main__':
   Test()
}}}

Display:

class Test:
    def __init__(self):
        print "Hola Mundo"
if __name__ == '__main__':
   Test()

Perl:

my ($test) = 0;
if ($test > 0) {
    print "hola";
}

Vea WikiProcessors para más información.

Comentarios Comentarios pueden ser agregados al texto plano. Estos no están filtrados y no se mostrarán en cualquier otro formato que no sea texto plano.

{{{
#!comment
Tu Comentario Aqui.
}}}

Miscelaneos

Cuatro o más guiones serán remplazados por una línea horizontal (<HR>)

Ejemplo:

 ----

Muestra:

Archivos adjuntos

trac.gif (2.9 KB) - agregado por tkoth 21 months atrás.

Canaima

Formato Wiki

Encabezados (Títulos)

Título

Sub-Título

Acerca de "esto"

Id Explícito

Parrafos

Listas

Listas de Definición

Texto Preformateado

Sangría

Citar Discusiones

Tablas

Enlaces

Enlaces Trac

Escapando Enlaces y NombresDePaginasWiki

Imagenes

04/04/09

01/12/08

Procesadores

Prueba HTML

Miscelaneos

Archivos adjuntos

Bájelo en otros formatos: