cClaude.rocks ☕ Le blog

Je fais le choix de configurer mon système avec la langue anglaise…

…en réalité, cela consiste à garder, pour la langue, la configuration par défaut. En voici quelques raisons :

• Les traductions sont parfois douteuses, et même lorsque ce n’est pas le cas les termes techniques utilisés non pas nécessairement d’équivalent en français. Je ne vois pas la plus-value de fabriquer un mot en français, le cas du mot « courriel » et pire le cas du mot « mél » n’a aucun intérêt : (« À l’écrit, l’Administration recommande, devant une adresse électronique, l’abréviation Mél » – sérieux ?)
• En cas de problème, il est beaucoup plus efficace de rechercher une erreur à partir de sa trace en anglais qu’en français. La grande majorité des forums et documentations techniques sont rédigées en anglais. C’est lié à la probabilité de trouver quelqu’un ayant eu le même problème que moi et d’avoir la solution.
• Les programmes sont majoritairement testés en anglais, et même si c’est de plus en plus rare, il arrive que la traduction soit la cause d’erreurs spécifiques.
• Les fichiers de configuration sont en anglais (heureusement, ils ne sont pas (encore ?) traduit. Pour éviter toute ambiguïté dans les termes techniques, il est largement préférable de s’appuyer sur la documentation en langue anglaise.

Notez que le fait de configurer la machine en langue française implique souvent que le manuel utilisé soit en français.

Cependant

En particulier pour ce blog, je m’appuie sur la version française de la documentation. Dans ce cas, il est nécessaire que je sache quel est le terme précis utilisé en français.

Le manuel utilisateur de Linux

man est une commande UNIX permettant d’accéder aux pages de manuel installées sur le système. La plupart des programmes fournissent une page de manuel les documentant et c’est donc la commande man qui permet de lire c’est documentation.

Aucune installation n’est nécessaire, man est installé par défaut sous l’ensemble de système Linux.

Vous pouvez cependant ajouter des pages de manuel supplémentaires en installant le paquet correspondant.

Les pages de manuel supplémentaires

Vous pouvez installer des pages supplémentaires pour man pour des langues différentes ou des pages plus techniques si vous souhaitez faire du développement.

• manpages-fr : Version française des pages pour man sur l’utilisation de GNU/Linux
• manpages-fr-extra : Version française des pages de manuel des programmes
• manpages : Pages de manuel (en anglais) sur l’utilisation de GNU/Linux
• manpages-posix : Pages de manuel (en anglais) sur l’utilisation des systèmes POSIX

Il existe des pages spécifiques pour les développeurs qui ne sont pas généralement pas installées par défaut.

• manpages-fr-dev : Version française des pages de manuel pour les développeurs
• manpages-dev : Pages de manuel (en anglais) pour les développeurs
• manpages-posix-dev : Pages de manuel (en anglais) sur l’utilisation des systèmes POSIX pour les développeurs

Un autre type d’aide :

• eg : Ce n’est pas une commande Linux standard, mais un petit outil qui est un très bon complément à man. Il affiche l’aide sous forme d’exemples d’usage des commandes usuels, lorsqu’on a un doute sur la syntaxe et que l’on sait à quoi sert la commande, c’est souvent beaucoup plus efficace que d’utiliser man.

Si vous disposez de la commande pip3, vous pouvez installer cette commande à l’aide de :

pip3 install eg

Comment utiliser man ?

Pour avoir une aide sur la commande find, il suffit d’utiliser :

man find

et pour ln ce sera :

man ln

À la fin de cette dernière documentation, vous trouverez :

SEE ALSO
       link(2), symlink(2)

VOIR AUSSI
       link(2), symlink(2)

Le (2) indique une documentation développeur et par exemple, la référence link(2), est accessible à l’aide de :

man 2 link

Comment utiliser man pour autre langue ?

Prenons l’hypothèse que votre système soit installer en anglais et que vous souhaitiez à la demande accéder aux pages en français.

D’abord vous devez installer les paquets français :

sudo apt install manpages-fr
sudo apt install manpages-fr-extra
sudo apt install manpages-fr-dev

Puis lors de l’utilisation de la commande man il faut ajouter le paramètre -L suivi du code de la langue, comme cela :

man -Lfr ln

find /usr/share/man -name 'ln.*'

/usr/share/man/fr/man1/ln.1.gz
/usr/share/man/man1/ln.1.gz

En gros, vous comprenez que les pages du manuel sont stockées dessous : /usr/share/man/.

D’autres pages :

• Les pages rigolotes

  Le paquet funny-manpages contient un ensemble de pages de manuel humoristiques diverses (en anglais), à ne pas prendre au sérieux ! Avertissement ! Certaines de ces pages de manuel peuvent être considérées comme offensantes. Vous avez été prévenu.

  Comprends, entre autres :

  • rtfm(1)
  • RM(1fun)
  • baby(1fun)
  • celibacy(1fun)
  • condom(1fun)
  • date(1fun)

  • echo(1fun)
  • egrope(1fun)
  • fgrope(1fun)
  • flame(1fun)
  • flog(1fun)
  • gong(1fun)

  • grope(1fun)
  • party(1fun)
  • rescrog(1fun)
  • rm(1fun)
  • rtfm(1fun)
  • sex(6fun)

  • strfry(3fun)
  • tm(1fun)
  • uubp(1fun)
  • xkill(1fun)
  • xlart(1fun)

  Par exemple pour voir la documentation de la fausse commande baby :

  man 1fun baby
  

Références

• Documentation de man en français,
• Explication de l’acronyme POSIX,
• Documentation en ligne des [blagues du manuel],(https://manpages.debian.org/unstable/funny-manpages/index.html) en anglais.
• A Collection of Secret Linux Humor

ᦿ