Re: [boost] CSS expert advice needed

From: David Abrahams (dave_at_[hidden])
Date: 2005-08-05 11:16:41

Anthony Williams <anthony_w.geo_at_[hidden]> writes:

> David Abrahams <dave_at_[hidden]> writes:
>
>> Anthony Williams <anthony_w.geo_at_[hidden]> writes:
>>> BTW, Dave, it's probably worth running Tidy over the HTML, since it picks up a
>>> few things, such as nested <a> tags, and id's that clash with name's
>>> (e.g. table-of-contents is both an id on a DIV, and a name on an A tag, which
>>> is not allowed)
>>
>> Nothing I can do about it other than try to fix docutils, and every
>> time I've reported that tidy complains about something docutils
>> generates the docutils people have told me that tidy is wrong.  So, I
>> don't want to seem uncooperative or like I don't care about validity,
>> but I hope you'll understand when I say "be my guest and report the
>> problems to docutils if you think you know the HTML rules well
>> enough."  I sure don't.
>
> I certainly understand. If I believed my tool was right and another tool
> complained, I'd blame the other tool, too.
>
> However, I happen to agree with tidy, so I think it's worth giving feedback to
> the docutils people. Do you mean the project at docutils.sourceforge.net?

Yes.  There's a gmane reflector for their lists.

> Where's the source code for these web pages, and how do I run docutils on it?
> Is it nicely in CVS with a bjam script? 

Yes.  libs/parameter/doc.  Use 

  bjam --v2 html

Don't forget to configure docutils in your user-config.jam.  Mine
says:

  using docutils : c:/src/docutils ;

> What do I need (other than docutils) to build it?

Nothing.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com