FrRedmineWikiFormatting » History » Version 1

Fabrice Phung, 2008-05-02 22:58
traduction du guide version 02052008

1 1 Fabrice Phung
h1. Formalisme Wiki
2 1 Fabrice Phung
3 1 Fabrice Phung
{{>TOC}}
4 1 Fabrice Phung
5 1 Fabrice Phung
h2. Liens
6 1 Fabrice Phung
7 1 Fabrice Phung
h3. Liens Redmine
8 1 Fabrice Phung
9 1 Fabrice Phung
Redmine permet les hyperliens entre demandes, changesets et pages wiki partout où le formalisme wiki est utilisé.
10 1 Fabrice Phung
11 1 Fabrice Phung
* Lien vers une demande: *!#124* (affiche #124, le lien est barré si la demande est fermée)
12 1 Fabrice Phung
* Lien vers un changeset: *!r758* (affiche r758)
13 1 Fabrice Phung
* Lien vers un changeset avec un hachage non numérique: *commit:"c6f4d0fd"* (affiche c6f4d0fd).  Ajouté dans r1236.
14 1 Fabrice Phung
15 1 Fabrice Phung
Liens wiki:
16 1 Fabrice Phung
17 1 Fabrice Phung
* *[[Guide]]* affiche un lien vers la page nommée 'Guide': [[Guide]]
18 1 Fabrice Phung
* *[[Guide|Manuel utilisateur]]* affiche un lien vers la même page mais avec un texte différent: [[Guide|Manuel utilisateur]]
19 1 Fabrice Phung
20 1 Fabrice Phung
Vous pouvez aussi établir des liens vers les pages wiki d'autre projets:
21 1 Fabrice Phung
22 1 Fabrice Phung
* *[[bacasable:une page]]* affiche un lien vers la page nommée 'Une page' du wiki de Bacasable
23 1 Fabrice Phung
* *[[bacasable:]]* affiche un lien vers la page principale du wiki de Bacasable
24 1 Fabrice Phung
25 1 Fabrice Phung
Les liens wiki sont affichés en rouge lorsque la page n'existe pas encore, exemple: [[Page inexistante]].
26 1 Fabrice Phung
27 1 Fabrice Phung
Liens vers d'autres ressources (0.7):
28 1 Fabrice Phung
29 1 Fabrice Phung
* Documents:
30 1 Fabrice Phung
31 1 Fabrice Phung
  * *!document#17* (lien vers le document portant l'id 17)
32 1 Fabrice Phung
  * *!document:Greetings* (lien vers le document dont le titre est "Greetings")
