Construction collective d'un manuel électronique du HP-41

[Thomas FR69]

Cette discussion fait suite à celle engagée sur le manuel de la HP-11C que l'on trouve ici Manuel HP 11C.

Ce qui manque vraiment, ce sont des versions numériques textes des manuels, comme ceux proposés par John (voir cette discussion), qui permettent réellement de travailler confortablement avec, de faire des recherches sur le texte, d'avoir des liens directs depuis un sommaire et un index (et même lors des renvois d'une page à une autre), de les emporter et les lire confortablement avec un lecteur de poche (iPhone ou iPod Touch par exemple).
Avec un bon logiciel d'OCR, le travail ne serait pas titanesque (pas comme celui de John, qui a tout ressaisi !). J'ai fait un essai et ce n'est pas tellement plus long que le scan et le retravail propre de la page (rotation, recadrage, éventuelles retouches...) comme je l'ai fait pour le fameux numéro 5 de l'OP.

[noel]

Thomas,

Le deuxième avantage quand on se met à faire ce travail c'est qu'on "ré-apprend" pas mal de choses sur le fonctionnement de la machine, des fonctions oubliées, des astuces égarées...

Après il y a aussi la question des droits d'auteur. Même si HP est assez cool là-dessus, on n'est jamais à l'abri d'un procès.

L'idéal serait de faire un énorme manuel à partir de plusieurs petits, comme la série HP 41C, CV et CX, ou HP 10C, 11C, 15C et un autre gros manuel pour les commerciales. Ou alors, si on reste sur le HP 41, il faudrait un manuel interactif en ligne avec une entrée clavier, et une entrée texte. On divise la page en deux, d'un côté le clavier, de l'autre le texte, en cliquant sur une touche, on a la fonction qui s'affiche; une colonne au centre avec le défilement du CATALOG 1, lorsque l'on clique dessus, idem, la fonction s'affiche.

Ça représente quoi comme boulot ?

[Thomas FR69]

Après il y a aussi la question des droits d'auteur. Même si HP est assez cool là-dessus, on n'est jamais à l'abri d'un procès.

Aucun risque pour un procès. Le risque est de devoir retirer le document du site et donc d'avoir passé beaucoup de temps à le construire pour rien. Mais pour un manuel de HP-41 (très ancien) et sur notre site (qui ne fait que de la pub gratuite pour HP), cela m'étonnerait vraiment que le risque soit supérieur à 0,0% !

L'idéal serait de faire un énorme manuel à partir de plusieurs petits, comme la série HP 41C, CV et CX, ou HP 10C, 11C, 15C et un autre gros manuel pour les commerciales. Ou alors, si on reste sur le HP 41, il faudrait un manuel interactif en ligne avec une entrée clavier, et une entrée texte. On divise la page en deux, d'un côté le clavier, de l'autre le texte, en cliquant sur une touche, on a la fonction qui s'affiche; une colonne au centre avec le défilement du CATALOG 1, lorsque l'on clique dessus, idem, la fonction s'affiche.

Très bonne idée.
Une autre bonne idée différente serait que sur mon émulateur HP-41 sur iPhone, le manuel soit directement lié à la HP-41. Par exemple la pression sur la droite de l'écran, puis sur la touche, affiche l'aide sur la fonction. L'intégration de l'iPhone et du HP-41 dans i41CX+, comme par exemple l'utilisation du clavier de l'iPhone lors de la pression sur la touche Alpha, me font rêver à un manuel intégré que l'on aurait toujours dans la poche, avec le HP-41.

Mais en fait, le plus important : si on se lance dans la réalisation d'un manuel texte du HP-41, on pourra ensuite très facilement le décliner sous toutes les formes en fonction de l'utilisation souhaitée : un eBook, un PDF, un html selon ton descriptif...

Ça représente quoi comme boulot ?

À la fois beaucoup, et à la fois rien si on se partageait le travail. Ce forum devrait permettre ce genre de réalisation .

[noel]

Effectivement, si l'on se partage la tâche, et le forum sert à ça, chacun peut rédiger une fonction en reprenant le manuel et le tour sera joué.

