Sintaxis avanzada

Versión 1 (Gonzalo Maqueira, 2012-02-28 19:56)

1 1 Gonzalo Maqueira
h1. Formatos de la Wiki
2 1 Gonzalo Maqueira
3 1 Gonzalo Maqueira
h2. Enlaces
4 1 Gonzalo Maqueira
5 1 Gonzalo Maqueira
h3. Enlaces de Redmine
6 1 Gonzalo Maqueira
7 1 Gonzalo Maqueira
Redmine permite hipervínculos entre los temas, de cambios y las páginas wiki de formato wiki se utiliza en cualquier lugar.
8 1 Gonzalo Maqueira
9 1 Gonzalo Maqueira
   * Enlace a un tema: #124 (muestra #124, el enlace está tachado si la pteición está cerrada)
10 1 Gonzalo Maqueira
   * Enlace a cambios: r758 (muestra r758)
11 1 Gonzalo Maqueira
   * Enlace a cambios con ID no numérico: commit:c6f4d0fd (muestra c6f4d0fd). Added in r1236.
12 1 Gonzalo Maqueira
13 1 Gonzalo Maqueira
Enalces de la Wiki:
14 1 Gonzalo Maqueira
15 1 Gonzalo Maqueira
    * *@[[Guía]]@* se muestra un enlace a la página denominada "Guía": Guía