33 1 Fabrice Phung
  * *!document:"un document"* (les guillements peuvent être utilisés lorsqu'un titre de document comporte des espaces)
34 1 Fabrice Phung
35 1 Fabrice Phung
* Versions:
36 1 Fabrice Phung
37 1 Fabrice Phung
  * *!version#3* (lien vers la version portant l'id 3)
38 1 Fabrice Phung
  * *!version:1.0.0* (lien vers la version nommée "1.0.0")
39 1 Fabrice Phung
  * *!version:"1.0 beta 2"*
40 1 Fabrice Phung
41 1 Fabrice Phung
* Pièces jointes:
42 1 Fabrice Phung
43 1 Fabrice Phung
  * *!attachment:fichier.zip* (lien vers la pièce jointe de l'objet courant nommée fichier.zip)
44 1 Fabrice Phung
  * Pour l'instant, seules les pièces jointes de l'objet courant peuvent être référencées (si vous êtes dans une demande, seules les pièces jointes de cette demande peuvent être référencées)
45 1 Fabrice Phung
46 1 Fabrice Phung
* Fichiers du dépôt
47 1 Fabrice Phung
48 1 Fabrice Phung
  * *source:un/fichier*          -- Lien vers le fichier situé à /un/fichier dans le dépôt du projet
49 1 Fabrice Phung
  * *source:un/fichier@52*       -- Lien vers la révision 52 du fichier
50 1 Fabrice Phung
  * *source:un/fichier#L120*     -- Lien vers la ligne 120 du fichier
51 1 Fabrice Phung
  * *source:un/fichier@52#L120*  -- Lien vers la ligne 120 de la révision 52 du fichier
52 1 Fabrice Phung
  * *export:un/fichier*          -- Force le téléchargement du fichier
53 1 Fabrice Phung
54 1 Fabrice Phung
Echappement (0.7):
55 1 Fabrice Phung
56 1 Fabrice Phung
* Vous pouvez empêcher les liens Redmine d'être interprêtés en les faisant précéder d'un point d'exclamation: !
57 1 Fabrice Phung
58 1 Fabrice Phung
h3. Liens externes
59 1 Fabrice Phung
60 1 Fabrice Phung
HTTP URLs et adresses de messagerie sont autoamtiquement convertis en liens cliquables: 
61 1 Fabrice Phung
62 1 Fabrice Phung
<pre>
63 1 Fabrice Phung
http://www.redmine.org, untel@foo.bar
64 1 Fabrice Phung
</pre>
65 1 Fabrice Phung
66 1 Fabrice Phung
affiche: http://www.redmine.org, untel@foo.bar
67 1 Fabrice Phung
68 1 Fabrice Phung
Si vous voulez afficher un texte spécifique à la place de l'URL, vous pouvez utiliser la syntaxe textile standarde:
69 1 Fabrice Phung
70 1 Fabrice Phung
<pre>
71 1 Fabrice Phung
"site web Redmine":http://www.redmine.org
72 1 Fabrice Phung
</pre>
73 1 Fabrice Phung
74 1 Fabrice Phung
affiche: "site web Redmine":http://www.redmine.org
75 1 Fabrice Phung
76 1 Fabrice Phung
h2. Formatage de texte
77 1 Fabrice Phung
78 1 Fabrice Phung
Pour les choses du genre titres, gas, tableaux, listes, Redmine supporte la syntaxe Textile. Voir http://hobix.com/textile/ pour 
79 1 Fabrice Phung
information sur l'utilisation de ces fonctionnalités. Quelques exemples sont proposés ci-dessous, mais le moteur est capable de bien plus.
80 1 Fabrice Phung
81 1 Fabrice Phung
h3. Style de police
82 1 Fabrice Phung
83 1 Fabrice Phung
<pre><code>* *gras*
84 1 Fabrice Phung
* _italique_
85 1 Fabrice Phung
* _*gras italique*_
86 1 Fabrice Phung
* +souligné+
87 1 Fabrice Phung
* -barré-
88 1 Fabrice Phung
</code></pre>
89 1 Fabrice Phung
90 1 Fabrice Phung
Affiche:
91 1 Fabrice Phung
92 1 Fabrice Phung
 * *gras*
93 1 Fabrice Phung
 * _italique_
94 1 Fabrice Phung
 * _*gras italique*_
95 1 Fabrice Phung
 * +souligné+
96 1 Fabrice Phung
 * -barré-
97 1 Fabrice Phung
98 1 Fabrice Phung
h3. Images en ligne
99 1 Fabrice Phung
100 1 Fabrice Phung
* *&#33;image_url&#33;* affiche une image située à image_url (syntaxe textile)
101 1 Fabrice Phung
* *&#33;>image_url&#33;* image flottante à droite
102 1 Fabrice Phung
* Si vous avez attaché une image à votre page wiki, elle peut être affichée en ligne en utilisant son nom de fichier: *&#33;attached_image.png&#33;*
103 1 Fabrice Phung
104 1 Fabrice Phung
h3. Titres
105 1 Fabrice Phung
106 1 Fabrice Phung
<pre><code>h1. Titre
107 1 Fabrice Phung
h2. Sous-titre
108 1 Fabrice Phung
h3. Sous-titre
109 1 Fabrice Phung
</code></pre>
110 1 Fabrice Phung
111 1 Fabrice Phung
h3. Paragraphes
112 1 Fabrice Phung
113 1 Fabrice Phung
<pre><code>p>. aligné à gauche
114 1 Fabrice Phung
p=. centré
115 1 Fabrice Phung
</code></pre>
116 1 Fabrice Phung
117 1 Fabrice Phung
p=. Ceci est un paragraphe centré.
118 1 Fabrice Phung
119 1 Fabrice Phung
h3. Citations
120 1 Fabrice Phung
121 1 Fabrice Phung
Débutez le paragraphe avec *bq.*
122 1 Fabrice Phung
123 1 Fabrice Phung
<pre><code>bq. Rails est un framework complet pour développer des applications reposant sur une base de données,
124 1 Fabrice Phung
en conformité avec le motif Modèle-Vue-Contrôleur.
125 1 Fabrice Phung
Pour démarrer, vous avez seulement besoin d'une base de données et d'un serveur web.
126 1 Fabrice Phung
</code></pre>
127 1 Fabrice Phung
128 1 Fabrice Phung
Affiche:
129 1 Fabrice Phung
130 1 Fabrice Phung
bq.  Rails est un framework complet pour développer des applications reposant sur une base de données, en conformité avec le motif Modèle-Vue-Contrôleur.
131 1 Fabrice Phung
Pour démarrer, vous avez seulement besoin d'une base de données et d'un serveur web.
132 1 Fabrice Phung
133 1 Fabrice Phung
h3. Table des matières
134 1 Fabrice Phung
135 1 Fabrice Phung
<pre><code>{{toc}} => table des matières alignée à gauche
136 1 Fabrice Phung
{{>toc}} => table des matières alignée à droite
137 1 Fabrice Phung
</code></pre>
138 1 Fabrice Phung
139 1 Fabrice Phung
h2. Macros
140 1 Fabrice Phung
141 1 Fabrice Phung
Redmine propose d'emblée les macros suivantes:
142 1 Fabrice Phung
143 1 Fabrice Phung
{{macro_list}}
144 1 Fabrice Phung
145 1 Fabrice Phung
h2. Coloration syntaxique
146 1 Fabrice Phung
147 1 Fabrice Phung
La coloration syntaxique repose sur "CodeRay":http://coderay.rubychan.de/, une librairie rapide de coloration syntaxique écrite entièrement en Ruby. Elle supporte actuellement les langages c, html, javascript, rhtml, ruby, scheme, xml.
148 1 Fabrice Phung
149 1 Fabrice Phung
Vous pouvez mettre en valeur le code dans vos pages wiki en utilisant cette syntaxe:
150 1 Fabrice Phung
151 1 Fabrice Phung
<pre><code><pre><code class="ruby">
152 1 Fabrice Phung
  placez votre code ici.
153 1 Fabrice Phung
</code></pre>
154 1 Fabrice Phung
</pre></code>
155 1 Fabrice Phung
156 1 Fabrice Phung
Exemple:
157 1 Fabrice Phung
158 1 Fabrice Phung
<pre><code class="ruby">
159 1 Fabrice Phung
# The Greeter class
160 1 Fabrice Phung
class Greeter
161 1 Fabrice Phung
  def initialize(name)
162 1 Fabrice Phung
    @name = name.capitalize
163 1 Fabrice Phung
  end
164 1 Fabrice Phung
165 1 Fabrice Phung
  def salute
166 1 Fabrice Phung
    puts "Hello #{@name}!"
167 1 Fabrice Phung
  end
168 1 Fabrice Phung
end
169 1 Fabrice Phung
</pre></code>