v. Typographie

Pour faciliter ce qui suit, voici quelques conventions typographiques suivies tout au long de ce livre. Cette section contient quelques exemples du format typographique trouvé dans Linux From Scratch.

./configure --prefix=/usr

Ce style de texte est conçu pour être tapé exactement de la même façon qu'il est vu sauf si le texte indique le contraire. Il est aussi utilisé dans les sections d'explications pour identifier les commandes référencées.

Dans certains cas, une ligne logique s'étend sur deux lignes physiques voire plus avec un antislash à la fin de la ligne.

CC="gcc -B/usr/bin/" ../binutils-2.18/configure \
  --prefix=/tools --disable-nls --disable-werror

Remarquez que l'antislash doit être suivi d'un retour chariot immédiat. Tout autre caractère blanc comme des espaces ou des tabulations donnera des résultats incorrects.

install-info: unknown option '--dir-file=/mnt/lfs/usr/info/dir'

Ce style de texte (texte à largeur fixe) montre une sortie d'écran, généralement le résultat de commandes. Ce format est aussi utilisé pour afficher des noms de fichiers, comme /etc/ld.so.conf.

Emphasis

Ce style de texte est utilisé dans différents buts dans ce livre. Son but principal est de mettre en évidence les points importants.

http://www.linuxfromscratch.org/

Ce format est utilisé pour les liens, ceux de la communauté LFS et ceux référençant des pages externes. Cela inclut les guides pratiques, les emplacements de téléchargement et des sites web.

cat > $LFS/etc/group << "EOF"
root:x:0:
bin:x:1:
......
EOF

Ce format est utilisé principalement lors de la création de fichiers de configuration. La première commande indique au système de créer le fichier $LFS/etc/group à partir de ce qui est saisi jusqu'à ce que la séquence de fin de fichier (End Of File) (EOF) soit rencontrée. Donc, cette section entière est généralement saisie de la même façon.

<TEXTE A REMPLACER>

Ce format est utilisé pour intégrer du texte qui ne devra pas être saisi tel quel et qui ne devra pas être copié/collé.

[TEXTE FACULTATIF]

Ce format est utilisé pour intégrer du texte qui est facultatif

passwd(5)

Ce format est utilisé pour faire référence à une page de manuel (man) spécifique. Le nombre entre parenthèses indique une section spécifique à l'intérieur des manuels. Par exemple, passwd a deux pages man. Pour les instructions d'installation de LFS, ces deux pages man seront situées dans /usr/share/man/man1/passwd.1. Quand le livre utilise passwd(5), il fait spécifiquement référence à /usr/share/man/man5/passwd.5. man passwd affichera la première page man qu'il trouvera et qui aura une correspondance avec « passwd », à priori /usr/share/man/man1/passwd.1. Dans cet exemple, vous devrez exécuter man 5 passwd pour lire cette page spécifique. Il devrait être noté que la plupart des pages man n'ont pas de noms de page dupliqués dans les différentes sections. Du coup, man <[nom du programme]> est généralement suffisant.