Guide de formatage · 3 min read · Oct 07, 2025
Guide de formatage de tutoriel
Guide de formatage de tutoriel
Version 1.3
Si vous souhaitez publier un tutoriel sur HowtoForge, veuillez lire ce guide pour apprendre à formater votre tutoriel afin qu’il s’intègre dans l’apparence et la convivialité de HowtoForge et qu’il soit attrayant pour le plus grand nombre de lecteurs possible. Ces directives vous aident également à minimiser la taille de votre document.
1 Quel programme dois-je utiliser pour écrire mon HowTo ?
Utilisez un éditeur HTML comme Dreamweaver ou l’alternative gratuite Bluegriffon http://www.bluegriffon.org/ ou tout autre éditeur HTML qui crée du HTML valide. N’utilisez pas MS Word pour produire du contenu HTML car Word produit du HTML “étrange”…
2 Comment commencer ?
D’accord, vous êtes assis devant votre éditeur HTML, prêt à commencer, mais quelle est la suite ? Veuillez copier ce squelette HTML dans votre éditeur :
| |
Maintenant, vous écrivez votre tutoriel entre les balises
et .3 Formatage
3.1 Texte normal
Utilisez toujours la police par défaut pour le texte normal et les titres ! N’utilisez pas de balises , et ne définissez pas vos propres classes CSS. Tout le formatage sera effectué par les classes CSS de HowtoForge après que vous ayez publié votre tutoriel sur HowtoForge.
Par exemple, quelque chose comme
Ceci est une phrase.
devrait être évité. Utilisez simplement
Ceci est une phrase.
à la place. Sur HowtoForge, cela ressemblera à ceci :
Ceci est une phrase.
3.2 Titres
Veuillez utiliser
…
,…
,…
,…
, ou…
pour formater les titres. Encore une fois, n’utilisez pas de balises ou de classes CSS pour les formater.Le titre
Ceci est un titre
ressemblera à ceci sur HowtoForge :
Ceci est un titre
3.3 Commandes
Veuillez utiliser la classe CSS .command (définie dans la section
… du squelette HTML) pour formater les commandes shell afin que le lecteur sache qu’il s’agit de quelque chose qu’il doit exécuter dans le shell. Par exemple,chmod 755 /path/to/file
ressemblera à ceci sur HowtoForge :
chmod 755 /path/to/file3.4 Contenu des fichiers
Le contenu des fichiers doit être encadré par
…. Par exemple, si vous souhaitez montrer à vos lecteurs le contenu de /etc/resolv.conf, vous le faites comme ceci :
search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.60
Cela ressemblera à ceci sur HowtoForge :
search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.603.5 Noms de fichiers, noms de protocoles, spécifications système, spécifications techniques, etc.
Si vous écrivez sur des éléments liés au système Linux qui ne sont pas des commandes, mais que vous souhaitez qu’ils soient formatés d’une manière spéciale néanmoins, vous pouvez utiliser la classe CSS .system. Par exemple, si vous mentionnez un nom de fichier dans le texte normal, il est bon de le formater comme ceci :
Ensuite, nous modifions /etc/network/interfaces pour qu'il ressemble à ceci :...
Sur HowtoForge, cela ressemblera à ceci :
Ensuite, nous modifions /etc/network/interfaces pour qu’il ressemble à ceci :…
3.6 Mise en évidence
Si vous souhaitez mettre en évidence quelque chose, vous pouvez utiliser la classe CSS .highlight. Par exemple,
server1 :
ressemble à ceci :
server1 :
5 Images
Veuillez ne pas utiliser d’images qui dépassent 550 pixels de large !
4 Publiez votre tutoriel
Veuillez zipper votre tutoriel (fichier HTML créé selon les chapitres 1 - 3) avec les images et envoyer le fichier zip à [email protected]. Veuillez inclure votre nom d’utilisateur HowtoForge dans l’e-mail afin que nous puissions publier le tutoriel sous votre nom.
6 Approbation de l’administrateur
Votre nouveau tutoriel ne sera pas disponible au public immédiatement. Un de nos administrateurs le vérifiera (formatage, contenu, etc.), et très probablement votre tutoriel sera approuvé. Ensuite, il sera disponible sur HowtoForge.
Recevez de nouveaux articles dans votre boîte de réception.
Aucun spam. Désabonnez-vous à tout moment.