[RESOLU]Installation d'une documentation

PROLIFIIK · Le 17/08/2017, à 13:11

j'ai trouvé sur cette page man page linux.
j'ai telechargé un des fichiers tar quand je l'ai décompressé, il y a un des fichiers qui dit qu'on doit l'installer avant de visualiser le contenu correctement. Sauf que je ne comprends pas bien la methode d'installation decrite dans le fichier LISEZ_MOI.

Consigne installation a écrit :

III/ INSTALLATION
Pour visualiser une page avant de l'installer, vous pouvez
utiliser la commande :
groff -t -T latin1 -mandoc < nom_page.numero_section | less
ou encore :
man ./nom_page.section (en étant dans le bon répertoire)
Pour obtenir un fichier postscript à partir d'une page,
utilisez :
groff -t -T ps -mandoc < nom_page.numero_section > page.ps
ou encore :
man -t numero_section nom_page > page.ps
le fichier page.ps pourra être visualisé avec ghostview ou
gv, puis imprimé sur une imprimante postscript, ou sur une
imprimante supportée par ghostscript.

Il est conseillé de copier l'ensemble des pages dans les
sous-répertoires adéquats de /usr/man/fr, /usr/share/man/fr
ou éventuellement de /usr/local/man/fr.
Il existe un script 'Makefile' dans la distribution du LDP
qui peut être parfaitement adapté pour l'installation.
Pour les sites désireux de conserver des versions dans dif-
férentes langues, consulter le document Linux FSSTND, et ...
man man ;-)

Quelqu'un peut-il m'expliquer au mieux cette methode d'installation ou une autre methode d'installation?
Merci

Dernière modification par PROLIFIIK (Le 18/08/2017, à 14:01)

abelthorne · Le 17/08/2017, à 13:37

En gros, ils disent que pour que ces pages de man traduites soient utilisables sans manips particulières (càd en tapant juste man commande), il faut les installer au niveau système dans le dossier adéquat (/usr/man/fr, /usr/share/man/fr ou /usr/local/man/fr). Sur Ubuntu (17.04, du moins), il y a apparemment déjà des pages man traduites dans /usr/share/man/fr, donc le dossier le plus approprié serait sans doute celui-ci (enfin, un sous-dossier).

Attention quand même, parce que c'est peut-être déjà implémenté dans Ubuntu et ce ne serait pas forcément une bonne idée de faire une installation manuelle à côté. Il faudrait vérifier ça plus en détail. Peut-être aussi que man est à configurer pour utiliser des langues autres que l'anglais.

bruno · Le 17/08/2017, à 13:38

Il y a beaucoup plus simple pour installer les pages de man en français, du moins celles qui sont traduites. Il suffit d'installer le paquet idoine :

sudo apt install manpages-fr manpages-fr-extras

abelthorne · Le 17/08/2017, à 13:50

Ah, voilà. Mais du coup, à quoi correspondent les fichiers qu'on a d'origine dans /usr/share/man/fr ?

PROLIFIIK · Le 17/08/2017, à 16:18

Laquelle des man pages sera appelée quand je voudrais consulter la doc. est-celle installée manuellement ou celle venue avec le systeme?
Il me semble qu'il peut y avoir une confusion dans le choix du manuel a renvoyer

abelthorne a écrit :

Attention quand même, parce que c'est peut-être déjà implémenté dans Ubuntu et ce ne serait pas forcément une bonne idée de faire une installation manuelle à côté. Il faudrait vérifier ça plus en détail. Peut-être aussi que man est à configurer pour utiliser des langues autres que l'anglais.

abelthorne · Le 17/08/2017, à 16:25

