wiki_syntax_detailed.html
315 lines
| 14.4 KiB
| text/html
|
HtmlDjangoLexer
Toshi MARUYAMA
|
r11866 | <!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" /> | ||||
| <style type="text/css"> | ||||
| body { font:80% Verdana,Tahoma,Arial,sans-serif; } | ||||
| h1, h2, h3, h4 { font-family: Trebuchet MS,Georgia,"Times New Roman",serif; } | ||||
| pre, code { font-size:120%; } | ||||
| pre code { font-size:100%; } | ||||
| pre { | ||||
| margin: 1em 1em 1em 1.6em; | ||||
| padding: 2px; | ||||
| background-color: #fafafa; | ||||
| border: 1px solid #dadada; | ||||
| width:95%; | ||||
| overflow-x: auto; | ||||
| } | ||||
| a.new { color: #b73535; } | ||||
| .syntaxhl .line-numbers { padding: 2px 4px 2px 4px; background-color: #eee; margin:0 } | ||||
| .syntaxhl .comment { color:#666; } | ||||
| .syntaxhl .class { color:#B06; font-weight:bold } | ||||
| .syntaxhl .delimiter { color:black } | ||||
| .syntaxhl .function { color:#06B; font-weight:bold } | ||||
| .syntaxhl .inline { background: #eee } | ||||
| .syntaxhl .inline .inline-delimiter { font-weight: bold; color: #888 } | ||||
| .syntaxhl .instance-variable { color:#33B } | ||||
| .syntaxhl .reserved { color:#080; font-weight:bold } | ||||
| .syntaxhl .string { background-color:#fff0f0; color: #D20; } | ||||
| .syntaxhl .string .delimiter { color:#710 } | ||||
| </style> | ||||
| </head> | ||||
| <body> | ||||
|
Toshi MARUYAMA
|
r11879 | <h1><a name="1" class="wiki-page"></a>Mise en page Wiki</h1> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h2><a name="2" class="wiki-page"></a>Liens</h2> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="3" class="wiki-page"></a>Liens Redmine</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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>Lien vers une note d'une demande: <strong>#124-6</strong>, ou <strong>#124#note-6</strong></li> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <p>Liens entre Wiki:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <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>[[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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <p>Vous pouvez aussi faire des liens vers des pages du Wiki d'un autre projet:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <p>Liens vers d'autres ressources:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
| <li>Documents: | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
| <li>Versions: | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | <li><strong>version:"1.0 beta 2"</strong></li> | ||
|
Toshi MARUYAMA
|
r11879 | <li><strong>sandbox:version:1.0.0</strong> (lien vers la version nommée "1.0.0" dans le projet "sandbox")</li> | ||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Pièces jointes: | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Révisions: | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Fichier de dépôt: | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Messages du forum: | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <li><strong>message#1218</strong> (Lien vers le message dont l'id est 1218)</li> | ||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Projet: | ||
|
Toshi MARUYAMA
|
r11866 | <ul> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul></li> | ||
| </ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <p>Eviter ces lien:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li>Vous pouvez empêcher les liens Redmine de se faire en les précédant d'un point d'exclamaion : !</li> | ||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="4" class="wiki-page"></a>Liens externes</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <p>Les URLs HTTP et les adresses email sont automatiquement transformé en liens:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
| http://www.redmine.org, someone@foo.bar | ||||
| </pre> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <p>Si vous voulez afficher un texte spécifique à la place de l'URL, vous pouvez utilisez la syntaxe standard textile:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r11879 | "Site Web Redmine":http://www.redmine.org | ||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <p>affiche: <a href="http://www.redmine.org" class="external">Site Web Redmine</a></p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h2><a name="5" class="wiki-page"></a>Formatage du texte</h2> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="6" class="wiki-page"></a>Police d'écriture</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r11879 | * *gras* | ||
| * _italique_ | ||||
| * _*gras _italique_*_ | ||||
| * +sous-ligné+ | ||||
| * -barré- | ||||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <p>Affiche:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <li><strong>gras</strong></li> | ||
| <li><em>_italique_</em></li> | ||||
|
Toshi MARUYAMA
|
r12071 | <li><em><strong>gras italique</strong></em></li> | ||
|
Toshi MARUYAMA
|
r11879 | <li><ins>sous-ligné</ins></li> | ||
| <li><del>barré</del></li> | ||||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="7" class="wiki-page"></a>Afficher une image</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <ul> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r12093 | <li><strong>!>url_de_l_image!</strong> Image affichée à droite</li> | ||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | </ul> | ||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="8" class="wiki-page"></a>Titre</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r11879 | h1. Titre | ||
| h2. Sous-titre | ||||
| h3. Sous-sous-titre | ||||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <p>Redmine assigne une balise à chacun de ses titres, vous pouvez donc les lier avec "#Titre", "#Sous-titre" et ainsi de suite.</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="9" class="wiki-page"></a>Paragraphes</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r12093 | p>. aligné à droite | ||
|
Toshi MARUYAMA
|
r11879 | p=. centré | ||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <p style="text-align:center;">Ceci est un paragraphe centré.</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <h3><a name="10" class="wiki-page"></a>Blockquotes</h3> | ||||
|
Toshi MARUYAMA
|
r11879 | <p>Commencer le paragraphe par <strong>bq.</strong></p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r11879 | 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. | ||||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <p>Affiche</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <blockquote> | ||||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | </blockquote> | ||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="11" class="wiki-page"></a>Table des matières</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
|
Toshi MARUYAMA
|
r12093 | {{toc}} => table des matières centrées à gauche | ||
| {{>toc}} => table des matières centrées à droite | ||||
|
Toshi MARUYAMA
|
r11866 | </pre> | ||
|
Toshi MARUYAMA
|
r11879 | <h3><a name="14" class="wiki-page"></a>Règle horizontale</h3> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
| --- | ||||
| </pre> | ||||
| <h2><a name="12" class="wiki-page"></a>Macros</h2> | ||||
|
Toshi MARUYAMA
|
r11879 | <p>Redmine possède les macros suivantes:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
Jean-Baptiste Barth
|
r13020 | <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> | ||||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <h2><a name="13" class="wiki-page"></a>Coloration syntaxique</h2> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <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> | ||
|
Toshi MARUYAMA
|
r11866 | |||
|
Toshi MARUYAMA
|
r11879 | <p>Vous pouvez colorer votre code dans vos pages Wiki en utilisant la syntaxe suivante:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre> | ||||
| <pre><code class="ruby"> | ||||
|
Toshi MARUYAMA
|
r11879 | Placez votre code ici. | ||
|
Toshi MARUYAMA
|
r11866 | </code></pre> | ||
| </pre> | ||||
|
Toshi MARUYAMA
|
r11879 | <p>Exemple:</p> | ||
|
Toshi MARUYAMA
|
r11866 | |||
| <pre><code class="ruby syntaxhl"><span class="line-numbers"> 1</span> <span class="comment"># The Greeter class</span> | ||||
| <span class="line-numbers"> 2</span> <span class="reserved">class</span> <span class="class">Greeter</span> | ||||
| <span class="line-numbers"> 3</span> <span class="reserved">def</span> <span class="function">initialize</span>(name) | ||||
| <span class="line-numbers"> 4</span> <span class="instance-variable">@name</span> = name.capitalize | ||||
| <span class="line-numbers"> 5</span> <span class="reserved">end</span> | ||||
| <span class="line-numbers"> 6</span> | ||||
| <span class="line-numbers"> 7</span> <span class="reserved">def</span> <span class="function">salute</span> | ||||
| <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> | ||||
| <span class="line-numbers"> 9</span> <span class="reserved">end</span> | ||||
| <span class="line-numbers"><strong>10</strong></span> <span class="reserved">end</span></code> | ||||
| </pre> | ||||
| </body> | ||||
| </html> | ||||