Subject: Re: [Boost-docs] interface between library documentation and Boost website
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-07-16 08:55:33
> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Robert Ramey
> Sent: 15 July 2015 18:27
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] interface between library documentation and Boost website
> On 7/15/15 9:44 AM, Paul A. Bristow wrote:
> > PS It is sad that on github, clicking on the index.html file shows the
> > raw html, not what you see using a browser. There is a github.io bit
> There's a fix for this.
> will open the html directory right in github.
In my experience, it doesn't really work on complicated Boost library documentation with lots of
I'll look into RawGit <https://rawgit.com/> after Rene Rivera's recommendation - it looks fine on
prefed - but it's pretty simple and there aren't many links.
PS My experience with rewriting some documentation is that it is better to simply cut and paste from
the displayed html. If you are knowledgable about the library
So what's the entry point ? A single top-level index.html file in the doc/ directory ?
I'd favour a redirection in both /libs/yourlibrary/index.html and in
to a folder /libs/yourlibrary/doc/html/ containing 'real' index.html
Otherwise, no restrictions.
--- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 (0) 1539 561830
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC