Sintaxis avanzada
Versión 10 (Gonzalo Maqueira, 2012-03-01 13:22) → Versión 11/13 (Gonzalo Maqueira, 2012-03-01 14:26)
h1. Formatos de la Wiki
h2. Enlaces
h3. Enlaces de Redmine
Redmine permite hipervínculos entre los temas, de cambios y las páginas wiki de formato wiki se utiliza en cualquier lugar.
* Enlace a un tema: *#124* (muestra -[[manual:Sintaxis avanzada|#124]]-, el enlace está tachado si la petición está cerrada)
* Enlace a cambios: *r758* (muestra +[[manual:Sintaxis avanzada|r758]]+)
* Enlace a cambios con ID no numérico: *commit:c6f4d0fd* (muestra c6f4d0fd).
Enalces de la Wiki:
* *@[[Guía]]@* se muestra un enlace a la página denominada "Guía": [[manual:Sintaxis avanzada|Guía]]
* *@[[Guía#leer-mas]]@* lleva a "leer más". Los encabezados toman automáticamente los anclajes para que puedan ser referidos: [[manual:Sintaxis avanzada|Guía]]
* *@[[Guía|Manual de Usuario]]@* se muestra un enlace a la misma página, pero con un texto diferente: [[manual:Sintaxis avanzada|Manual de Usuario]]
También puede vincular a las páginas de un wiki de otro proyecto:
* *@[[sandbox:alguna página]]@* muestra el enlace a la página llamada "alguna página" de la Wiki Sandbox
* *@[[sandbox:]]@* se muestra un enlace a la página principal de la Wiki Sandbox
Los Enlaces de la Wiki son mostrados en rojo si la página aún no existe: [[Página no existente]].
Enlaces a otros recursos:
* Documentos:
* *@documento#17@* (enlace al documento con id 17)
* *@documento:Saludos@* (enlace al documento con el título "Saludos")
* *@document:"Algún documento"@* (comillas dobles deben ser usadas cuando el título del documento contenga espacios)
* Versiones:
* *@version#3@* (enlace a la versión con id 3)
* *@version:1.0.0@* (enlace a la versión llamada "1.0.0")
* *@version:"1.0 beta 2"@*(comillas dobles deben ser usadas cuando la versión contenga espacios)
* Adjuntos:
* *@attachment:archivo.zip@* (enlace al adjunto llamado archivo.zip)
* Por ahora solamente se puede hacer referencia a adjuntos en el mismo item.
* Archivos del Repositorio
* *@source:algun/archivo@* -- Enlace a el archivo ubicado en /algun/archivo en el repositorio del proyecto
* *@source:algun/archivo@52@* -- Enlace a la revisión 52 del archivo
* *@source:algun/archivo#L120@* -- Enlace a la línea 120 del archivo
* *@source:algun/archivo@52#L120@* -- Enlace a la línea 120 de la revisión 52 del archivo
* *@export:algun/archivo@* -- Forzar la bajada del archivo
Escape:
* Se puede prevenir que los enlaces sean analizados anteponiento el signo de exclamación: !
h3. Enlaces externos
URLs HTTP y direcciones de correo electrónico se convierten automáticamente en enlaces:
<pre>http://www.redmine.org, someone@foo.bar</pre>
displays: http://www.redmine.org, someone@foo.bar
Si desea mostrar un texto específico en lugar de la URL, puede utilizar la sintaxis estándar:
<pre>"Redmine web site":http://www.redmine.org</pre>
muestra: "Redmine web site":http://www.redmine.org
---
h2. Formato de texto
Para cosas como encabezados, negrita, listas, tablas, Redmine soporta la sintaxis Textile. Ver http://www.textism.com/tools/textile/ para información sobre el uso de cualquiera de éstas características. Algunos ejemplos son incluídos abajo pero hay muchas más opciones.
Estilo de la fuente
h3. Acrónimos
<pre>JPL(Juan Pérez López)</pre>
Muestra: JPL(Juan Pérez López)
h3. Estilo de fuentes
<pre>
* *negrita*
* _itálica_
* _*negrita itálica*_
* +subrayada+
* -tachada-
* Plano ^superíndice^
* Plano ~subíndice~
* @Elimina formatos@
</pre>
Muestra:
* *negrita*
* _itálica_
* _*negrita itálica*_
* +subrayada+
* -tachada-
* Plano ^superíndice^
* Plano ~subíndice~
* @Elimina formatos@
h3. Imágenes en línea
* *!imagen_url!* muestra una imágen que está en la dirección imagen_url (sintaxis textile)
* *!>imagen_url!* idem a la anterior pero alineada a la derecha
* !imagen_url(Título de la imágen)! muestra una imagen con un atributo alt/título
Si hay una imagen adjunta la página de la wiki, se puede visualizar en línea con el siguiente comando y el nombre del archivo: *!nombre_archivo.png!*
h3. Encabezados
<pre>
h1. Título
h2. Subtítulo
h3. Subsubtítulo
</pre>
Redmine asigna un ancla a cada uno de los encabezados para que puedan ser enlazados con "#Título", "#Subtítulo", etc.
h3. Párrafos
<pre>
p. alineación izquierda
p(. sangría izquierda 1 espacio
p((. sangría izquierda 2 espacios
así como para las líneas siguientes
p>. alineación derecha
p)))>. alineación derecha 3 espacios
p=. alineación Centrada
</pre>
h3. Predefinido
Para escapar de la sintaxis de la wiki:
<pre><pre> *Your text won't become bold* </pre></pre>
Display:
<pre> *Your text won't become bold* </pre>
h3. Tabulaciones
Empezar el párrafo con *bq.*
<pre>
bq. Rails es un completo framework para el desarrollo de respaldo de base de datos de aplicaciones web de acuerdo con el patrón Model-View-Control. Para ir a
producción, todo lo que necesitas es añadir una base de datos y un servidor web.
</pre>
Muestra:
bq. Rails es un completo framework para el desarrollo de respaldo de base de datos de aplicaciones web de acuerdo con el patrón Model-View-Control. Para ir a producción, todo lo que necesitas es añadir una base de datos y un servidor web.
h3. Tablas
<pre>
|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov |=. center |
|3|John Smith |Admin
(root)|^. valign top |
|4|- |Nobody
(anonymous)|~. valign bottom|
</pre>
Muestra (todos los espacios múltiples se sustituyen por un sólo espacio):
|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov |=. center |
|3|John Smith |Admin
(root)|^. valign top |
|4|- |Nobody
(anonymous)|~. valign bottom|
h3. Tabla de contenidos
*@{{toc}}@* => alineada a la izquierda
*@{{>toc}}@* => alineada a la derecha
---
h2. Macros
Redmine tiene los siguientes macros por defecto:
@hello_world@
p((. Ejemplo macro.
@include@
p((. Incluye una página de la wiki. Ejemplo:
{{include(Foo)}}
@macro_list@
p((. Muestra la lista de todos los macros disponibles incluyendo la descripción si está disponible.
---
h2. Resaltado de código
El resaltado de código se basa en "CodeRay":http://coderay.rubychan.de/, una rápida librería de resaltado escrita completamente en Ruby. Actualmente soporta c, html, javascript, rhtml, ruby, scheme, xml.
Se puede resaltar el código en la página de la wiki usando ésta sintaxis:
<pre><code class="ruby">
Insertar el código aquí.
</code></pre>
Ejemplo:
<pre><code class="ruby">
# The Greeter class
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hello #{@name}!"
end
end
</code></pre>
h2. Enlaces
h3. Enlaces de Redmine
Redmine permite hipervínculos entre los temas, de cambios y las páginas wiki de formato wiki se utiliza en cualquier lugar.
* Enlace a un tema: *#124* (muestra -[[manual:Sintaxis avanzada|#124]]-, el enlace está tachado si la petición está cerrada)
* Enlace a cambios: *r758* (muestra +[[manual:Sintaxis avanzada|r758]]+)
* Enlace a cambios con ID no numérico: *commit:c6f4d0fd* (muestra c6f4d0fd).
Enalces de la Wiki:
* *@[[Guía]]@* se muestra un enlace a la página denominada "Guía": [[manual:Sintaxis avanzada|Guía]]
* *@[[Guía#leer-mas]]@* lleva a "leer más". Los encabezados toman automáticamente los anclajes para que puedan ser referidos: [[manual:Sintaxis avanzada|Guía]]
* *@[[Guía|Manual de Usuario]]@* se muestra un enlace a la misma página, pero con un texto diferente: [[manual:Sintaxis avanzada|Manual de Usuario]]
También puede vincular a las páginas de un wiki de otro proyecto:
* *@[[sandbox:alguna página]]@* muestra el enlace a la página llamada "alguna página" de la Wiki Sandbox
* *@[[sandbox:]]@* se muestra un enlace a la página principal de la Wiki Sandbox
Los Enlaces de la Wiki son mostrados en rojo si la página aún no existe: [[Página no existente]].
Enlaces a otros recursos:
* Documentos:
* *@documento#17@* (enlace al documento con id 17)
* *@documento:Saludos@* (enlace al documento con el título "Saludos")
* *@document:"Algún documento"@* (comillas dobles deben ser usadas cuando el título del documento contenga espacios)
* Versiones:
* *@version#3@* (enlace a la versión con id 3)
* *@version:1.0.0@* (enlace a la versión llamada "1.0.0")
* *@version:"1.0 beta 2"@*(comillas dobles deben ser usadas cuando la versión contenga espacios)
* Adjuntos:
* *@attachment:archivo.zip@* (enlace al adjunto llamado archivo.zip)
* Por ahora solamente se puede hacer referencia a adjuntos en el mismo item.
* Archivos del Repositorio
* *@source:algun/archivo@* -- Enlace a el archivo ubicado en /algun/archivo en el repositorio del proyecto
* *@source:algun/archivo@52@* -- Enlace a la revisión 52 del archivo
* *@source:algun/archivo#L120@* -- Enlace a la línea 120 del archivo
* *@source:algun/archivo@52#L120@* -- Enlace a la línea 120 de la revisión 52 del archivo
* *@export:algun/archivo@* -- Forzar la bajada del archivo
Escape:
* Se puede prevenir que los enlaces sean analizados anteponiento el signo de exclamación: !
h3. Enlaces externos
URLs HTTP y direcciones de correo electrónico se convierten automáticamente en enlaces:
<pre>http://www.redmine.org, someone@foo.bar</pre>
displays: http://www.redmine.org, someone@foo.bar
Si desea mostrar un texto específico en lugar de la URL, puede utilizar la sintaxis estándar:
<pre>"Redmine web site":http://www.redmine.org</pre>
muestra: "Redmine web site":http://www.redmine.org
---
h2. Formato de texto
Para cosas como encabezados, negrita, listas, tablas, Redmine soporta la sintaxis Textile. Ver http://www.textism.com/tools/textile/ para información sobre el uso de cualquiera de éstas características. Algunos ejemplos son incluídos abajo pero hay muchas más opciones.
Estilo de la fuente
h3. Acrónimos
<pre>JPL(Juan Pérez López)</pre>
Muestra: JPL(Juan Pérez López)
h3. Estilo de fuentes
<pre>
* *negrita*
* _itálica_
* _*negrita itálica*_
* +subrayada+
* -tachada-
* Plano ^superíndice^
* Plano ~subíndice~
* @Elimina formatos@
</pre>
Muestra:
* *negrita*
* _itálica_
* _*negrita itálica*_
* +subrayada+
* -tachada-
* Plano ^superíndice^
* Plano ~subíndice~
* @Elimina formatos@
h3. Imágenes en línea
* *!imagen_url!* muestra una imágen que está en la dirección imagen_url (sintaxis textile)
* *!>imagen_url!* idem a la anterior pero alineada a la derecha
* !imagen_url(Título de la imágen)! muestra una imagen con un atributo alt/título
Si hay una imagen adjunta la página de la wiki, se puede visualizar en línea con el siguiente comando y el nombre del archivo: *!nombre_archivo.png!*
h3. Encabezados
<pre>
h1. Título
h2. Subtítulo
h3. Subsubtítulo
</pre>
Redmine asigna un ancla a cada uno de los encabezados para que puedan ser enlazados con "#Título", "#Subtítulo", etc.
h3. Párrafos
<pre>
p. alineación izquierda
p(. sangría izquierda 1 espacio
p((. sangría izquierda 2 espacios
así como para las líneas siguientes
p>. alineación derecha
p)))>. alineación derecha 3 espacios
p=. alineación Centrada
</pre>
h3. Predefinido
Para escapar de la sintaxis de la wiki:
<pre><pre> *Your text won't become bold* </pre></pre>
Display:
<pre> *Your text won't become bold* </pre>
h3. Tabulaciones
Empezar el párrafo con *bq.*
<pre>
bq. Rails es un completo framework para el desarrollo de respaldo de base de datos de aplicaciones web de acuerdo con el patrón Model-View-Control. Para ir a
producción, todo lo que necesitas es añadir una base de datos y un servidor web.
</pre>
Muestra:
bq. Rails es un completo framework para el desarrollo de respaldo de base de datos de aplicaciones web de acuerdo con el patrón Model-View-Control. Para ir a producción, todo lo que necesitas es añadir una base de datos y un servidor web.
h3. Tablas
<pre>
|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov |=. center |
|3|John Smith |Admin
(root)|^. valign top |
|4|- |Nobody
(anonymous)|~. valign bottom|
</pre>
Muestra (todos los espacios múltiples se sustituyen por un sólo espacio):
|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov |=. center |
|3|John Smith |Admin
(root)|^. valign top |
|4|- |Nobody
(anonymous)|~. valign bottom|
h3. Tabla de contenidos
*@{{toc}}@* => alineada a la izquierda
*@{{>toc}}@* => alineada a la derecha
---
h2. Macros
Redmine tiene los siguientes macros por defecto:
@hello_world@
p((. Ejemplo macro.
@include@
p((. Incluye una página de la wiki. Ejemplo:
{{include(Foo)}}
@macro_list@
p((. Muestra la lista de todos los macros disponibles incluyendo la descripción si está disponible.
---
h2. Resaltado de código
El resaltado de código se basa en "CodeRay":http://coderay.rubychan.de/, una rápida librería de resaltado escrita completamente en Ruby. Actualmente soporta c, html, javascript, rhtml, ruby, scheme, xml.
Se puede resaltar el código en la página de la wiki usando ésta sintaxis:
<pre><code class="ruby">
Insertar el código aquí.
</code></pre>
Ejemplo:
<pre><code class="ruby">
# The Greeter class
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hello #{@name}!"
end
end
</code></pre>