Conventions utilisées dans ce manuel

Conventions typographiques

Afin d'accentuer clairement certains mots ou groupes de mots, nous avons utilisé certains attributs typographiques. Le tableau suivant en donne la signification symbolique :

Exemple formatéSignification
inœudSignale un terme technique.
ls -ltaTypes utilisés pour une commande et ses arguments, les options et les noms de fichier (voir la section la section intitulée “Synopsis d'une commande”).
ls(1)Référence vers une page de manuel (aussi appelée page de man). Pour consulter la page correspondante dans un shell (ou ligne de commande), exécutez la commande man 1 ls.
$ ls *.pid
Ce style est utilisé pour une copie d'écran texte. Signale une interaction utilisateur-ordinateur, le code source d'un programme, etc.
localhostDonnées littérales qui ne correspondent généralement pas à une des catégories précédemment définies : citation d'un mot clé tiré d'un fichier de configuration, par exemple.
ApacheNom des applications. Notre exemple («Apache») n'est pas un nom de commande. Toutefois, dans des contextes particuliers, l'application et le nom de la commande peuvent être les mêmes, mais formatés de façon différente.
C onfigurerEntrée de menu ou label des interfaces graphiques, en général. La lettre soulignée indique le raccourci clavier éventuel.
Bus SCSIPartie d'un ordinateur ou ordinateur lui-même.
Once upon a time...Citation en langue étrangère.
Attention !Types réservés pour les mots que nous voulons accentuer. Lisez-les à voix haute :-)

Note

Cette icône introduit une note. Il s'agit généralement d'une remarque dans le contexte courant, pour donner une information additionnelle.

Astuce

Cette icône introduit une astuce. Il peut s'agir d'un conseil d'ordre général sur la meilleure façon d'arriver à un but spécifique, ou une fonctionnalité intéressante qui peut vous rendre la vie plus facile.

Avertissement

Soyez très attentif lorsque vous rencontrez cette icône. Il s'agit toujours d'informations très importantes sur le sujet en cours de discussion.

Conventions générales

Synopsis d'une commande

L'exemple ci-dessous présente les différents signes et symboles que vous rencontrerez lorsque nous décrivons les arguments d'une commande :

command <argument non littéral> [--option={arg1,arg2,arg3}] 
[argument optionnel...]

Ces conventions étant standardisées, vous les retrouverez en bien d'autres occasions (dans les pages de man, par exemple).

Les signes «<» (inférieur) et «>» (supérieur) indiquent un argument obligatoire qui ne doit pas être recopié tel quel mais remplacé par votre texte spécifique. Par exemple : <fichier> désigne le nom d'un fichier ; si ce fichier est toto.txt, vous devrez taper toto.txt, et non <toto.txt> ou <fichier>.

Les crochets «[ ]» indiquent des arguments optionnels que vous déciderez ou non d'inclure dans la ligne de commande.

Les points de suspension («...») signifient qu'un nombre illimité d'options peut être inséré à cet endroit.

Les accolades («{ }») contiennent les arguments autorisés à cet endroit. Il faudra obligatoirement insérer un d'entre eux à cet endroit précis.

Notations particulières

De temps à autre, il vous sera demandé de presser les touches Ctrl+R. Cela signifie que vous devez taper et maintenir la touche Ctrl enfoncée pendant que vous appuyez sur la touche R. Il en va de même pour les touches Alt et Shift.

De même, à propos des menus, aller sur l'entrée de menu Fichier->Relire la configuration utilisateur (Ctrl+R) signifie : cliquez sur le label Fichier du menu (généralement en haut et à gauche de la fenêtre) puis sur le menu vertical qui apparaît, cliquez sur Relire la configuration utilisateur. De plus, vous pouvez également utiliser la combinaison de touches Ctrl+R, comme décrit ci-dessus pour arriver au même résultat.

Utilisateurs système génériques

À chaque fois que cela est possible, nous utiliserons deux utilisateurs génériques dans nos exemples :

Reine PingusaCet utilisateur est créé pendant l'installation.
Pierre PingusCet utilisateur est ensuite créé par l'administrateur système.