summaryrefslogtreecommitdiffstats
path: root/public/help/fr/wiki_syntax_detailed_textile.html
blob: 33c7f205489cc8fb1f4826edb128f370094d4012 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>RedmineWikiFormatting</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="../wiki_syntax_detailed.css" />
</head>

<body>
<h1><a name="1" class="wiki-page"></a>Mise en page Wiki</h1>

    <h2><a name="2" class="wiki-page"></a>Liens</h2>

        <h3><a name="3" class="wiki-page"></a>Liens Redmine</h3>

        <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>
        <ul>
            <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>
            <li>Link to an issue including tracker name and subject: <strong>##124</strong> (displays <a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (New)">Bug #124</a>: bulk edit doesn't change the category or fixed version properties)</li>
            <li>Lien vers une note d'une demande: <strong>#124-6</strong>, ou <strong>#124#note-6</strong></li>
            <li>Link to an issue note within the same issue: <strong>#note-6</strong></li>
        </ul>

        <p>Liens entre Wiki:</p>

        <ul>
            <li><strong>[[Guide]]</strong> affiche un lien vers la page nommé 'Guide': <a href="#" class="wiki-page">Guide</a></li>
            <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>
            <li><strong>[[#further-reading]]</strong> link to the anchor "further-reading" of the current page: <a href="#" class="wiki-page">#further-reading</a></li>
            <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>
        </ul>

        <p>Vous pouvez aussi faire des liens vers des pages du Wiki d'un autre projet:</p>

        <ul>
            <li><strong>[[sandbox:une page]]</strong> affiche un lien vers une page nommée 'Une page' du Wiki du projet Sandbox</li>
            <li><strong>[[sandbox:]]</strong> affiche un lien vers la page principal du Wiki du projet Sandbox</li>
        </ul>

        <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>

        <p>Liens vers d'autres ressources:</p>

        <ul>
            <li>Documents:
                <ul>
                    <li><strong>document#17</strong> (lien vers le document dont l'id est 17)</li>
                    <li><strong>document:Salutations</strong> (lien vers le document dont le titre est "Salutations")</li>
                    <li><strong>document:"Un document"</strong> (Les guillements peuvent être utilisé quand le titre du document comporte des espaces)</li>
                    <li><strong>sandbox:document:"Un document"</strong> (Lien vers le document dont le titre est "Un document" dans le projet différent "sandbox")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Versions:
                <ul>
                    <li><strong>version#3</strong> (lien vers la version dont l'id est 3)</li>
                    <li><strong>version:1.0.0</strong> (lien vers la version nommée "1.0.0")</li>
                    <li><strong>version:"1.0 beta 2"</strong></li>
                    <li><strong>sandbox:version:1.0.0</strong> (lien vers la version nommée "1.0.0" dans le projet "sandbox")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Pièces jointes:
                <ul>
                    <li><strong>attachment:file.zip</strong> (lien vers la pièce jointe de l'objet nommée file.zip)</li>
                    <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>
                </ul></li>
        </ul>

        <ul>
            <li>Révisions:
                <ul>
                    <li><strong>r758</strong>                       (lien vers une révision)</li>
                    <li><strong>commit:c6f4d0fd</strong>            (lien vers une révision sans référence numérique)</li>
                    <li><strong>svn1|r758</strong>                  (lien vers un dépôt spécifique, pour les projets ayant plusieurs dépôts)</li>
                    <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>
                    <li><strong>sandbox:r758</strong>               (Lien vers une révision d'un projet différent)</li>
                    <li><strong>sandbox:commit:c6f4d0fd</strong>    (lien vers une révision sans référence numérique d'un autre projet)</li>
                </ul></li>
        </ul>

        <ul>
             <li>Fichier de dépôt:
                <ul>
                    <li><strong>source:un/fichier</strong>           (Lien vers le fichier situé dans /un/fichier dans le dépôt du projet)</li>
                    <li><strong>source:un/fichier@52</strong>        (Lien vers le fichier de la révison 52)</li>
                    <li><strong>source:un/fichier#L120</strong>      (Lien vers la ligne 120 du fichier fichier)</li>
                    <li><strong>source:un/fichier@52#L120</strong>   (Lien vers la ligne 120 du fichier de la révison 52)</li>
                    <li><strong>source:"un fichier@52#L120"</strong> (Utilisez des guillemets quand l'url contient des espaces)</li>
                    <li><strong>export:un/fichier</strong>           (Force le téléchargement du fichier)</li>
                    <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>
                    <li><strong>sandbox:source:un/fichier</strong>   (Lien vers le fichier situé dans /un/fichier dans le dépôt du projet "sandbox")</li>
                    <li><strong>sandbox:export:un/fichier</strong>   (Force le téléchargement du fichier dans le dépôt du projet "sandbox")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Forums:
                <ul>
                    <li><strong>forum#1</strong> (link to forum with id 1</li>
                    <li><strong>forum:Support</strong> (link to forum named Support)</li>
                    <li><strong>forum:"Technical Support"</strong> (use double quotes if forum name contains spaces)</li>
                </ul></li>
        </ul>

        <ul>
            <li>Messages du forum:
                <ul>
                    <li><strong>message#1218</strong> (Lien vers le message dont l'id est 1218)</li>
                </ul></li>
        </ul>

        <ul>
            <li>Projet:
                <ul>
                    <li><strong>project#3</strong> (Lien vers le projet dont l'id est 3)</li>
                    <li><strong>project:unprojet</strong> (Lien vers le projet nommé "unprojet")</li>
                    <li><strong>project:"un projet"</strong> (use double quotes if project name contains spaces)</li>
                </ul></li>
        </ul>

        <ul>
            <li>News:
                <ul>
                    <li><strong>news#2</strong> (link to news item with id 2)</li>
                    <li><strong>news:Greetings</strong> (link to news item named "Greetings")</li>
                    <li><strong>news:"First Release"</strong> (use double quotes if news item name contains spaces)</li>
                </ul></li>
        </ul>

        <ul>
            <li>Users:
                <ul>
                    <li><strong>user#2</strong> (link to user with id 2)</li>
                    <li><strong>user:jsmith</strong> (Link to user with login jsmith)</li>
                    <li><strong>@jsmith</strong> (Link to user with login jsmith)</li>
                </ul>
            </li>
        </ul>

        <p>Eviter ces lien:</p>

        <ul>
            <li>Vous pouvez empêcher les liens Redmine de se faire en les précédant d'un point d'exclamaion : !</li>
        </ul>


        <h3><a name="4" class="wiki-page"></a>Liens externes</h3>

        <p>URLs (starting with: www, http, https, ftp, ftps, sftp and sftps) and email addresses are automatically turned into clickable links:</p>

<pre>
http://www.redmine.org, someone@foo.bar
</pre>

        <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>

        <p>Si vous voulez afficher un texte spécifique à la place de l'URL, vous pouvez utilisez la syntaxe standard textile:</p>

<pre>
"Site Web Redmine":http://www.redmine.org
</pre>

        <p>affiche: <a href="http://www.redmine.org" class="external">Site Web Redmine</a></p>


    <h2><a name="5" class="wiki-page"></a>Formatage du texte</h2>


    <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>

        <h3><a name="6" class="wiki-page"></a>Police d'écriture</h3>

<pre>
* *gras*
* _italique_
* _*gras _italique_*_
* +sous-ligné+
* -barré-
</pre>

        <p>Affiche:</p>

        <ul>
            <li><strong>gras</strong></li>
            <li><em>_italique_</em></li>
            <li><em><strong>gras italique</strong></em></li>
            <li><ins>sous-ligné</ins></li>
            <li><del>barré</del></li>
        </ul>

        <h3><a name="7" class="wiki-page"></a>Afficher une image</h3>

        <ul>
            <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>
            <li><strong>!&gt;url_de_l_image!</strong> Image affichée à droite</li>
            <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>
            <li>Images in your computer's clipboard can be pasted directly using Ctrl-v or Command-v.</li>
            <li>Image files can be dragged onto the text area in order to be uploaded and embedded.</li>
        </ul>

        <h3><a name="8" class="wiki-page"></a>Titre</h3>

<pre>
h1. Titre
h2. Sous-titre
h3. Sous-sous-titre
</pre>

        <p>Redmine assigne une balise à chacun de ses titres, vous pouvez donc les lier avec "#Titre", "#Sous-titre" et ainsi de suite.</p>


        <h3><a name="9" class="wiki-page"></a>Paragraphes</h3>

<pre>
p&gt;. aligné à droite
p=. centré
</pre>

        <p style="text-align:center;">Ceci est un paragraphe centré.</p>


        <h3><a name="10" class="wiki-page"></a>Blockquotes</h3>

        <p>Commencer le paragraphe par <strong>bq.</strong></p>

<pre>
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.
Pour commencer à l'utiliser, il ne vous faut qu'un serveur web et une base de données.
</pre>

        <p>Affiche</p>

        <blockquote>
                <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>
        </blockquote>


        <h3><a name="11" class="wiki-page"></a>Table des matières</h3>

<pre>
{{toc}} =&gt;  table des matières centrées à gauche
{{&gt;toc}} =&gt; table des matières centrées à droite
</pre>

        <h3><a name="14" class="wiki-page"></a>Règle horizontale</h3>

<pre>
---
</pre>

    <h2><a name="12" class="wiki-page"></a>Macros</h2>

    <p>Redmine possède les macros suivantes:</p>

    <p>
    <dl>
      <dt><code>hello_world</code></dt>
      <dd><p>Macro d'exemple.</p></dd>

      <dt><code>macro_list</code></dt>
      <dd><p>Affiche une liste de toutes les macros disponibles, les descriptions sont incluses si celles-ci sont disponibles.</p></dd>

      <dt><code>child_pages</code></dt>
      <dd><p>Affiche une liste des sous-pages. Sans argument, cela affiche les sous-pages de la page courante. Exemples :</p>
      <pre><code>{{child_pages}} -- peut être utilisé depuis une page wiki uniquement
{{child_pages(depth=2)}} -- affiche deux niveaux d'arborescence seulement</code></pre></dd>

      <dt><code>include</code></dt>
      <dd><p>Inclut une page Wiki. Exemple :</p>
      <pre><code>{{include(Foo)}}</code></pre>
      <p>ou pour inclure une page d'un wiki de projet spécifique :</p>
      <pre><code>{{include(projectname:Foo)}}</code></pre></dd>

      <dt><code>collapse</code></dt>
      <dd><p>Insère un bloc de texte enroulé. Exemple :</p>
      <pre><code>{{collapse(Voir les détails...)
Ceci est un bloc de texte qui est caché par défaut.
Il peut être déroulé en cliquant sur le lien.
}}</code></pre></dd>

      <dt><code>thumbnail</code></dt>
      <dd><p>Affiche une miniature cliquable d'une image jointe. Exemples :</p>
      <pre>{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Miniature)}}</pre></dd>
    </dl>
    </p>

    <h2><a name="13" class="wiki-page"></a>Coloration syntaxique</h2>

    <p>Default code highlightment relies on <a href="http://rouge.jneen.net/" class="external">Rouge</a>, a syntax highlighting library written in pure Ruby. It supports many commonly used languages such as <strong>c</strong>, <strong>cpp</strong> (c++), <strong>csharp</strong> (c#, cs), <strong>css</strong>, <strong>diff</strong> (patch, udiff), <strong>go</strong> (golang), <strong>groovy</strong>, <strong>html</strong>, <strong>java</strong>, <strong>javascript</strong> (js), <strong>kotlin</strong>, <strong>objective_c</strong> (objc), <strong>perl</strong> (pl), <strong>php</strong>, <strong>python</strong> (py), <strong>r</strong>, <strong>ruby</strong> (rb), <strong>sass</strong>, <strong>scala</strong>, <strong>shell</strong> (bash, zsh, ksh, sh), <strong>sql</strong>, <strong>swift</strong>, <strong>xml</strong> and <strong>yaml</strong> (yml) languages, where the names inside parentheses are aliases. Please refer to <a href="https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages" class="external">https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages</a> for the full list of supported languages.</p>

    <p>You can highlight code at any place that supports wiki formatting using this syntax (note that the language name or alias is case-insensitive):</p>

<pre>
&lt;pre&gt;&lt;code class="ruby"&gt;
  Placez votre code ici.
&lt;/code&gt;&lt;/pre&gt;
</pre>

    <p>Exemple:</p>

<pre><code class="ruby syntaxhl"><span class="c1"># The Greeter class</span>
<span class="k">class</span> <span class="nc">Greeter</span>
  <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="nb">name</span><span class="p">)</span>
    <span class="vi">@name</span> <span class="o">=</span> <span class="nb">name</span><span class="p">.</span><span class="nf">capitalize</span>
  <span class="k">end</span>

  <span class="k">def</span> <span class="nf">salute</span>
    <span class="nb">puts</span> <span class="s2">"Hello </span><span class="si">#{</span><span class="vi">@name</span><span class="si">}</span><span class="s2">!"</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
</body>
</html>