Logiquement, le man ira chercher ce qu'il trouve, peu importe la façon dont ça a été installé. Ce que je voulais dire surtout, c'est que par exemple, si je vais voir dans /usr/share/man/fr, je vois des sous-dossiers du genre man1, man5, man7 et man8 : je ne sais pas s'il va chercher dans l'ordre des dossiers, s'il faut respecter une nomenclature pour les priorités, ce genre de chose. C'est pour ça qu'il faudrait vérifier ce qui est déjà installé / installable sur Ubuntu pour voir si c'est utile de rajouter manuellement des fichiers. Et si ça l'est, s'il faut respecter une nomenclature spécifique pour le nom des sous-dossiers à créer.

PROLIFIIK · Le 17/08/2017, à 17:13

Puisque cette methode semble pas trop precise à utiliser, il n'y a-t-il pas une application qui puisse le faire ?
Comme il le dit dans l'installation

INSTALLATION a écrit :

le fichier page.ps pourra être visualisé avec ghostview ou
gv, puis imprimé sur une imprimante postscript, ou sur une
imprimante supportée par ghostscript.

abelthorne · Le 17/08/2017, à 17:21

Ce que tu cites explique juste comment visionner ou imprimer des pages de la doc en question dans un format lisible indépendamment de leur installation.

Pour l'installation automatisée, il y a apparemment un fichier makefile de fourni. Il faudrait regarder de ce côté. Mais tu devrais d'abord jeter un coup d'œil aux pages de doc francisées qui sont déjà installables depuis les dépôts (cf le message de bruno ci-dessus), il y a de fortes chances qu'elles couvrent déjà la plupart de tes besoins.

Dernière modification par abelthorne (Le 17/08/2017, à 17:21)

PROLIFIIK · Le 17/08/2017, à 18:07

J'ai utilser synaptic pour installer les manuels en français
Mais je ne comprends pas la difference entre ces trois versions:
*manpages-fr
Version française des pages de manuel sur l'utilisation de GNU/Linux
*manpages-fr-dev
Version française des pages de manuel pour le développement
*manpages-fr-extra
Version française des pages de manuel
Au cas ou il n'y a une difference entre ces versions, comment faire pour selectionner une particulierement quand je voudrais?

abelthorne · Le 17/08/2017, à 18:16

Ce ne sont pas trois paquets qui contiennent les mêmes fichiers et qu'il faudrait sélectionner, ce sont des paquets complémentaires : le premier installe les pages de doc principales, le deuxième installe celles pour le développement (je suppose pour les commandes spécifiques qui concernent le développement) et le troisième installe des paquets supplémentaires (je suppose que ce sont les pages pour des commandes peu utilisées qui ne sont pas dans le premier).

PROLIFIIK · Le 18/08/2017, à 09:34

Il me semble qu'il y a une confusion:
Voici par exemple, je tape man printf pour voir la doc de la fonction printf(...) incluse dans stdio.h;
mais c'est la doc de printf:

doc a écrit :

SYNOPSIS
printf FORMAT [PARAMÈTRE] ...
printf OPTION

Comment faire alors?
Merci

abelthorne · Le 18/08/2017, à 09:48

Le man concerne les commandes système, celles qu'on tape dans un terminal. Je ne pense pas qu'il y en ait pour les instructions utilisées dans les langages de programmation. Pour ça, il faudrait trouver de la doc (bouquins, tutos, doc en ligne...) qui correspond au langage qui t'intéresse. Quelque chose comme ça pour le C/C++, par exemple

PROLIFIIK · Le 18/08/2017, à 11:08

Vraiment?
pourtant je vois dans le terminal quand tape man scanf

Doc a écrit :

SCANF(3) Manuel du programmeur Linux SCANF(3)
NOM
scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf - Entrées formatées
SYNOPSIS
#include <stdio.h>
int scanf(const char *format, ...);
int fscanf(FILE *stream, const char *format, ...);
int sscanf(const char *str, const char *format, ...);
#include <stdarg.h>
int vscanf(const char *format, va_list ap);
int vsscanf(const char *str, const char *format, va_list ap);
int vfscanf(FILE *stream, const char *format, va_list ap);

Après la doc de cette fonction suit tout le long du terminal et plusieurs fonctions du C sont accessibles ainsi.
le problème est ailleurs je crois...

