Un article commence TOUJOURS par une introduction qui n’est pas numérotée (regardez dans le magazine, il y a une lettrine sur la première lettre de cette section). L’objectif étant le plus souvent possible (si le thème s’y prête) de partir d’un cas concret puis de détailler sa résolution (le cas concret pouvant être un prétexte à la présentation d’une notion théorique également), présentez l’objectif dans l’introduction.
Pour avoir une évaluation du nombre de pages qu’occupera votre article
dans le magazine utilisez la macro Stats_DiamondEditions() fournie
(ajoutez environ 1 page toutes les 4 figures). Attention, il ne s’agit
que d’une estimation. La majeure partie des articles font entre 6 et
10 pages mais il n’y a pas vraiment de limite basse ou haute (bien sûr
il sera difficile de publier un article d’un quart de page ou de 50
pages… ;-)).
Pour les termes techniques, très spécifiques au domaine (n’oubliez pas que les devs lisent des articles sysadmin et réciproquement), je vous recommande l’utilisation d’encadrés contenant la définition ou le rappel technique.
Paragraphe en style « Normal » (et non « Standard » ou « Corps de texte »).
# Ceci est du code
# Une entrée typique de menu.lst
# Le style employé est « code »
title= DEBIAN GNU/Linux 2.6.24 (hdc3 - ext3)
kernel= (hd1,2)/boot/vmlinuz-2.6.24-1-686 root=/dev/hdc3 vga=extended
initusrd (hd1,2)/boot/initrd.img-2.6.24-1-686
Paragraphe en « Normal ». On fait ici mention d’un élément de la
configuration : l’étiquette title (style de caractère « code_par »
pour du code dans du texte) permet d’ajouter un titre dans les menus
de GRUB. La commande grub-install permet l’installation du bootloader
(Attention ! Cet italique est généré par le style de caractère
« italic » et non par l’icône italique de LibreOffice, idem pour le
gras). Nous pouvons spécifier le mode graphique à utiliser avec
l’option ~vga~ :
01: # Une entrée typique de menu.lst
02: title= DEBIAN GNU/Linux 2.6.24 (hdc3 - ext3)
03: kernel= (hd1,2)/boot/vmlinuz-2.6.24-1-686 root=/dev/hdc3 ~vga=extended~
04: initrd (hd1,2)/boot/initrd.img-2.6.24-1-686
Si vous souhaitez faire référence à des lignes de code pour les expliquer, vous pouvez les numéroter comme dans le code ci-dessus. Essayez de commenter votre code et vos commandes shell de manière à ne pas avoir d’immenses blocs de code ou de sorties shell qui rendent l’article illisible.
Pour une note apparaissant dans l’article final il faut seulement supprimer le terme PAO :
Les indications en style « pragma », comme ci-dessus, doivent toujours être encadrées de 3 slashs ///…///.
Si vous souhaitez une note ayant pour titre : Avertissement ou Attention (avec la petite icône associée), il faut utiliser :
Les sessions de commandes interactives sont à utiliser avec le style de paragraphe « console ». On peut également mettre en évidence certaines parties, grâce au style de caractère « code_em » :
#+ATTR_LINUXMAG-FR: :type console
$ cat dma
2: floppy
3: ~parport0~ # mise en évidence avec ~code_em~
4: cascade
Le prompt en utilisateur standard est $ et en root il s’agit de #.
#+ATTR_LINUXMAG-FR: :titre Titre encadré
Plus d’informations sur GRUB sur le site officiel : http://www.gnu.org/software/grub/ (notez l’utilisation du style de caractère « url » et la désactivation de l’hyperlien).
Vous pouvez également insérer des listes à puces ou numérotées dans votre article, comme ceci :
- item 1 ;
- item 2 ;
- item 3 ;
- etc.
Notez que nous n’utilisons pas les puces/numérotations automatiques de LibreOffice ici !!
De même, les tableaux doivent être présentés le plus simplement possible, le contenu doit être en style « Normal », par exemple :
| blabla | blabla | blabla |
| blabla | blabla | blabla |
Les références, à mettre en style « gras », doivent être intégrées dans le discours du texte et leur étiquette sera un nombre (attention à bien respecter un ordre croissant 1, 2, 3, etc.). Exemple : Comme on peut le voir sur le site de Linux Magazine et dans l’article de T. Colombo, blablablabla blablabla. C’est seulement lorsqu’une citation apparaît dans le texte quelle peut être développée dans la section « Références » en fin d’article. Dans cette section il faudra donner des références bibliographiques ou des urls mais il faudra indiquer aussi à quoi elles correspondent (voir le format à respecter en fin d’article dans la section « Références »).
N’intégrez pas vos images dans le fichier LibreOffice, mais faites-en mention avec le style « pragma ». Les fichiers images seront placés dans le même répertoire que l’article et leur nom sera composé à partir du nom de l’article et de leur position dans celui-ci. Il devra en outre toujours être précédé d’un underscore. Vous devez également toujours faire référence à une figure dans le texte : comme on peut le voir en figure my-figure, … ou encore (voir figure my-figure)).
Lorsqu’on décrit une interface graphique ou texte (pas les lignes de commandes, les interfaces en mode texte comme Midnight Commander par exemple), il est possible de faire référence aux menus et options avec le style de caractères « menu ». Exemple : Cochez l’option Auto-connexion dans la fenêtre des options qui apparaît via le menu Fichier > Préférences.
Lorsque vous indiquez des noms de touches appliquez le style gras et encadrez la touche par des < et > : <Ctrl> + <C> par exemple.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Attention à l’enchaînement des sections et sous-sections ! Il ne peut pas y avoir de section 1.1 s’il n’y a pas de 1.2, ni de 3.2.1 sans 3.2.2 !
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla. Bla blabla bla blabla, bla bla bla blabla.
La conclusion ne comporte pas de numérotation. Il s’agit de la dernière section de l’article.
N’oubliez pas que pour vous faciliter la tâche, un fichier de raccourcis clavier ainsi que des directives de configuration de LibreOffice sont à votre disposition sur https://github.com/GLMF/outils_auteurs.
<<1>> Base documentaire de /GNU/Linux Magazine/ : https://connect.ed-diamond.com/gnu-linux-magazine
<<2>> COLOMBO T., « Titre de l’article », GNU/Linux Magazine n°254, décembre 2021, p. x à y
<<3>> NOM P. et AUTRENOM P., « Titre livre », éditeur, année
Notez ci-dessus l’utilisation du style « italic » pour les titres de magazines. Les références doivent être écrites en style « Normal ».
Dans cette partie (optionnelle) vous pouvez donner une liste de liens, références bibliographiques sans les avoir cités dans le texte. Attention, il faut tout de même un petit texte indiquant à quoi se rapporte le lien :
Conférence de R. Stallman du 28 septembre 2012 : https://www.youtube.com/watch?v=2onsOFWme-Q
Le livre de R. Stallman, S. Williams et C. Masutti, « Richard Stallman et la révolution du logiciel libre », Eyrolles, 2010.