Les bases de la rédaction d'un article

Table des matières

Introduction
Éditeur Wysiwyg
Quelques règles de bases

Introduction

Un wiki est un système de rédaction de texte qui n'est pas un traitement de texte.

Un traitement de texte permet autant de modifier le texte que son style et sa mise en forme.

Un wiki ne permet que de modifier le texte, en n'offrant qu'assez peu de possibilités de modification, et toute tentative de « forcer » le style ou la mise en forme amènera à des problèmes lors d'une éventuelle exportation ou d'un affichage sur un wiki adoptant une autre mise en page.

Attention, nous ne prétendons pas détenir la solution quant à l'écriture idéale d'un article de Wiki, néanmoins, par expérience, l'application de celles-ci facilite le travail de tout le monde.

Il n'est pas demandé à un rédacteur de connaître et appliquer toutes les règles, le plus important est de documenter et d'autres collaborateurs ont pour tâche de corriger et améliorer les articles déjà écrits.

Un rédacteur pourra même totalement oublier toutes ces règles tant que le contenu est pertinent, mais il ne devra pas s'étonner de possibles gros changements s'il revient par la suite modifier l'article.

Éditeur Wysiwyg

La majorité des possibilités d'un wiki ne sont accessibles que si l'on écrit son article directement en code wiki.

Il est néanmoins possible de passer par un éditeur, proche de celui d'un traitement de texte, permettant de mieux se rendre compte de ce que donnera l'article.

Mais cela ne devient vient vite plus le cas à l'utilisation de certaines particularités et il faut préférer passer par une écriture en code wiki avec des prévisualisations courantes.

Cet éditeur est activé afin de permettre à tous de créer des articles mais ne doit être utilisé que pour modifier des articles personnels ou mis en mode brouillon.

Merci aux rédacteurs de respecter les quelques règles de base suivantes.

Quelques règles de bases

Respecter la hiérarchie des titres

Jamais un titre de niveau 3 ou 4 suivra un titre de niveau 1. Un titre ne doit jamais être utilisé car son style correspond à ce que l'on veut « voir apparaître ». Ce qui suit un titre de niveau 1 est <a style=" text-transform: uppercase; font-weight: bold;">toujours</a> un titre de niveau 2.

Pas de majuscules inutiles

Mettre un titre tout en majuscule est une manière de « forcer » le style. Le gros problème de faire ainsi est que cela fait souvent passer des accents à la trappe car il est impossible d'écrire <a style=" text-transform: uppercase;">événement</a> sur un clavier Azerty sans avoir un driver de clavier personnalisé ou une très bonne connaissance des codes ASCII. Mais les styles permettent, si c'est ce que l'on veut, de « capitaliser » les textes afin que tous les caractères soient en majuscule, qu'ils aient été écrits en minuscule ou non.
Il est possible de créer un texte capitalisé au sein d'un article.

Pour cela il faut utiliser les balises HTML, dans lesquelles nous pouvons faire appel au CSS, ce qui est utilisé plus haut :

<html><a style=" text-transform: uppercase;">événement</a></html>

Si vous effectuez un copié-collé du texte, il sera donc copié en ne tenant compte que du texte et non de sa mise en forme :

Mais cela est à éviter et ne fonctionne que pour les textes, non pour les titres.

Pour les titres, si vous les voulez en majuscules, il faudra modifier le template DokuWiki et cette modification se fera alors pour l'ensemble des titres du Wiki.

Pas de lien dans un article

S'il faut intégrer un lien, il y a plusieurs possibilités :

un lien venant de ce wiki : Contact

  * un lien venant de ce wiki : [[:contact|Contact]]

un lien venant d'un autre wiki :
- Hackdoor commandée par RFID
- FabLab

  * un lien venant d'un autre wiki considéré comme « certifié » : 
    * [[doku>https://hack.ens.fr/projets/hackdoor|Hackdoor commandée par RFID]] 
    * [[wp>https://fr.wikipedia.org/wiki/Fab_lab|FabLab]]

Un lien extérieur ¹⁾ faisant apparaître le lien en référence en pied de page.

  * Un lien extérieur (([[https://www.tiers-lieux.be|Site tiers-lieux.be]])) faisant apparaître le lien en référence en pied de page.

¹⁾

Site tiers-lieux.be