Devhelp es un lector de libros de ayuda para Gnome, muy interesante porque te da funcionalidades muy parecidas a las del tipico fichero de chm de ayuda que se usa en los programas de m$-windows, por cierto de este ultimo fichero tambien hay un lector que va muy bien el GnoCHM tambien muy resulton que te ayuda a seguir usando esos ficheros.

Pues hablando del Devhelp, devhelp usa unos ficheros parecidos a los chm, por un lado esta el fichero padre que se apellida .devhelp y por el otro en una carpeta el manual en formato html en varios ficheros.

Devhelp, creo que lo conoci en mi tiempo aya en una fedora viejuna, y me parecio superutil para programar de manera offline, sin poder acceder a un manual decente, o teniendo bajado el oficial pero dandole vueltas a los htmls para encontrar la funcion que buscabas.

Bueno pues uno que anda con el mono de programar, y que esta offline mucho tiempo, me volvia a ser necesario asi que lo instale y pense, uhmm quiza seguro que hay mas libros, y mi respuesta la encontre en los links de un buen tutorial que hay sobre Devhelp Generar libros para devhelp, porque en la pagina oficial…salvo en el foro que no he mirado, no encontrado un listado de libros de devhelp.

Bueno pues una vez bajados hay que dejarlos en su directorio correspondiente, que viene muy bien explicado en el README de Devhelp, que esta normalmente en “/usr/share/doc/devhelp/README”…pero viene en ingles, el cual me llevo a confundirme varias veces en la instalacion (mea culpa) y para la gente que puede tener problemas como yo.

Desvelo un poco los puntos clave, para la instalacion en el share local de tu home, en mi caso “/home/md/.local/share/devhelp/books”,
estando ahi.

Tendras el libro en formato .tar.gz, lo descomprimes y dentro tendras un directorio normalmente llamado book y un fichero book.devhelp, entonces hay que modificarlo un poco para que lo lea en el devhelp…o por lo menos en la version (DevHelp 0.16), si por el contrario es distinto y posiblemente al resultado de los pasos siguientes, solo es necesario copiarlo en el directorio books.

Al pasar el libro al directorio books, hay que tener en cuenta que el fichero .devhelp se tiene que llamar como la carpeta del libro que la contiene, por ejemplo:

make-3.81.devhelp que esta en /home/md/.local/share/devhelp/books/make-3.817/

Y abres el devhelp y ves si ha cargado correctamente, y si es asi lo abres…posiblemente te dara algunas veces un mensaje de error de que no encuentra el index.html en el directorio /home/md/.local/share/devhelp/books/make-3.817/ pues eso significa que tienes que mover el contenido del directorio book que tiene los htmls a en mi caso /home/md/.local/share/devhelp/books/make-3.817/.

Y vuelves a probar, lo mas seguro es que se lea ya perfectamente en DevHelp y por supuesto que se pueda buscar en el que es lo que mas vidilla le da frente a los tipicos htmls sueltos ;) . Si no se ve entonces es que hay que editar el fichero .devhelp del libro para poner bien las rutas, dicho asi a groso modo y sin profundizar pero que con paciencia se puede hacer.