Sintaxis avanzada

Versión 6 (Gonzalo Maqueira, 2012-03-01 12:07)

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