Would you consider including a Makefile?

[ghost]

Would you be open to include a (simple) Makefile to build the files in 'book'?

If yes, I'd sent you a pull request later this week.

My motivation is to be able to build the book from source so that I can write a small package receipe to include it in GNU Guix as an installable document. This way it could also be possible to install (and compile) the included libraries alongside the document and have them available in your Guile path.

[panicz]

Sure. If it's well documented, I'll merge the request eagerly :) I have always been using pdflatex to convert the book to pdf. Maybe it would also be worthwhile to compile the book to other formats (like html or info pages)?

[ghost]

Cool, okay I'll get started soon'ish and sent a request your way.

On other formats: I've spent quiet some time recently with converting our documentation at GNUnet to Texinfo, which is being exported as info,pdf,html and I think that's it.

A LaTeX -> Texinfo conversion (in the hypothetic case you'd want Texinfo) would work, and Texinfo can be translated via … (was it Sphinx?) … some external software in the middle. But if you don't automate it it's lots of work. I definitely would not recommend to do as I did with 400 pages.

There's also other ways to do this, like doing a conversion to ReST and then use some of the python based solutions such as Sphinx (I think you could even use TeX directly with Sphinx, I haven't used Sphinx actively so far).