16 1 Gonzalo Maqueira
    * *@[[Guía#leer-mas]]@* lleva a "leer más". Los encabezados toman automáticamente los anclajes para que puedan ser referidos: Guía
17 1 Gonzalo Maqueira
    * *@[[Guía|Manual de Usuario]]@* se muestra un enlace a la misma página, pero con un texto diferente: Manual de Usuario
18 1 Gonzalo Maqueira
19 1 Gonzalo Maqueira
También puede vincular a las páginas de un wiki de otro proyecto:
20 1 Gonzalo Maqueira
21 1 Gonzalo Maqueira
    [[sandbox:alguna página]] muestra el enlace a la página llamada "alguna página" de la Wiki Sandbox
22 1 Gonzalo Maqueira
    [[sandbox:]] se muestra un enlace a la página principal de la Wiki Sandbox
23 1 Gonzalo Maqueira
24 1 Gonzalo Maqueira
Los Enlaces de la Wiki son mostrados en rojo si la página aún no existe: Página no existente.
25 1 Gonzalo Maqueira
26 1 Gonzalo Maqueira
Enlaces a otros recursos (0.7):
27 1 Gonzalo Maqueira
28 1 Gonzalo Maqueira
    Documentos:
29 1 Gonzalo Maqueira
        documento#17 (enlace al documento con id 17)
30 1 Gonzalo Maqueira
        documento:Saludos (enlace al documento con el título "Saludos")
31 1 Gonzalo Maqueira
        document:"Algún documento" (comillas dobles deben ser usadas cuando el título del documento contenga espacios)
32 1 Gonzalo Maqueira
33 1 Gonzalo Maqueira
    Versiones:
34 1 Gonzalo Maqueira
        version#3 (enlace a la versión con id 3)
35 1 Gonzalo Maqueira
        version:1.0.0 (enlace a la versión llamada "1.0.0")
36 1 Gonzalo Maqueira
        version:"1.0 beta 2"(comillas dobles deben ser usadas cuando la versión contenga espacios)
37 1 Gonzalo Maqueira
38 1 Gonzalo Maqueira
    Adjuntos:
39 1 Gonzalo Maqueira
        attachment:archivo.zip (enlace al adjunto llamado archivo.zip)
40 1 Gonzalo Maqueira
        Por ahora solamente se puede hacer referencia a adjuntos en el mismo item.
41 1 Gonzalo Maqueira
42 1 Gonzalo Maqueira
    Archivos del Repositorio
43 1 Gonzalo Maqueira
        source:algun/archivo -- Enlace a el archivo ubicado en /algun/archivo en el repositorio del proyecto
44 1 Gonzalo Maqueira
        source:algun/archivo@52 -- Enlace a la revisión 52 del archivo
45 1 Gonzalo Maqueira
        source:algun/archivo#L120 -- Enlace a la línea 120 del archivo
46 1 Gonzalo Maqueira
        source:algun/archivo@52#L120 -- Enlace a la línea 120 de la revisión 52 del archivo
47 1 Gonzalo Maqueira
        export:algun/archivo -- Forzar la bajada del archivo
48 1 Gonzalo Maqueira
49 1 Gonzalo Maqueira
Escape (0.7):
50 1 Gonzalo Maqueira
51 1 Gonzalo Maqueira
    Se puede prevenir que los enlaces sean analizados anteponiento el signo de exclamación: !
52 1 Gonzalo Maqueira
53 1 Gonzalo Maqueira
Enlaces externos
54 1 Gonzalo Maqueira
55 1 Gonzalo Maqueira
URLs HTTP y direcciones de correo electrónico se convierten automáticamente en enlaces:
56 1 Gonzalo Maqueira
57 1 Gonzalo Maqueira
http://www.redmine.org, someone@foo.bar
58 1 Gonzalo Maqueira
59 1 Gonzalo Maqueira
displays: http://www.redmine.org, someone@foo.bar
60 1 Gonzalo Maqueira
61 1 Gonzalo Maqueira
Si desea mostrar un texto específico en lugar de la URL, puede utilizar la sintaxis estándar:
62 1 Gonzalo Maqueira
63 1 Gonzalo Maqueira
"Redmine web site":http://www.redmine.org
64 1 Gonzalo Maqueira
65 1 Gonzalo Maqueira
muestra: Redmine web site
66 1 Gonzalo Maqueira
Formato de texto
67 1 Gonzalo Maqueira
68 1 Gonzalo Maqueira
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.
69 1 Gonzalo Maqueira
Estilo de la fuente
70 1 Gonzalo Maqueira
71 1 Gonzalo Maqueira
* *negrita*
72 1 Gonzalo Maqueira
* _itálica_
73 1 Gonzalo Maqueira
* _*negrita itálica*_
74 1 Gonzalo Maqueira
* +subrayada+
75 1 Gonzalo Maqueira
* -tachada-
76 1 Gonzalo Maqueira
77 1 Gonzalo Maqueira
Muestra:
78 1 Gonzalo Maqueira
79 1 Gonzalo Maqueira
    negrita
80 1 Gonzalo Maqueira
    itálica
81 1 Gonzalo Maqueira
    *negrita itálica*
82 1 Gonzalo Maqueira
    subrayada
83 1 Gonzalo Maqueira
    tachada
84 1 Gonzalo Maqueira
85 1 Gonzalo Maqueira
Imágenes en línea
86 1 Gonzalo Maqueira
87 1 Gonzalo Maqueira
    !imagen_url! muestra una imágen que está en la dirección imagen_url (sintaxis textile)
88 1 Gonzalo Maqueira
    !>imagen_url! idem a la anterior pero alineada a la derecha
89 1 Gonzalo Maqueira
    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!
90 1 Gonzalo Maqueira
91 1 Gonzalo Maqueira
Encabezados
92 1 Gonzalo Maqueira
93 1 Gonzalo Maqueira
h1. Título
94 1 Gonzalo Maqueira
h2. Subtítulo
95 1 Gonzalo Maqueira
h3. Subsubtítulo
96 1 Gonzalo Maqueira
97 1 Gonzalo Maqueira
Redmine asigna un ancla a cada uno de los encabezados para que puedan ser enlazados con "#Título", "#Subtítulo", etc.
98 1 Gonzalo Maqueira
Párrafos
99 1 Gonzalo Maqueira
100 1 Gonzalo Maqueira
p>. alineado a la derecha
101 1 Gonzalo Maqueira
p=. centrado
102 1 Gonzalo Maqueira
103 1 Gonzalo Maqueira
Este es un párrafo centrado.
104 1 Gonzalo Maqueira
Tabulaciones
105 1 Gonzalo Maqueira
106 1 Gonzalo Maqueira
Empezar el párrafo con bq.
107 1 Gonzalo Maqueira
108 1 Gonzalo Maqueira
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
109 1 Gonzalo Maqueira
To go live, all you need to add is a database and a web server.
110 1 Gonzalo Maqueira
111 1 Gonzalo Maqueira
Display:
112 1 Gonzalo Maqueira
113 1 Gonzalo Maqueira
    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.
114 1 Gonzalo Maqueira
115 1 Gonzalo Maqueira
Tabla de contenidos
116 1 Gonzalo Maqueira
117 1 Gonzalo Maqueira
{{toc}} => alineada a la izquierda
118 1 Gonzalo Maqueira
{{>toc}} => alineada a la derecha
119 1 Gonzalo Maqueira
120 1 Gonzalo Maqueira
Macros
121 1 Gonzalo Maqueira
122 1 Gonzalo Maqueira
Redmine tiene los siguientes macros por defecto:
123 1 Gonzalo Maqueira
124 1 Gonzalo Maqueira
hello_world
125 1 Gonzalo Maqueira
126 1 Gonzalo Maqueira
    Ejemplo macro.
127 1 Gonzalo Maqueira
include
128 1 Gonzalo Maqueira
129 1 Gonzalo Maqueira
    Incluye una página de la wiki. Ejemplo:
130 1 Gonzalo Maqueira
131 1 Gonzalo Maqueira
    {{include(Foo)}}
132 1 Gonzalo Maqueira
133 1 Gonzalo Maqueira
macro_list
134 1 Gonzalo Maqueira
135 1 Gonzalo Maqueira
    Muestra la lista de todos los macros disponibles incluyendo la descripción si está disponible.
136 1 Gonzalo Maqueira
137 1 Gonzalo Maqueira
Resaltado de código
138 1 Gonzalo Maqueira
139 1 Gonzalo Maqueira
El resaltado de código se basa en CodeRay, una rápida librería de resaltado escrita completamente en Ruby. Actualmente soporta c, html, javascript, rhtml, ruby, scheme, xml.
140 1 Gonzalo Maqueira
141 1 Gonzalo Maqueira
Se puede resaltar el código en la página de la wiki usando ésta sintaxis:
142 1 Gonzalo Maqueira
143 1 Gonzalo Maqueira
<pre><code class="ruby">
144 1 Gonzalo Maqueira
  Insertar el código aquí.
145 1 Gonzalo Maqueira
</code></pre>
146 1 Gonzalo Maqueira
147 1 Gonzalo Maqueira
Ejemplo:
148 1 Gonzalo Maqueira
149 1 Gonzalo Maqueira
 1 # The Greeter class
150 1 Gonzalo Maqueira
 2 class Greeter
151 1 Gonzalo Maqueira
 3   def initialize(name)
152 1 Gonzalo Maqueira
 4     @name = name.capitalize
153 1 Gonzalo Maqueira
 5   end
154 1 Gonzalo Maqueira
 6 
155 1 Gonzalo Maqueira
 7   def salute
156 1 Gonzalo Maqueira
 8     puts "Hello #{@name}!" 
157 1 Gonzalo Maqueira
 9   end
158 1 Gonzalo Maqueira
10 end