Dernière modification par PROLIFIIK (Le 18/08/2017, à 11:10)

abelthorne · Le 18/08/2017, à 11:13

Ah, au temps pour moi. Ça doit venir du paquet manpages-dev.

Essaie avec man printf.3 pour lui dire de chercher dans la section 3 (qui correspond aux fonctions fournies par les bibliothèques de fonctions) :

man man a écrit :

Le tableau ci-dessous indique le numéro des sections de manuel ainsi que le type de pages qu'elles contiennent.
1 Programmes exécutables ou commandes de l'interpréteur de commandes (shell)
2 Appels système (fonctions fournies par le noyau)
3 Appels de bibliothèque (fonctions fournies par les bibliothèques des programmes)
4 Fichiers spéciaux (situés généralement dans /dev)
5 Formats des fichiers et conventions. Par exemple /etc/passwd
6 Jeux
7 Divers (y compris les macropaquets et les conventions), par exemple man(7), groff(7)
8 Commandes de gestion du système (généralement réservées au superutilisateur)
9 Sous-programmes du noyau [hors standard]

Dernière modification par abelthorne (Le 18/08/2017, à 11:13)

PROLIFIIK · Le 18/08/2017, à 11:47

Ça ne passe toujours pas.

abelthorne · Le 18/08/2017, à 11:56

Ça ne passe pas en français ou ça ne passe pas du tout (même en anglais) ? De mon côté (sans avoir installé les manpages-fr), ça me donne ça :

PRINTF(3)                  Linux Programmer's Manual                 PRINTF(3)

NAME
       printf,   fprintf,   dprintf,  sprintf,  snprintf,  vprintf,  vfprintf,
       vdprintf, vsprintf, vsnprintf - formatted output conversion

SYNOPSIS
       #include <stdio.h>

       int printf(const char *format, ...);
       int fprintf(FILE *stream, const char *format, ...);
       int dprintf(int fd, const char *format, ...);
       int sprintf(char *str, const char *format, ...);
       int snprintf(char *str, size_t size, const char *format, ...);

       #include <stdarg.h>

       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE *stream, const char *format, va_list ap);
       int vdprintf(int fd, const char *format, va_list ap);
       int vsprintf(char *str, const char *format, va_list ap);
       int vsnprintf(char *str, size_t size, const char *format, va_list ap);
[...]

Tu as bien respecté la syntaxe, tu n'as pas mis d'espace entre le printf et le .3 par exemple ?

Dernière modification par abelthorne (Le 18/08/2017, à 11:57)

PROLIFIIK · Le 18/08/2017, à 12:55

abelthorne a écrit :

Ça ne passe pas en français ou ça ne passe pas du tout (même en anglais) ? De mon côté (sans avoir installé les manpages-fr), ça me donne ça :

Avant l'installation en français, ça passait en anglais et c'etait correct. mais maintenant tout est mlelangé comme tu le disais ici

abelthorne a écrit :

je ne sais pas s'il va chercher dans l'ordre des dossiers, s'il faut respecter une nomenclature pour les priorités, ce genre de chose. C'est pour ça qu'il faudrait vérifier ce qui est déjà installé / installable sur Ubuntu pour voir si c'est utile de rajouter manuellement des fichiers. Et si ça l'est, s'il faut respecter une nomenclature spécifique pour le nom des sous-dossiers à créer.

abelthorne a écrit :

Tu as bien respecté la syntaxe, tu n'as pas mis d'espace entre le printf et le .3 par exemple ?

J'ai essayé toutes les combinaisons possibles.

abelthorne · Le 18/08/2017, à 13:10

Avant de vérifier tout à l'heure, je ne connaissais pas ces différentes sections de man. Le nom des sous-dossiers s'explique donc : ils correspondent simplement aux sections, ce n'est pas un ordre pour rechercher les pages de la doc comme je le supposais.

