Eric Niebler wrote:
I hate to flog this dead horse, but I'm still not overjoyed with what we
have for variable lists in the CSS. In particular, I think it makes
Doxygen-generated reference docs ugly and take up more vertical space
than necessary.
I prefer the vertical space, it makes the text easier to read.
I found an XSL parameter which formats variablelists as tables, and I
generated xpressive's docs with it. I also hacked our XSL transforms and
boostbook.css to support it.
This is before the change:
http://tinyurl.com/ho2a3
This is after the change:
http://tinyurl.com/fh43h
Look at the Parameters/Requires/Throws/Returns at the bottom to see the
difference. I was motivated by the fop stylesheets which produces PDFs
with beautiful table-like layouts for variable lists.
Are the "Requires", "Returns", "Throws" not a variable list, since they
don't show as a DL in the first one?
One of the problems with tabular layout I noticed, from looking at all
the docs, is that it creates inconsistent tab points as your example
shows. From my experience tabular layouts only work when you have strict
control of the horizontal tab points and hence can make them look
consistent. Otherwise the effect is of a lower quality page, and harder
to read as it makes one jump around left to right to follow the tabs.
My changes to the XSL transforms and the CSS are non-intrusive -- I can
commit them if others are interested. Then, to get the table-like
layout, people can just put <xsl:param>variablelist.as.table=1 in their
Jamfiles.
Opinions?
If you do, at minimum and if possible, please add class attributes to
the tables so that they can be distinguished from other tables.
--
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
