Re: [Boost-docs] GitHub no longer renders html

Subject: Re: [Boost-docs] GitHub no longer renders html
From: Stefan Seefeld (stefan_at_[hidden])
Date: 2016-10-06 18:00:20

On 06.10.2016 13:44, Paul A. Bristow wrote:

[...]
> I can see how to just *copy the generated /html* to a BoostGSoc15.github.io/fixed_point, but the build using Quickbook assumes that
> is in the Boost tree to get the icon, navigation and admonitions icons etc, so it would not work 'as is'.   
>
> I would like to just rebuild the docs and have the index.html redirect to the 
>
> https://github.com/BoostGSoC15/fixed_point/index.html
>
> This sounds the Right Thing to Do, but I can't see how to do it.

I'm not sure about "the Right Thing", as I never build anything "in
tree". In fact, I believe that building a stand-alone documentation tree
is very useful for example because it allows to be packaged and
installed separately.

For the Boost.Python project I'm doing this: I build the docs and upload
them to http://boostorg.github.io/python/.
In fact, I have gone a step beyond installing the resources (css, js,
pngs): I have cloned them into the Boost.Python repo at
https://github.com/boostorg/python, as that allows me to build
Boost.Python stand-alone. (It still requires some Boost components as
prerequisites, which may either come from the system's package manager,
or be installed separately as shown in my project's Travis CI logic in
https://github.com/boostorg/python/blob/develop/.travis.yml

> Suggestions welcome.
>
> Paul

Regards,
        Stefan

-- 
      ...ich hab' noch einen Koffer in Berlin...