Boost logo

Boost :

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

But are there other people who would like this format?


Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
+44 (0) 1539 561830

Boost list run by bdawes at, gregod at, cpdaniel at, john at