TWiki Raccourcis

Travailler sur TWiki est aussi facile que taper du texte, comme dans un courrier. Il n'est pas nécessaire de connaitre HTML, mais il est possible de l'utiliser. Les TWiki Raccourcis vous donnent tout le pouvoir d'HTML avec un système de codage simple et facile à apprendre en quelques minutes. Tout est expliqué ci-dessous - vous pouvez à ce tableau à partir d'une fenêtre "pop-up" que vous trouvez sur l'écran Edit.

Un lien hypertexte est créé automatiquement lorsque vous entrez un Mot Wiki. De deux choses l'une, si une page porte déjà ce nom dans le même espace de travail alors le lien est établi vers cette page, sinon un point d'interrogation apparaît après le Mot Wiki et vous invite à créer, immédiantement ou plus tard, une nouvelle page.

_Attention : cette traduction est incomplète !

outil de formatage: Exemple: Vous écrivez: Résultat:
Paragraphes:
une ligne vide crée un nouveau paragraphe.
1er paragraphe

2ème paragraphe
1er paragraphe

2ème paragraphe
les en-têtes:
Il faut mettre au moins 3 espaces au début de la ligne, suivis par le(s) signe(s) "plus" et le titre. Un "plus" crée un niveau 1 de titre (ce sera le titre le plus important), deux "plus" crée un niveau 2; le maximum est de 6 niveaux (ex: partie, titre, sous-titre, chapitre, section et paragraphe).

Note: un sommaire peut être crée automatiquement avec la variable %TOC% , voir Macros.
---++ Sushi

---+++ Maguro

Sushi

Maguro

Texte en gras:
les mots sont en gras en les encadrant d'astérisques *.
*Gras*
Gras
Texte en italiques:
Les mots sont en italiques en les encadrant avec des "underscores" _.
_Italiques_
Italiques
En gras et italiques:
Les mots sont en gras italiques en les encadrant _ de double-underscores.
__Gras italiques__
Gras italiques
Fixed Font:
Les mots apparaissent en police fixe en les entourant de signes d'égalité = .
=Police fixe=
Police fixe
Police fixe en gras:
Les mots apparaissent en police fixe en gras en les entourant de signes d'égalité en double .
==Gras fixe==
Gras fixe
Note: Soyez sûr/e/s de coller les signes * _ = == aux mots, par exemple il faut enlever les espaces.
_Cela marche_,
_Cela *ne* marche pas _

Cela marche,

_Cela ne marche pas _
Eviter le formatage - Mode "mot à mot":
Entourer les extraits de code et le texte formaté avec les balises <verbatim> and </verbatim> .
Note: Utilisez les balises <pre> et </pre> à la place si vous voulez que le code HTML soit interprété.
Note: Chaque balise doit avoir une ligne pour elle toute seule.
<verbatim>
la classe AnimalChat {
  nul ronronnement() {
    <code ici>
  }
}
</verbatim>
la classe AnimalChat {
  nul ronronnement() {
    <code ici>
  }
}
Séparateur:
Au moins 3 tirets au début de la ligne.
-------

Faire une liste:
Trois espaces suivis d'un astérisque.
   * élément de liste
  • élément de liste
Liste hiérarchisée wink :
Six, neuf, ... espaces suivi d'un astérisque.
      * liste hiérarchisée
    • liste hiérarchisée
Liste ordonnée :
Trois espaces suivi d'un chiffre.
   1 Sushi
   1 Dim Sum
  1. Sushi
  2. Dim Sum
Liste de définitions:
3 espaces, le terme, une colonne, un espace, suivis par la définition.
Note: Les termes avec des espaces ne sont pas supportés. Au cas où vous devez avoir un terme avec plus qu'un mot, séparez les mots avec des tiretss ou avec le caractère permettant de casser l'espace : &nbsp; .
   Sushi: Japon
   Dim&nbsp;Sum: S.F.
Sushi
Japon
Dim Sum
S.F.
Tableau:
Les espaces (facultatifs) sont suivis par des cellules qui sont enfermées par des barres verticales.
Note: | *gras* | cellules en tête du tableau.
Note: |   spaced   | cellules centrées et alignées.
Note: |     spaced | cellules alignées à droite.
Note: | 2 colspan || cellules couvrant plusieurs colonnes (voir exemple ci-contre).
Note: Au cas où vous avez une longue ligne et que vous la voulez plus lisible quand vous l'éditez, vous pouvez partager cette ligne en plusieurs qui finissent avec une barre oblique inverse '\' .
| *L* |  *C*  | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| multi span |||
| A4 \  | ma phrase est longue\  | celle-ci aussi |
L C R
A2 2 2
A3 3 3
multi span
A4 ma phrase est longue celle-ci aussi
Les liens Mot Wiki:
LesMotsAvecCapitalesCollesEnsemble (ou Mots Wiki, "WikiWords") produiront un lien automatiquement.
Note: Si vous voulez relier un thème ("topic") qui se trouve dans une autre zone ("web") de TWiki, écrivez NomdelaZone.NomduThème.
WebNotify

Know.ReadmeFirst
Web Notify

