Nous sommes le Ven 18 Juil, 2025 12:51
Supprimer les cookies

Equivalent winHelp / *.chm

Pour une tâche précise, pour remplacer un logiciel propriétaire donné...

Lun 18 Fév, 2008 14:56

Hello,
je cherche un moyen pour générer de l'aide au format HTML avec recherche et index, comme le fait winHelp et les fichiers *.chm

Qqn connait-il qqch d'équivalent?

Merci! :!:
++
Ponsfrilus
ponsfrilus

Avatar de l’utilisateur
Messages : 60
Géo : Lausanne, Switzerland

Lun 18 Fév, 2008 15:39

aptitude install doc-central ? (pour windows, pour la document linux, pour les fichiers chm? il manque quelques précisions)
Earered

Messages : 430
Géo : France, Paris

Lun 18 Fév, 2008 15:42

C'est pour faire de la doc d'un site online.

Idéalement il faudrait que la structure de la doc puisse être automatiquement construite sur l'arborescence du site.

Un truc du genre: http://help.qxlricardo.com/?c=200000&link=http:%7C%7Cwww.fr.ricardo.ch%7CDefault.asp
++
Ponsfrilus
ponsfrilus

Avatar de l’utilisateur
Messages : 60
Géo : Lausanne, Switzerland

Lun 18 Fév, 2008 16:42

Ça c'est le résultat, pas la source (pdf? tex? doc? txt? chm? système windows? unix? arborescence? code source?)

Sinon, doc-central répond à la question pour la doc d'un système linux.

Et suivant la source, d'autre solutions existent (javadoc & co, script shell, etc...)
Earered

Messages : 430
Géo : France, Paris

Lun 18 Fév, 2008 17:07

Ok ...

je repose ma question différemment. J'ai un site sur lequel je dois implémenter une aide (lien sur des pages qui ouvre l'aide ad-hoc), comment je m'y prend? Existe-il des outils qui mâchent le travail. Les outils comme phpdocumentor ou javadoc ne sont pas adaptés...
++
Ponsfrilus
ponsfrilus

Avatar de l’utilisateur
Messages : 60
Géo : Lausanne, Switzerland

Lun 18 Fév, 2008 17:32

C'est à dire, avoir des pages avec des liens pointant vers la page de documentation?

Par exemple, une application de commerce en ligne, avec sur chaque page un lien pointant vers une documentation plus complète pour la page concerné?

Je suis tenté de dire que ça tient de la gestion de configuration, et que ça se règle avec des conventions de nommage.

Si le but est de partir du site vers de l'aide inexistante ou en vrac, un CMS qui génère sur chacune des pages un lien vers un wiki. Puis remplir les pages pointé par le CMS?

Ou le but était de trouvé des scripts rendant cela agréable? comme http://www.bosrup.com/web/overlib/ pour quelque chose de similaire à http://en.wikipedia.org/wiki/Hover_ad mais pour de l'aide?

Ça n'est donc pas une recherche d'outil comme docbook ou http://www.stack.nl/~dimitri/doxygen/ ?

(encore et toujours, qu'elle est la source de la documentation? existante, présent en commentaire? éventuellement quel est le lien existant entre les éléments à documenté et la documentation (aucun, manuel, nom, numéro similaire?))

P.S. peut être des outils pour vérifier la présence de liens morts?
Earered

Messages : 430
Géo : France, Paris

Lun 18 Fév, 2008 18:02

Earered a écrit:(encore et toujours, qu'elle est la source de la documentation? existante, présent en commentaire? éventuellement quel est le lien existant entre les éléments à documenté et la documentation (aucun, manuel, nom, numéro similaire?))


Elle n'est pas encore existante... en gros ce sera une doc par page du site... le but étant d'avoir une doc fonctionnel pour le site puis un manuel plus complet basé sur le même support.

Par exemple du docbook puis docbook2chm et pdf. C'est encore a définir.

C'est l'aspect propriétaire de chm qui m'ennuie.
++
Ponsfrilus
ponsfrilus

Avatar de l’utilisateur
Messages : 60
Géo : Lausanne, Switzerland

Lun 18 Fév, 2008 18:19

Pourquoi passer par du chm? Vous pouvez générer un "site web" à partir d'un docbook
http://docbook.sourceforge.net/release/ ... index.html
Earered

Messages : 430
Géo : France, Paris

Lun 18 Fév, 2008 18:27

pourquoi faire du chm ? Une simple page htlm avec hyperliens ne suffirait pas ?

edit : grillé par Earered
L'homme n'est pas fait pour travailler et la preuve, c'est que ça le fatigue. (Marcel Proust)
dedenimes

Messages : 2410
Géo : proche de Nîmes

Qui est en ligne ?

Utilisateur(s) parcourant actuellement ce forum : Aucun utilisateur inscrit