Re: GitHub no longer renders html

Stefan Seefeld <[email protected]> Thu, 6 Oct 2016 14:00:20 -0400
Newsgroups gmane.comp.lib.boost.documentation
Message-ID <[email protected]>
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...