Contenu | Rechercher | Menus

Annonce

Ubuntu 16.04 LTS
Commandez vos DVD et clés USB Ubuntu-fr !

Pour en savoir un peu plus sur l'équipe du forum.

Si vous avez des soucis pour rester connecté, déconnectez-vous puis reconnectez-vous depuis ce lien en cochant la case
Me connecter automatiquement lors de mes prochaines visites.

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

PROLIFIIK

[RESOLU]Installation d'une documentation

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, à 15:01)


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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.

En ligne

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

bruno

Re : [RESOLU]Installation d'une documentation

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

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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.


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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.

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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.


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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, à 18:21)

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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?


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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).

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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, à 12:10)


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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, à 12:13)

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

Ça  ne passe toujours pas.


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

Ç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, à 12:57)

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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.


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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 ?

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

j'obtiens

Aucune entrée de manuel pour printf.3

Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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

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

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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.

En ligne

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

PROLIFIIK

Re : [RESOLU]Installation d'une documentation

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.


Efforcez vous à aimer.
Efforcez-vous à croire en vous.
La verité, c'est que personne ne s' efforce...

Hors ligne

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

abelthorne

Re : [RESOLU]Installation d'une documentation

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

En ligne