Re: [boost] Generating Boost documentation with pandoc

Subject: Re: [boost] Generating Boost documentation with pandoc
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2016-07-22 11:31:54

> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Vinícius dos Santos Oliveira
> Sent: 22 July 2016 14:40
> To: Boost
> Subject: [boost] Generating Boost documentation with pandoc
> 
> Has anyone tried to generate Boost-styled documentation using pandoc?
> 
> I never fully liked PDF documentation because I never actually print
> documentation. However, a few weeks ago I got an ebook reader and I've been
> fascinated by the ePUB format. I'm using it to read even the IETF's RFCs
> and it's very pleasant. I'm using ePUB to read files even on my usual
> laptop.

Why are you not reading the PDF version on your laptop already?

(I always check that PDF does work on a phone too - but is a bit small to read for long.
Certainly OK on a tablet).

(A BIG virtue is that you can use the PDF Reader to *search ALL* of the document, not just one HTML page.)

> Anyway, I was wondering how nice would be to have an ePUB file containing
> the whole Boost documentation.

How nicer than the PDF versions?
 
> pandoc has docbook support as one of its input formats and is capable of
> generating great ePUB output.

Or perhaps we could probably very easily convert from PDF to ePUB using this

http://www.pdf-epub-converter.com/pdf-to-epub-converter.html

But are there other people who would like this format?

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]