On Thursday 02 January 2003 08:37 pm, Beman Dawes wrote: > At 06:08 PM 1/2/2003, Douglas Gregor wrote: > > 2) Modify the existing XSLT stylesheet that generates the alphabetical > > and > > >categorized lists to support HTML documentation along with the DocBook > >documentation. This means that an equivalent to libs/libraries.htm will > > be > > >autogenerated from the DocBook sources and will include libraries whose > >documentation is either DocBook or is HTML. > > > >I think (2) is far better, because I can generate (nightly) all of the > >formats > >from the DocBook document, and link to the HTML documentation of > > libraries > > >that don't have DocBook documentation. I would then suggest that the > >"Documentation" link on the Boost site be changed to contain links to the > > > >1.29.0 documentation (in the local directory tree) and to the CVS > >documentation (somewhere off in autogenerated land). > > I don't have enough knowledge yet to comment. I guess it is time to look at > samples. Where should I look?
I've implemented option #2, by allowing BoostBook descriptions of libraries to include an "html-only" attribute. In this case, links to the library go to libs/<library-directory-name>/index.html. Not all libraries have documentation there, but enough do for a proof-of-concept, which is here: http://www.cs.rpi.edu/~gregod/Boost/doc/html/ch01.html Doug ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
