Subject: Re: [Boost-docs] interface between library documentation and Boost website
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2015-07-17 18:15:05
On Fri, Jul 17, 2015 at 12:07 PM, Stefan Seefeld <stefan_at_[hidden]>
> so in order to make some progress, I have followed the typical github
> process for setting up a project homepage for my own Boost.Python repo
> (i.e., created a gh-pages branch). With some minor adjustments to image
> and stylesheet locations to make the Boost.Python docs self-contained, I
> was able to generate this:
> I would ultimately like to do the same for the upstream project at
> https://github.com/boostorg/python/, but first need to understand the
> process so I can avoid introducing bugs. At least for Boost.Python,
> where documentation changes are rare, I think this mechanism may just be
> On 15/07/15 01:38 PM, Robert Ramey wrote:
> > On 7/15/15 10:01 AM, Stefan Seefeld wrote:
> >> Still, my original question remains: what is the interface that the
> >> Boost website integration requires from library documentation ?
> > Not much. provide one of the following:
> > a) raw html files generated any way you want
> > b) boostbook xml files
> > c) quickbook xml files.
> > What
> >> documentation files need to be present in a given Boost library, and
> >> what (if any) are the requirements on their content ?
> > My views are described here. The web page has an opportunity to
> > comment but no one has ever done so. So, I'm going to assume the
> > fairly represent the consensus of the community.
> >> What is the the exact process used to generate the Boost.org website
> >> from library docs ?
> > For using boostbook/quickbook - this is described somewhere. It DOES
> > work, but it's not totally pain free to setup
> Comparing the above docs with
> http://www.boost.org/doc/libs/1_58_0/libs/python/doc/index.html, I
> notice a couple of differences, suggesting that the process of merging
> the Boost.Python docs into the Boost.org website isn't quite as
> straight-forward as dropping in some html files into the appropriate
Which differences are you concerned about? I ask because depending on which
ones I may have different answers :-)
-- -- Rene Rivera -- Grafik - Don't Assume Anything -- Robot Dreams - http://robot-dreams.net -- rrivera/acm.org (msn) - grafikrobot/aim,yahoo,skype,efnet,gmail
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC