Doug Gregor writes:On Mon, 4 Oct 2004, Joel wrote:Actually, these are BoostBook babies. I already noted the long filename problems in the boost-docs list a few weks ago. Rene Rivera added on top of my post the multiple dot issue. I don't know BoostBook enough to fix it. No solutions were suggested, yet. Doug? Anyone?
Oh, yuck. Well, if anyone is up for learning XSLT, this would be a great
time. We'll probably end up having to modify the DocBook chunker to
rewrite '.''s as '_''s when outputting files (and linking to them!), which
can be done via tools/boostbook/xsl/html.xsl.
I'm afraid simply replacing dots by something else won't be enough, since
it would still leave us with too-long filenames problem (consider this one,
for instance: "bbv2.reference.buildprocess.alternatives.html"). I really
think these dot-separated parts should become subdirectories, e.g.
bbv2/reference/buildprocess/alternatives.html
We'd still need to watch for their depth, of course.
Ah, right. The subdirectories might actually be a better way to organize the documentation anyway.
The price for that would be to have to tell everybody who wants to use BoostBook on Windows themselves to grab a patched version of "xsltproc" which is able to generate the subdirs in this manner (it works as-is on other platforms).
That's fine by me.
If nobody objects, I'll handle the XSLT rewrite.
Thank you! Sorry I can't be more helpful at the moment :(
Doug
------------------------------------------------------- This SF.net email is sponsored by: IT Product Guide on ITManagersJournal Use IT products in your business? Tell us what you think of them. Give us Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more http://productguide.itmanagersjournal.com/guidepromo.tmpl _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
