Manual

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><pre><code class="ruby">

  Insertar el código aquí.

</code></pre></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>