Boost logo

Boost-Build :

Subject: Re: [Boost-build] [doc] Sphinx.
From: Chambers, Matthew (matt.chambers42_at_[hidden])
Date: 2017-08-09 19:54:21


On 8/9/2017 9:12 AM, Aaron Boman via Boost-build wrote:
> > Ok, looking at the features of Sphinx more closely now.. Since there are various people here knowledgeable about Sphinx.
> > More questions..
> > Does Sphinx support output to docbook?
> Not natively, but it should be possible to write a converter: https://github.com/HolgerPeters/sphinxcontrib-docbook
> I think the basic process is to run sphinx with the XML builder and then transform that XML to docbook XML.
> My question would be: why do this?
> Is this for PDF support?
> It looks like there is a builder that can be used to produce PDF output: https://github.com/brechtm/rinohtype
> However, it requires Python3.3+
> How important is PDF support? Just curious as I typically only use HTML for documentation.
>
Please let PDF die, like Flash. :) I hate that R's documentation and vignettes, before downloading a package, are almost entirely rendered
in PDFs.

-Matt



Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk