CSS expert advice needed
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help? Thanks, -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams wrote:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
The footnote style is controlled with the "footnote" class in rst.css: .footnote { FONT-SIZE: 66%; VERTICAL-ALIGN: super; TEXT-DECORATION: none; } -- Daniel Wallin
Daniel Wallin <dalwan01@student.umu.se> writes:
David Abrahams wrote:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
The footnote style is controlled with the "footnote" class in rst.css:
.footnote { FONT-SIZE: 66%; VERTICAL-ALIGN: super; TEXT-DECORATION: none; }
I'm pretty sure that's just the style of the number that refers to the footnote (notice VERTICAL-ALIGN: super;). I'm concerned with the footnote text itself. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams wrote:
Daniel Wallin <dalwan01@student.umu.se> writes:
David Abrahams wrote:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
The footnote style is controlled with the "footnote" class in rst.css:
.footnote { FONT-SIZE: 66%; VERTICAL-ALIGN: super; TEXT-DECORATION: none; }
I'm pretty sure that's just the style of the number that refers to the footnote (notice VERTICAL-ALIGN: super;). I'm concerned with the footnote text itself.
I think Daniel is correct. The "footnote" class is on the table which contains each entire footnote entry. -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - Grafik/jabber.org
Rene Rivera <grafik.list@redshift-software.com> writes:
David Abrahams wrote:
Daniel Wallin <dalwan01@student.umu.se> writes:
David Abrahams wrote:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
The footnote style is controlled with the "footnote" class in rst.css:
.footnote { FONT-SIZE: 66%; VERTICAL-ALIGN: super; TEXT-DECORATION: none; }
I'm pretty sure that's just the style of the number that refers to the footnote (notice VERTICAL-ALIGN: super;). I'm concerned with the footnote text itself.
I think Daniel is correct. The "footnote" class is on the table which contains each entire footnote entry.
You're right! Thanks; fixed. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams <dave@boost-consulting.com> writes:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
That URL is broken from here --- it displays the text of the boost-consulting.com front page, without any images or styling. Anthony -- Anthony Williams Software Developer
Anthony Williams <anthony_w.geo@yahoo.com> writes:
David Abrahams <dave@boost-consulting.com> writes:
It has frustrated me that footnotes are rendered in such extremely small type in the Parameter library documentation (http://www.boost-consulting.com/libs/parameter), but I can't tell what needs to change in the CSS to fix it. Can anyone help?
That URL is broken from here --- it displays the text of the boost-consulting.com front page, without any images or styling.
Sorry, http://www.boost-consulting.com/boost/libs/parameter -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams <dave@boost-consulting.com> wrote:
I noticed funny character "<span class="doublesize">⋮</span>" on this page, just below "core::depth_first_search(dfs_params()(a0,a1));". It's in few other places, too. B.
Bronek Kozicki <brok@rubikon.pl> wrote:
David Abrahams <dave@boost-consulting.com> wrote:
I noticed funny character "<span class="doublesize">⋮</span>" on this page, just below "core::depth_first_search(dfs_params()(a0,a1));". It's in few other places, too.
I understand now that this character was meant to be "vertical ellipsis", however my browser apparently does not understand it. I'm affraid that this browser is among most popular ones (IE 6.0), thus I suggest that maybe something else should be used here. B.
"Bronek Kozicki" <brok@rubikon.pl> writes:
Bronek Kozicki <brok@rubikon.pl> wrote:
David Abrahams <dave@boost-consulting.com> wrote:
I noticed funny character "<span class="doublesize">⋮</span>" on this page, just below "core::depth_first_search(dfs_params()(a0,a1));". It's in few other places, too.
I understand now that this character was meant to be "vertical ellipsis", however my browser apparently does not understand it. I'm affraid that this browser is among most popular ones (IE 6.0), thus I suggest that maybe something else should be used here.
Okay, I'm tired of hearing these complaints so I'm replacing it with an ugly kluge that looks good in IE6 and Firefox too. -- Dave Abrahams Boost Consulting www.boost-consulting.com
"Bronek Kozicki" <brok@rubikon.pl> writes:
David Abrahams <dave@boost-consulting.com> wrote:
I noticed funny character "<span class="doublesize">â®</span>" on this page, just below "core::depth_first_search(dfs_params()(a0,a1));". It's in few other places, too.
This is Unicode character 0x22ee, which is 3 dots on top of each other, the vertical ellipsis. I guess it's included directly because there isn't a standard entity name for it. 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) Anthony -- Anthony Williams Software Developer
Anthony Williams <anthony_w.geo@yahoo.com> writes:
"Bronek Kozicki" <brok@rubikon.pl> writes:
David Abrahams <dave@boost-consulting.com> wrote:
I noticed funny character "<span class="doublesize">â®</span>" on this page, just below "core::depth_first_search(dfs_params()(a0,a1));". It's in few other places, too.
This is Unicode character 0x22ee, which is 3 dots on top of each other, the vertical ellipsis. I guess it's included directly because there isn't a standard entity name for it.
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. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> 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? 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? What do I need (other than docutils) to build it? FYI: The id/name errors occur on every heading, where there's a DIV with the ID attribute, which encompasses an H3 tag, with an A tag, with the identical NAME attribute. This is covered by section 12.2.3 of HTML4. "The id and name attributes share the same name space. This means that they cannot both define an anchor with the same name in the same document." "ILLEGAL EXAMPLE: The following excerpt is illegal HTML since these attributes declare the same name twice in the same document. <A href="#a1">...</A> ... <H1 id="a1"> ...pages and pages... <A name="a1"></A>" The nested link problem is again in the headers, but this time in the header for your section 2.5.3 (The Binding Metafunction), and your section 3.2 (No support for result_of) --- the titles contain cross-reference links, and the whole title is enclosed in an A tag, for the title anchor. This is covered by section 12.2.2 of HTML4 --- "an A element must not contain any other A elements" Anthony -- Anthony Williams Software Developer
Anthony Williams <anthony_w.geo@yahoo.com> writes:
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> 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
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> writes:
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
With a clean checkout from cvs, this reports that rst.css is missing. Copying it from the html subdir sorts things out. Shouldn't this just work? Anthony -- Anthony Williams Software Developer
Anthony Williams <anthony_w.geo@yahoo.com> writes:
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> writes:
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
With a clean checkout from cvs, this reports that rst.css is missing.
Can you post the exact error message with some context please?
Copying it from the html subdir
To where?
sorts things out. Shouldn't this just work?
Yes. Works for me. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> writes:
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> writes:
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
With a clean checkout from cvs, this reports that rst.css is missing.
Can you post the exact error message with some context please?
See below for the full bjam output.
Copying it from the html subdir
To where?
The libs/parameter/doc directory from which I was running bjam. Anthony warning: Python location is not configured warning: the Boost.Python library won't be built Building Boost.Regex with the optional Unicode/ICU support disabled. Please refer to the Boost.Regex documentation for more information (and if you don't know what ICU is then you probably don't need it). warning: no toolsets are configured. warning: you won't be able to build C++ programs. warning: please consult the documentation. ...found 18 targets... ...updating 4 targets... docutils.html ..\..\..\bin.v2\libs\parameter\doc\debug\index.html Traceback (most recent call last): File "c:/usr/docutils/tools/rst2html.py", line 25, in ? publish_cmdline(writer_name='html', description=description) File "c:\usr\docutils\docutils\core.py", line 347, in publish_cmdline config_section=config_section, enable_exit_status=enable_exit_status) File "c:\usr\docutils\docutils\core.py", line 224, in publish output = self.writer.write(self.document, self.destination) File "c:\usr\docutils\docutils\writers\__init__.py", line 72, in write self.translate() File "c:\usr\docutils\docutils\writers\html4css1.py", line 128, in translate self.visitor = visitor = self.translator_class(self.document) File "c:\usr\docutils\docutils\writers\html4css1.py", line 229, in __init__ stylesheet_text = open(stylesheet).read() IOError: [Errno 2] No such file or directory: 'rst.css' set PYTHONPATH=c:/usr/docutils;c:/usr/docutils/extras;%PYTHONPATH% python c:/usr/docutils/tools/rst2html.py -gdt --traceback --trim-footnote-reference-space --footnote-references=superscript --stylesheet=rst.css index.rst ..\..\..\bin.v2\libs\parameter\doc\debug\index.html ...failed docutils.html ..\..\..\bin.v2\libs\parameter\doc\debug\index.html... ...removing ..\..\..\bin.v2\libs\parameter\doc\debug\index.html ...skipped <phtml>index.html for lack of <p..\..\..\bin.v2\libs\parameter\doc\debug>index.html... docutils.html ..\..\..\bin.v2\libs\parameter\doc\debug\reference.html Traceback (most recent call last): File "c:/usr/docutils/tools/rst2html.py", line 25, in ? publish_cmdline(writer_name='html', description=description) File "c:\usr\docutils\docutils\core.py", line 347, in publish_cmdline config_section=config_section, enable_exit_status=enable_exit_status) File "c:\usr\docutils\docutils\core.py", line 224, in publish output = self.writer.write(self.document, self.destination) File "c:\usr\docutils\docutils\writers\__init__.py", line 72, in write self.translate() File "c:\usr\docutils\docutils\writers\html4css1.py", line 128, in translate self.visitor = visitor = self.translator_class(self.document) File "c:\usr\docutils\docutils\writers\html4css1.py", line 229, in __init__ stylesheet_text = open(stylesheet).read() IOError: [Errno 2] No such file or directory: 'rst.css' set PYTHONPATH=c:/usr/docutils;c:/usr/docutils/extras;%PYTHONPATH% python c:/usr/docutils/tools/rst2html.py -gdt --traceback --trim-footnote-reference-space --footnote-references=superscript --stylesheet=rst.css reference.rst ..\..\..\bin.v2\libs\parameter\doc\debug\reference.html ...failed docutils.html ..\..\..\bin.v2\libs\parameter\doc\debug\reference.html... ...removing ..\..\..\bin.v2\libs\parameter\doc\debug\reference.html ...skipped <phtml>reference.html for lack of <p..\..\..\bin.v2\libs\parameter\doc\debug>reference.html... ...failed updating 2 targets... ...skipped 2 targets...
participants (14)
-
Anthony Williams -
Bronek Kozicki -
Daniel Wallin -
David Abrahams -
Rene Rivera