Re: [Boost-docs] [poly_collection] Doc not being automatically built

Subject: Re: [Boost-docs] [poly_collection] Doc not being automatically built
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2017-06-06 14:31:55

On Tue, Jun 6, 2017 at 7:28 AM, Joaquin M López Muñoz via Boost-docs <
boost-docs_at_[hidden]> wrote:

> El 06/06/2017 a las 1:02, Rene Rivera via Boost-docs escribió:
>
>
> On Mon, Jun 5, 2017 at 6:01 PM, Joaquín M López Muñoz via Boost-docs <
> boost-docs_at_[hidden]> wrote:
>
>>
>> The redirect *was* wrong, I fixed it an hour ago:
>>
>> https://github.com/boostorg/poly_collection/commit/8b65ec8c0
>> 0e0c813dc34e5fbae070578763c9745
>>
>
> Ah, awesome. We'll just have to wait for the builds to get propagated to
> the web site.
>
>
> The redirect is already working and we're almost there. For some reason
> images
> are not being copied in the process, see for example:
>
> http://www.boost.org/doc/libs/develop/doc/html/poly_
> collection/an_efficient_polymorphic_data_st.html
>
> The first broken image URL is
>
> http://www.boost.org/doc/libs/develop/doc/html/img/ptr_vector.png
>
> which for whatever reason is not there. The image copy action is
>
>   # HTML dependencies for standalone docs.
>   install images : [ glob img/*.png ] : <location>html/img ;
>   explicit images ;
>
> referred to in
>
>   alias boostdoc : poly_collection : : <dependency>images ;
>
> FWIW, image copying is succesful when buiilding standalone:
>
>   boostbook standalone
>     : poly_collection
>     :
>       <xsl:param>boost.defaults=Boost
>       <xsl:param>boost.image.src=img/boost.png
>       <xsl:param>boost.root=http://www.boost.org/doc/libs/release
>       #<xsl:param>boost.root=../../../..
>       <dependency>images
>   ;
>
> 1. Any clue what's going on?
>

Yes.. You should copy it to the common root/doc/html directory instead.

> 2. Is ...doc/html/img/ a permissible folder to copy images? Should I use
> e.g. ...doc/html/poly_collection/img/ instead to prevent collisions with
> other
> libs? I can't seem to find any guideline to this respect.
>

There is no current guideline.. But anything sensible like using your own
sub-directory is appreciated.

-- 
-- Rene Rivera
-- Grafik - Don't Assume Anything
-- Robot Dreams - http://robot-dreams.net
-- rrivera/acm.org (msn) - grafikrobot/aim,yahoo,skype,efnet,gmail