Je viens d'essayer d'installer les paquets français, d'abord manpages-fr et manpages-fr-dev : quand je lance man printf.3, il m'affiche bien la page pour la fonction printf en français. J'ai ensuite installé le paquet manpages-fr-extra et ça fonctionne toujours.

Concrètement, qu'est-ce que tu obtiens quand tu tapes cette commande ?

PROLIFIIK · Le 18/08/2017, à 13:37

j'obtiens

Aucune entrée de manuel pour printf.3

abelthorne · Le 18/08/2017, à 13:54

Avec la commande suivante, est-ce que tu vois un printf.3.gz ?

ls /usr/share/man/fr/man3 | grep printf

PROLIFIIK · Le 18/08/2017, à 14:00

@abelthorne, je suis allé voir sur Askubuntu, on m'a dit man 3 printf
Et sa marche
Merci:)

abelthorne · Le 18/08/2017, à 14:05

Par curiosité, tu es sur quelle version d'Ubuntu ? Si tu fais man man et que tu descends jusqu'aux exemples (vers la ligne 80), est-ce qu'il indique celui-ci ?

man man.7
Display the manual page for macro package man from section 7.

PROLIFIIK · Le 18/08/2017, à 14:43

Je suis sur Ubuntu 16.04 LTS

abelthorne a écrit :

Si tu fais man man et que tu descends jusqu'aux exemples (vers la ligne 80), est-ce qu'il indique celui-ci ?
man man.7
Display the manual page for macro package man from section 7.

Non je n'ai pas cet affichage.

abelthorne · Le 18/08/2017, à 14:56

Ok. Peut-être que la syntaxe a changé récemment.

Ubuntu-fr

Navigation

Liens de recherche

Annonce

#1 Le 17/08/2017, à 13:11

[RESOLU]Installation d'une documentation

#2 Le 17/08/2017, à 13:37

Re : [RESOLU]Installation d'une documentation

#3 Le 17/08/2017, à 13:38

Re : [RESOLU]Installation d'une documentation

#4 Le 17/08/2017, à 13:50

Re : [RESOLU]Installation d'une documentation

#5 Le 17/08/2017, à 16:18

Re : [RESOLU]Installation d'une documentation

#6 Le 17/08/2017, à 16:25

Re : [RESOLU]Installation d'une documentation

#7 Le 17/08/2017, à 17:13

Re : [RESOLU]Installation d'une documentation

#8 Le 17/08/2017, à 17:21

Re : [RESOLU]Installation d'une documentation

#9 Le 17/08/2017, à 18:07

Re : [RESOLU]Installation d'une documentation

#10 Le 17/08/2017, à 18:16

Re : [RESOLU]Installation d'une documentation

#11 Le 18/08/2017, à 09:34

Re : [RESOLU]Installation d'une documentation

#12 Le 18/08/2017, à 09:48

Re : [RESOLU]Installation d'une documentation

#13 Le 18/08/2017, à 11:08

Re : [RESOLU]Installation d'une documentation

#14 Le 18/08/2017, à 11:13

Re : [RESOLU]Installation d'une documentation

#15 Le 18/08/2017, à 11:47

Re : [RESOLU]Installation d'une documentation

#16 Le 18/08/2017, à 11:56

Re : [RESOLU]Installation d'une documentation

#17 Le 18/08/2017, à 12:55

Re : [RESOLU]Installation d'une documentation

#18 Le 18/08/2017, à 13:10

Re : [RESOLU]Installation d'une documentation

#19 Le 18/08/2017, à 13:37

Re : [RESOLU]Installation d'une documentation

#20 Le 18/08/2017, à 13:54

Re : [RESOLU]Installation d'une documentation

#21 Le 18/08/2017, à 14:00

Re : [RESOLU]Installation d'une documentation

#22 Le 18/08/2017, à 14:05

Re : [RESOLU]Installation d'une documentation

#23 Le 18/08/2017, à 14:43

Re : [RESOLU]Installation d'une documentation

#24 Le 18/08/2017, à 14:56

Re : [RESOLU]Installation d'une documentation

Pied de page des forums