Subject: Re: [Boost-docs] interface between library documentation and Boost website
From: Stefan Seefeld (stefan_at_[hidden])
Date: 2015-07-17 18:36:36
On 17/07/15 02:32 PM, Rene Rivera wrote:
>
> OK then..
>
> * Yes, the HTML files as presented on the web site are dynamically
> post-process with some PHP scripting. I know, yuck.. But it was the
> easiest way to not have to support making the docs match the style of
> the website, avoid changing the doc build process, and support
> browsing docs from different Boost releases.
>
> * The post-process is not done for all libraries. As some library docs
> are too complicated. It's mostly just the ones that use
> QuickBook/BoostBook.
>
> * The style sheets are different on the web site. They are somewhat
> more complex than the regular doc ones.
>
> * Some of the navigation elements/links are removed. Basically the
> ones in the header as we try and keep the global web site header
> around, if possible, everywhere.
OK, yes, I can see this being the most expedient solution. But let me
ask again: is this process documented anywhere (are the sources
available, so I can attempt to run this locally to validate any changes
I may apply) ?
Thanks,
Stefan
-- ...ich hab' noch einen Koffer in Berlin...
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC