Discussion :

[athomas]

Bonjour à tous,
Je suis à la recherche d'outils me permettant comme l'indique le titre de cette discussion de générer l'aide utilisateur d'un logiciel. L'aide devra se présenter au format HTML associée à une feuille de style CSS. L'utilisateur devra pouvoir évoluer dans l'aide grâce à des boutons (liens) du style : Previous, Next, Up...
Les pages comprendront des images afin d'illustrer les différentes fonctionnalitées.
Il est aisé de générer les pages indépendament les unes des autres, mais la gestion des liens entre les pages peut devenir assez lourde au fur et à mesure que l'aide prend de l'ampleur.
Je suis intimement persuadé que de nombreux outils permettant de faciliter cette démarche existent sur la toile, mais malgré mes recherches je ne suis pas parvenu à en trouver un qui me convienne.

J'oubliais , l'aspect libre de cet outil serait un atout non négligeable.

Merci par avance pour votre aide.

[aoyou]

Je ne vais pas répondre à ta question mais t'exposer ce qu'on fait. Peut-être que ça pourra t'aider.

On écrit le manuel utilisateur comme un document classique avec Word. On distribue donc le manuel de manière classique (avec une génération PDF intermédiaire) et pour l'aide au sein du logiciel, on demande à Word d'enregistrer le document au format HTML. Bon, OK, faut pas trop regarder le code HTML généré ; il doit quant même y avoir une feuille de style si je me rappelle bien. Ensuite, on utilise QWebView (from Qt) pour afficher l'aide.

Le tout se fait en même pas une heure. Ce n'est pas très cher, ça nous convient mais tu sembles chercher quelque chose de plus élaboré. Peut-être qu'Open Office permet de faire quelque chose de sympa ?

Ce que tu ne dis pas dans tes explications, c'est le format dans lequel tu écris ton aide. Tu sembles aussi vouloir générer du HTML.

Si je reprends tes points

générer l'aide utilisateur d'un logiciel

Word par exemple

l'aide devra se présenter au format HTML associée à une feuille de style CSS

OK avec Word (euh... non je n'ai pas d'actions chez eux)

L'utilisateur devra pouvoir évoluer dans l'aide grâce à des boutons (liens) du style : Previous, Next, Up...

Offert par QWebView. Faut peut-être creuser un peu pour afficher les boutons mais les fonctionnalités sont présentes.

les pages comprendront des images

Tu peux faire un DOC avec des images.

la gestion des liens entre les pages peut devenir assez lourde

Je crains que Word ne génére qu'une page mais il y a une table des matières avec des liens

l'aspect libre de cet outil serait un atout non négligeable

Qt et OpenOffice

En espérant que ça puisse t'aider,

[athomas]

Bonjour,
Je te remercie pour cette réponse.
Je vais creuser de ce côté, mais il est vrai que j'aurais préféré un outil disont plus "organisé" , avec de nombreux fichiers html , en fait un pour chacune des fonctions.

Ne sachant pas si cela existe réellement .... je vais poursuivre mon investigation.

Bonne continuation !

[Mac LAK]

Doxygen, tout simplement. Génère de la documentation au format HTML, CHM (Windows) ou QHP (QT), parmi d'autres formats.