On Monday 27 January 2003 09:03 am, Jeff Garland wrote:
> > could specify that the image filenames are relative to $(BOOST_ROOT) and
> > have the BoostBook XSL put in the appropriate relative path or we could
> > require that all images be in libs/<library-name>/doc_src/images and
> > include a <libimagedata> element that looks there for images.
>
> Probably either would be fine although I'm not sure I follow the need
> for libimagedata? And perhaps we should just leave them in the
> <lib-name>/doc/images since that is the target destination. This
> will allow for simpler extraction of docs (we don't have to reach
> into a doc_src directory). I'm assuming we will still be checking-in
> the derived html documentation at this location anyway so we could
> just leave the images here.
>
> Jeff
I'm not sure that libs/<lib-name>/doc/images is the target destination for
images, because libs/<lib-name>/doc isn't the target destination for HTML
documentation: that goes into $(BOOST_ROOT)/doc/html. Actually, I don't see
the point of libs/<lib-name>/doc_src any more, because I'm not sure there
would ever be a libs/<lib-name>/doc.
Perhaps BoostBook documentation should just go into libs/<lib-name>/doc with
images in libs/<lib-name>/doc/images. Then when we generate HTML (in
$BOOST_ROOT/doc/html) we will refer to the images in-place.
The original reason I had for libimagedata is that I don't believe we want to
rewrite the fileref in <imagedata> unconditionally to
../../libs/<lib-name>/doc/images because not all images will be referenced
from within a library (e.g., the documentation of BoostBook won't be in a
library). However, perhaps we can just say: "if the <imagedata> is in a
<library>, use $BOOST_ROOT/libs/<lib-name>/doc/images; otherwise, use
$BOOST_ROOT/doc/images".
Doug
-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