Readme First
Liens forcés:
Vous pouvez créer un lien interne forcé en encadrant les mots avec des doubles crochets.
Note: Le texte dans les crochets peut contenir des espaces, le nom du sujet est formé en enlevant les espaces et en mettant de lettres capitales; exemple [[text formatting FAQ]] lié au sujet Text Formatting FAQ. Vous pouvez aussi vous référer à une zone de TWiki différente et utiliser des ancres (ou liens hypertexte).
[[wiki syntax]]

[[Accueil.TWiki users]]
wiki syntax

Accueil.TWiki users
Liens spécifiques:
Créer un lien où vous pouvez spécifier le lien du texte et le lien de référence séparément, par l'utilisation de crochets imbriqués comme [[reference][text]]. Les références d'un lien interne (c-a-d Wiki Syntax) et les références d'un lien externe (c-a-d une url, http://TWiki.org/) sont possibles. Les mêmes règles Liens Forcés sont appliquées pour des références de lien interne. Les noms Ancres peuvent être ajoutés assez bien, comme [[TWiki.WebHome#MonAncre][allez à la maison]] et [[http://www.yahoo.com/#somewhere][Yahoo!]].
[[WikiSyntax][syntax]]

[[http://gnu.org][GNU]]
syntax

GNU
Ancres:
Vous pouvez définir un lien dans un sujet (appelé un nom ancré) et attacher à lui. Pour definir une ancre écrire #NomAncre au début de la ligne. Le nom ancré doit être un mot Wiki. Pour relier le nom d'une ancre utiliser cette syntaxe [[MyTopic#MyAnchor]] . Vous pouvez omettre le nom du sujet si vous voulez l'attacher au même sujet.
[[WebHome#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here
TWiki.Web Home#Not There

Jump

To here
Empecher un Lien:
Empecher qu'un Wiki Word deviennent un lien en ajoutant la balise <nop> .
<nop>SunOS
SunOS

L'utilisation d'HTML

Vous pouvez utiliser n'importe quelle balise HTML sans aucun problème, CEPENDANT, il est recommandé de ne pas le faire. En utilisant les TWiki Raccourcis, vous pouvez faire pratiquement tout ce vous pouviez faire avec le HTML, et cela garde le texte dégagé et facile au gens à modifier et parcourir.

Hyperliens

Etre capable de créer des liens, sans qu'un formatage soit requis, est au coeur de la caractéristique TWiki, possible grâce aux Mots Wiki (Wiki Words). Les nouvelles règles de Twiki pour la création de liens, sont une simple extension de la syntaxe qui fournit un ensembles d'options flexibles.

Liens Internes

  • Good Style est un Wiki Word qui permet d'accéder au thème TWiki.GoodStyle qui se trouve dans la zone Telem.

  • NExiste Pas Encore est un thème en attentre d'être écris. Pour le faire, il suffit de cliquer sur le "?" (essayez de cliquer puis faites Cancel (abandonner) car le faire sur ce document détruirait cet exemple!).

Liens Externes

  • http://..., https://..., ftp://... and mailto:...@... créés les liens automatiquement.

  • Les adresses Email ou courriels nom@domain.com créés des liens automatiquement.

Les variables TWiki

Macros sont des noms encadrés par des signes de pourcentage % that are expanded on the fly. L'utilisation de variables existantes, ainsi que celles que vous avez créées, ajoute un surprenant niveau supplémentaire au contenu de vos publications. Par exemple:

  • %TOC% : Génère automatiquement un sommaire du contenu à la tête d'un document - voyez le haut de cette page pour avoir un exemple.

  • %WEB% : La zone que vous utilisez maintenant est Wok.

  • %TOPIC% : Le thème que vous utilisez à cet instant est TWikiRaccourcis.

  • %ATTACHURL% : L'attache de l'URL du thème sur lequel vous êtes. Exemple d'utilisation : si vous attachez un fichier à un document vous pouver vous référer à lui
%ATTACHURL%/image.gif pour montrer l'URL du fichier ou l'image dans votre texte .

  • %INCLUDE{"SomeTopic"}% : Server side include, includes another topic. The current Telem web is the default web. Example: %INCLUDE{"TWiki.TWikiWebsTable"}%

  • There are many more variables, see Macros.

Les erreurs d'édition les plus communes

TWiki formatting rules are fairly simple to use and quick to type. However, there are some things to watch out for, taken from the Text Formatting FAQ:

  • Q: Text enclosed in angle brackets like <filename> is not displayed. How can I show it as it is?
    • A: The '<' and '>' characters have a special meaning in HTML, they define HTML tags. You need to escape them, so write '&lt;' instead of '<', and '&gt;' instead of '>'.
      Example: Type 'prog &lt;filename&gt;' to get 'prog <filename>'.

  • Q: Why is the '&' character sometimes not displayed?
    • A: The '&' character has a special meaning in HTML, it starts a so called character entity, i.e. '&copy;' is the © copyright character. You need to escape '&' to see it as it is, so write '&amp;' instead of '&'.
      Example: Type 'This &amp; that' to get 'This & that'.


-- version anglais: ShortHand

-- version original du Indymedia: http://docs.indymedia.org/view/TWiki/TWikiRaccourcis

-- Uwe Wahser - 06 Apr 2004: adaptation aux besoins du CNLS

-- Barakissa Tien - 11 Sep 2004

-- Thierry Pasquier - 15 May 2005
Topic revision: r5 - 23 Jul 2007, ThierryPasquier
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Telem? Send feedback