comparison public/help/fr/wiki_syntax_detailed.html @ 1464:261b3d9a4903 redmine-2.4

Update to Redmine 2.4 branch rev 12663
author Chris Cannam
date Tue, 14 Jan 2014 14:37:42 +0000
parents
children
comparison
equal deleted inserted replaced
1296:038ba2d95de8 1464:261b3d9a4903
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
3 <head>
4 <title>RedmineWikiFormatting</title>
5 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
6 <style type="text/css">
7 body { font:80% Verdana,Tahoma,Arial,sans-serif; }
8 h1, h2, h3, h4 { font-family: Trebuchet MS,Georgia,"Times New Roman",serif; }
9 pre, code { font-size:120%; }
10 pre code { font-size:100%; }
11 pre {
12 margin: 1em 1em 1em 1.6em;
13 padding: 2px;
14 background-color: #fafafa;
15 border: 1px solid #dadada;
16 width:95%;
17 overflow-x: auto;
18 }
19 a.new { color: #b73535; }
20
21 .syntaxhl .line-numbers { padding: 2px 4px 2px 4px; background-color: #eee; margin:0 }
22 .syntaxhl .comment { color:#666; }
23
24 .syntaxhl .class { color:#B06; font-weight:bold }
25 .syntaxhl .delimiter { color:black }
26 .syntaxhl .function { color:#06B; font-weight:bold }
27
28 .syntaxhl .inline { background: #eee }
29 .syntaxhl .inline .inline-delimiter { font-weight: bold; color: #888 }
30
31 .syntaxhl .instance-variable { color:#33B }
32 .syntaxhl .reserved { color:#080; font-weight:bold }
33
34 .syntaxhl .string { background-color:#fff0f0; color: #D20; }
35 .syntaxhl .string .delimiter { color:#710 }
36
37 </style>
38 </head>
39
40 <body>
41 <h1><a name="1" class="wiki-page"></a>Mise en page Wiki</h1>
42
43 <h2><a name="2" class="wiki-page"></a>Liens</h2>
44
45 <h3><a name="3" class="wiki-page"></a>Liens Redmine</h3>
46
47 <p>Redmine autorise les hyperliens entre différentes ressources (Demandes, révisions, pages wiki...) n'importe où la mise en page Wiki est utilisée.</p>
48 <ul>
49 <li>Lien vers une demande: <strong>#124</strong> (affiche <del><a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (Closed)">#124</a></del>, le lien est barré si la demande est fermée)</li>
50 <li>Lien vers une note d'une demande: <strong>#124-6</strong>, ou <strong>#124#note-6</strong></li>
51 </ul>
52
53 <p>Liens entre Wiki:</p>
54
55 <ul>
56 <li><strong>[[Guide]]</strong> affiche un lien vers la page nommé 'Guide': <a href="#" class="wiki-page">Guide</a></li>
57 <li><strong>[[Guide#balise-avancée]]</strong> vous emmène à la balise "balise-avancée". Les titres ont automatiquement une balise assignée afin de pouvoir s'y référer: <a href="#" class="wiki-page">Guide</a></li>
58 <li><strong>[[Guide|Manuel Utilisateur]]</strong> affiche un lien vers la même page mais avec un texte différent: <a href="#" class="wiki-page">Manuel Utilisateur</a></li>
59 </ul>
60
61 <p>Vous pouvez aussi faire des liens vers des pages du Wiki d'un autre projet:</p>
62
63 <ul>
64 <li><strong>[[sandbox:une page]]</strong> affiche un lien vers une page nommée 'Une page' du Wiki du projet Sandbox</li>
65 <li><strong>[[sandbox:]]</strong> affiche un lien vers la page principal du Wiki du projet Sandbox</li>
66 </ul>
67
68 <p>Les liens Wiki sont affichés en rouge si la page n'existe pas encore, ie: <a href="#" class="wiki-page new">Page inexistante</a>.</p>
69
70 <p>Liens vers d'autres ressources:</p>
71
72 <ul>
73 <li>Documents:
74 <ul>
75 <li><strong>document#17</strong> (lien vers le document dont l'id est 17)</li>
76 <li><strong>document:Salutations</strong> (lien vers le document dont le titre est "Salutations")</li>
77 <li><strong>document:"Un document"</strong> (Les guillements peuvent être utilisé quand le titre du document comporte des espaces)</li>
78 <li><strong>sandbox:document:"Un document"</strong> (Lien vers le document dont le titre est "Un document" dans le projet différent "sandbox")</li>
79 </ul></li>
80 </ul>
81
82 <ul>
83 <li>Versions:
84 <ul>
85 <li><strong>version#3</strong> (lien vers la version dont l'id est 3)</li>
86 <li><strong>version:1.0.0</strong> (lien vers la version nommée "1.0.0")</li>
87 <li><strong>version:"1.0 beta 2"</strong></li>
88 <li><strong>sandbox:version:1.0.0</strong> (lien vers la version nommée "1.0.0" dans le projet "sandbox")</li>
89 </ul></li>
90 </ul>
91
92 <ul>
93 <li>Pièces jointes:
94 <ul>
95 <li><strong>attachment:file.zip</strong> (lien vers la pièce jointe de l'objet nommée file.zip)</li>
96 <li>Pour le moment, seules les pièces jointes de l'objet peuvent être référencées (si vous êtes sur une demande, il est possibe de faire référence aux pièces jointes de cette demande uniquement)</li>
97 </ul></li>
98 </ul>
99
100 <ul>
101 <li>Révisions:
102 <ul>
103 <li><strong>r758</strong> (lien vers une révision)</li>
104 <li><strong>commit:c6f4d0fd</strong> (lien vers une révision sans référence numérique)</li>
105 <li><strong>svn1|r758</strong> (lien vers un dépôt spécifique, pour les projets ayant plusieurs dépôts)</li>
106 <li><strong>commit:hg|c6f4d0fd</strong> (lien vers une révision sans référence numérique d'un dépôt spécifique)</li>
107 <li><strong>sandbox:r758</strong> (Lien vers une révision d'un projet différent)</li>
108 <li><strong>sandbox:commit:c6f4d0fd</strong> (lien vers une révision sans référence numérique d'un autre projet)</li>
109 </ul></li>
110 </ul>
111
112 <ul>
113 <li>Fichier de dépôt:
114 <ul>
115 <li><strong>source:un/fichier</strong> (Lien vers le fichier situé dans /un/fichier dans le dépôt du projet)</li>
116 <li><strong>source:un/fichier@52</strong> (Lien vers le fichier de la révison 52)</li>
117 <li><strong>source:un/fichier#L120</strong> (Lien vers la ligne 120 du fichier fichier)</li>
118 <li><strong>source:un/fichier@52#L120</strong> (Lien vers la ligne 120 du fichier de la révison 52)</li>
119 <li><strong>source:"un fichier@52#L120"</strong> (Utilisez des guillemets quand l'url contient des espaces)</li>
120 <li><strong>export:un/fichier</strong> (Force le téléchargement du fichier)</li>
121 <li><strong>source:svn1|un/fichier</strong> (Lien vers le fichier dans un dépôt spécifique, pour les projets contenant plusieurs dépôts)</li>
122 <li><strong>sandbox:source:un/fichier</strong> (Lien vers le fichier situé dans /un/fichier dans le dépôt du projet "sandbox")</li>
123 <li><strong>sandbox:export:un/fichier</strong> (Force le téléchargement du fichier dans le dépôt du projet "sandbox")</li>
124 </ul></li>
125 </ul>
126
127 <ul>
128 <li>Messages du forum:
129 <ul>
130 <li><strong>message#1218</strong> (Lien vers le message dont l'id est 1218)</li>
131 </ul></li>
132 </ul>
133
134 <ul>
135 <li>Projet:
136 <ul>
137 <li><strong>project#3</strong> (Lien vers le projet dont l'id est 3)</li>
138 <li><strong>project:unprojet</strong> (Lien vers le projet nommé "unprojet")</li>
139 </ul></li>
140 </ul>
141
142
143 <p>Eviter ces lien:</p>
144
145 <ul>
146 <li>Vous pouvez empêcher les liens Redmine de se faire en les précédant d'un point d'exclamaion : !</li>
147 </ul>
148
149
150 <h3><a name="4" class="wiki-page"></a>Liens externes</h3>
151
152 <p>Les URLs HTTP et les adresses email sont automatiquement transformé en liens:</p>
153
154 <pre>
155 http://www.redmine.org, someone@foo.bar
156 </pre>
157
158 <p>affiche: <a class="external" href="http://www.redmine.org">http://www.redmine.org</a>, <a href="mailto:someone@foo.bar" class="email">someone@foo.bar</a></p>
159
160 <p>Si vous voulez afficher un texte spécifique à la place de l'URL, vous pouvez utilisez la syntaxe standard textile:</p>
161
162 <pre>
163 "Site Web Redmine":http://www.redmine.org
164 </pre>
165
166 <p>affiche: <a href="http://www.redmine.org" class="external">Site Web Redmine</a></p>
167
168
169 <h2><a name="5" class="wiki-page"></a>Formatage du texte</h2>
170
171
172 <p>Pour les éléments tel que, gras, tableau, listes, Redmine utilise la syntaxe Textile. Voir <a class="external" href="http://fr.wikipedia.org/wiki/Textile_%28langage%29">http://fr.wikipedia.org/wiki/Textile_(langage)</a> pour les informations sur l'utilisation de ces fonctionnalités. Quelques exemples sont inclus ci-dessous, mais le moteur est capable de beaucoup plus.</p>
173
174 <h3><a name="6" class="wiki-page"></a>Police d'écriture</h3>
175
176 <pre>
177 * *gras*
178 * _italique_
179 * _*gras _italique_*_
180 * +sous-ligné+
181 * -barré-
182 </pre>
183
184 <p>Affiche:</p>
185
186 <ul>
187 <li><strong>gras</strong></li>
188 <li><em>_italique_</em></li>
189 <li><em><strong>gras italique</strong></em></li>
190 <li><ins>sous-ligné</ins></li>
191 <li><del>barré</del></li>
192 </ul>
193
194 <h3><a name="7" class="wiki-page"></a>Afficher une image</h3>
195
196 <ul>
197 <li><strong>!url_de_l_image!</strong> affiche une image situé à l'adresse displays an image located at url_de_l_image (syntaxe Textile)</li>
198 <li><strong>!&gt;url_de_l_image!</strong> Image affichée à droite</li>
199 <li>Si vous avez une image en pièce jointe de votre page Wiki, elle peut être affiché en utilisant simplement sont nom: <strong>!image_en_piece_jointe.png!</strong></li>
200 </ul>
201
202 <h3><a name="8" class="wiki-page"></a>Titre</h3>
203
204 <pre>
205 h1. Titre
206 h2. Sous-titre
207 h3. Sous-sous-titre
208 </pre>
209
210 <p>Redmine assigne une balise à chacun de ses titres, vous pouvez donc les lier avec "#Titre", "#Sous-titre" et ainsi de suite.</p>
211
212
213 <h3><a name="9" class="wiki-page"></a>Paragraphes</h3>
214
215 <pre>
216 p&gt;. aligné à droite
217 p=. centré
218 </pre>
219
220 <p style="text-align:center;">Ceci est un paragraphe centré.</p>
221
222
223 <h3><a name="10" class="wiki-page"></a>Blockquotes</h3>
224
225 <p>Commencer le paragraphe par <strong>bq.</strong></p>
226
227 <pre>
228 bq. Ruby on Rails, également appelé RoR ou Rails est un framework web libre écrit en Ruby. Il suit le motif de conception Modèle-Vue-Contrôleur aussi nommé MVC.
229 Pour commencer à l'utiliser, il ne vous faut qu'un serveur web et une base de données.
230 </pre>
231
232 <p>Affiche</p>
233
234 <blockquote>
235 <p>Ruby on Rails, également appelé RoR ou Rails est un framework web libre écrit en Ruby. Il suit le motif de conception Modèle-Vue-Contrôleur aussi nommé MVC.<br />Pour commencer à l'utiliser, il ne vous faut qu'un serveur web et une base de données.</p>
236 </blockquote>
237
238
239 <h3><a name="11" class="wiki-page"></a>Table des matières</h3>
240
241 <pre>
242 {{toc}} =&gt; table des matières centrées à gauche
243 {{&gt;toc}} =&gt; table des matières centrées à droite
244 </pre>
245
246 <h3><a name="14" class="wiki-page"></a>Règle horizontale</h3>
247
248 <pre>
249 ---
250 </pre>
251
252 <h2><a name="12" class="wiki-page"></a>Macros</h2>
253
254 <p>Redmine possède les macros suivantes:</p>
255
256 <p><dl><dt><code>hello_world</code></dt><dd><p>Macro d'exemple.</p></dd><dt><code>include</code></dt><dd><p>Inclue une page Wiki. Exemple:</p>
257
258 <pre><code>{{include(Foo)}}</code></pre></dd><dt><code>macro_list</code></dt><dd><p>Affiche une liste de toute les macros disponilbes, les descriptions sont inclues si celles-ci sont disponibles.</p></dd></dl></p>
259
260
261 <h2><a name="13" class="wiki-page"></a>Coloration syntaxique</h2>
262
263 <p>La coloration syntaxique par défaut repose sur <a href="http://coderay.rubychan.de/" class="external">CodeRay</a>, une librairie rapide de coloration syntaxique complètement codée en Ruby. Elle supporte actuellement les langages C, C++, CSS, delphi, groovy, HTML, java, javascript, json, PHP, python, RHTML, ruby, scheme, SQL, XML et YAML.</p>
264
265 <p>Vous pouvez colorer votre code dans vos pages Wiki en utilisant la syntaxe suivante:</p>
266
267 <pre>
268 &lt;pre&gt;&lt;code class="ruby"&gt;
269 Placez votre code ici.
270 &lt;/code&gt;&lt;/pre&gt;
271 </pre>
272
273 <p>Exemple:</p>
274
275 <pre><code class="ruby syntaxhl"><span class="line-numbers"> 1</span> <span class="comment"># The Greeter class</span>
276 <span class="line-numbers"> 2</span> <span class="reserved">class</span> <span class="class">Greeter</span>
277 <span class="line-numbers"> 3</span> <span class="reserved">def</span> <span class="function">initialize</span>(name)
278 <span class="line-numbers"> 4</span> <span class="instance-variable">@name</span> = name.capitalize
279 <span class="line-numbers"> 5</span> <span class="reserved">end</span>
280 <span class="line-numbers"> 6</span>
281 <span class="line-numbers"> 7</span> <span class="reserved">def</span> <span class="function">salute</span>
282 <span class="line-numbers"> 8</span> puts <span class="string"><span class="delimiter">"</span><span class="content">Hello </span><span class="inline"><span class="inline-delimiter">#{</span><span class="instance-variable">@name</span><span class="inline-delimiter">}</span></span><span class="content">!</span><span class="delimiter">"</span></span>
283 <span class="line-numbers"> 9</span> <span class="reserved">end</span>
284 <span class="line-numbers"><strong>10</strong></span> <span class="reserved">end</span></code>
285 </pre>
286 </body>
287 </html>