Il faudrait poser un cadre. Sous quelle format peut-on envoyer les textes ? Genre .TXT et puis quelqu'un se charge d'assembler les textes. On reprend le plan du manuel ou bien on se sert de la liste des fonctions ?

Ça peut faire un beau projet pour la communauté

Qui est partant ?

[Thomas FR69]

Effectivement, si l'on se partage la tâche, et le forum sert à ça, chacun peut rédiger une fonction en reprenant le manuel et le tour sera joué.

Je pense qu'il serait plus judicieux de se partager le travail par tâche que par fonction. Ceci permettrait une spécialisation donc plus d'efficacité.

Les étapes me semblent être :
1 - Recherche de la dernière édition des manuels (il serait dommage de réaliser tout ça avec une version plus ancienne).
2 - scan de la page.
3 - transformation de l'image en texte avec un logiciel d'OCR.
4 - Relecture et corrections (nombreuses, c'est à dire plutôt 10 par page que 2, à cause de l'imperfection du logiciel d'OCR).
5 - Réalisation des illustrations éventuellement contenus dans la page. Normalement, le logiciel d'OCR se débrouille avec les tableaux. Pour les autres (assez rares) on peut se contenter de conserver les images du scan ou mieux : on les redessine !
6 - Enrichissement du manuel avec des nouveautés (exemple, proposer une alternative plus intéressante à une fonction offerte par le module Paname ou HEPAX...).
7 - Mise en forme du document final dans les différents formats souhaités, avec tous les liens hypertextes.

Ça peut faire un beau projet pour la communauté
Qui est partant ?

Moi !
Je suis prêt à réaliser le point 7 et éventuellement le 3.

[noel]

Pour l'instant je n'ai pas de scanner

Je dispose des versions suivantes :

Manuel d'utilisation et guide de programmation HP-41C
Réf. 00041-90011, juillet 1979

(Le guide à spiral le plus utile à mon avis)

Manuel d'utilisation, Principe de base HP-41CV
Réf. 00041-90528, juin 1984 (imprimé 9/84)

Manuel de l'utilisateur expérimenté HP-41C/41CV
Réf. 00041-90329, septembre 1980 (imprimé 1/81)

Manuel d'applications HP-41C/41CV
Réf. 00041-90408, avril 1982 (imprimé 10/82)

Manuel d'utilisation HP-41CX, Volume 1 : Principes de base
Réf. 00041-90478, mars 1984 (imprimé 3/86)

Le premier manuel du HP-41C est le plus complet en un seul volume (192 pages). Ensuite, HP a divisé le manuel en plusieurs volumes tout en enlevant les spirales tellement plus pratiques.

Qui a plus récent ?

[hpmaniac]

Moi je n’ai que le premier manuel à spirale (même version) que j’ai eu avec ma 41C en 1981, mais j’ai un scanner ...
Je suis prêt à participer, mais je pense qu’il faut définir plus précisément ce que l’on veut faire :
- Texte (.txt) seulement, texte riche (.rtf), html….
- Comment codifier les touches ? entre crochets : [XEQ] ou autre convention…
- Comment découpe t-on le manuel: par page, par fonction, par chapitre …
- Quels paramètres pour scanner les images (résolution, couleur/n-b, format png, gif, jpg …)
- Comment lier les graphiques au texte si l’on veut avoir plusieurs formats …
- Et j’en oublie sûrement…

Bref, un projet intéressant

note: je n'ai pas de 41CX, mais une 41C touches hautes avec lecteur de carte, un module Quad-memory et un module X-functions avec son manuel en anglais...

[hpmaniac]

J’ai trouvé le site de Daniel B. (SASFEPU) un pdf du :

Manuel d’Utilisation et Guide de Programmation HP-41C/HP-41CV
réf. 00041-90316, septembre 1980

Voici l’introduction, incluant l’exemple classique de la déperdition de chaleur d’un chauffe-eau, au format pdf et au format txt respectant les retours à la ligne du document original. Cela peut servir de base pour définir ce que l’on veut faire en plus ou différemment.

L'inconvénient du txt est de perdre toutes les informations de formatage ...

[noel]

Il faudrait peut-être que Daniel se manifeste si on peut utiliser ses fichiers, ça gagnerait du temps.

[daniel-51]

Bonjour à tous,

Pas de soucis, les fichiers sont faits pour cela

Je peux vous transmettre les images des scans qui ont servi à générer le pdf.

Daniel

[daniel-51]

Bon, bien voilà, en plus du pdf disponible sur mon site, ici, les images des pages du manuel.

Le fichier fait 67 Mo
Le mot de passe est : hp41
Le fichier sera accessible à l'adresse suivante :
http://dl.free.fr/qi7lMXuBf
Le fichier restera en ligne tant qu'il y aura au moins un téléchargement sur une période de 30 jours.

Daniel

[Thomas FR69]

Bonjour Daniel qui, en quelques heures à peine après l'appel de Noël, a jaillit de son site tel le génie de sa lampe, et bienvenue sur ce forum !

Merci pour les images des pages du manuel . J'ai téléchargé le fichier.

[Thomas FR69]

Moi je n’ai que le premier manuel à spirale (même version) que j’ai eu avec ma 41C en 1981, mais j’ai un scanner ...

Si nous nous lancions dans ce projet, le plus judicieux ne serait-il pas de commencer par le manuel le plus récent de la 41CX ? Sachant que qui peut le plus peut le moins...

- Texte (.txt) seulement, texte riche (.rtf), html...

Je propose, pour faciliter le travail à plusieurs et les échanges, de tout construire en texte mais en autorisant quelques balises html : <b></b> pour le gras, <img src=""> pour l'insertion d'une image et les balise des tableaux par exemple.

- Comment codifier les touches ? entre crochets : [XEQ] ou autre convention…

Je propose soit encadrée, comme dans la manuel de John, soit de créer des petits GIF plus esthétiques mais plus lourd à gérer/afficher.

- Comment découpe t-on le manuel: par page, par fonction, par chapitre …

Ce n'est pas très important. On peut ensuite poser des balises name pour marquer une nouvelle fonction, ou une nouvelle page selon le manuel original...

- Quels paramètres pour scanner les images (résolution, couleur/n-b, format png, gif, jpg …)

Selon l'image. Priorité à la qualité. On numérise en TIFF, 600 dpi, 48 bits, et on laisse ensuite Photoshop choisir...

- Comment lier les graphiques au texte si l’on veut avoir plusieurs formats …

Voir ci-dessus. On définirait aussi une norme de nommage des images. Par exemple 41cxv11-02-48.jpg pour la deuxième illustration de la page 48 du manuel 41cxv11.

[noel]

Salut Thomas,

Tu disais qu'il fallait qu'on soit suffisamment nombreux pour bien se répartir le travail. Je reste sur mon idée, et si ceux qui peuvent le faire s'attardaient sur les GIF et les images: on pourrait faire un stock d'icônes à utiliser ?

Merci Daniel pour ta proposition, rejoins-tu le projet ?

OK pour la 41CX, à l'utilisation, ne peut-on pas envisager de masquer les fonctions inutilisables ? Un drapeaux du style Anglais, Français, qui serait HP41C/CV et HP41CX, qui éliminerait les fonctions du CX quand on est utilisateur de C/CV, cela pour rendre plus clair le manuel. Plus on sera précis sur les finalités à donner à ce e-manuel, moins on perdra de temps.

Bonne journée au e-manuel crew

[Thomas FR69]

Je reste sur mon idée, et si ceux qui peuvent le faire s'attardaient sur les GIF et les images: on pourrait faire un stock d'icônes à utiliser ?

Je peux le faire.

OK pour la 41CX, à l'utilisation, ne peut-on pas envisager de masquer les fonctions inutilisables ? Un drapeaux du style Anglais, Français, qui serait HP41C/CV et HP41CX, qui éliminerait les fonctions du CX quand on est utilisateur de C/CV, cela pour rendre plus clair le manuel.

Si, c'est très facile, sous réserve que les parties soient bien identifiées. Par exemple une fonction du 41CX à masquer pour le manuel du 41C, c'est facile, mais pour un nombre d'octets perdu au milieu d'une phrase qui ne sera exact que pour la 41CX et faux pour les deux autres, il faudra être plus vigilant. Très bonne idée.