Thanks for the feedback. Below, you will find the patches to boost/doc/html/boostbook.css and boost/tools/boostbook/xsl/html.xsl. I am also going to put these in the Files section if you want to grab a copy from there. Here is the status on some of the feedback from the new look and feel:
[1] Boost navigation links and "standalone": links are not generated when the doc.standalone parameter is set to 'true'.
[2] Navigation arrows at the top: I am working on these :). Don't worry, getting this functionality is high on my priorities. Does anyone know where the code that generates the bottom links is found, to speed up the process?
[3] TOC rendering: I have added the change to the .toc style suggested by Volodya.
[4] Empty TOC's: I am working on removing empty TOCs - this is only in some of the docs (boostbook/doc/html/reference for example).
[4] Table Rendering: I have worked out a CSS approach that does what Volodya has suggested regarding a 'flat' table layout -- what do other people think? NOTE: You can revert back to the 3D look by removing:
[114] table, td, th{ border: 0pc; }
[5] Reference::Synopsis (refsynopsisdiv) rendering: This element is rendered as:
<div class = "refsynopsisdiv">
<h2>Synopsis</h2>
boostbook ::== (...)
</div>
which makes it hard to apply programlisting-like rendering to :(. I have modified the XSL:T to render it as:
<h2 class = "refsynopsisdiv">Synopsis</h2>
<div class = "refsynopsisdiv">
boostbook ::== (...)
</div>
Does this break anything? I personally prefer separation of title and body, as it gives greater styling control.
Index: boostbook.css =================================================================== RCS file: /cvsroot/boost/boost/doc/html/boostbook.css,v retrieving revision 1.1 diff -w -r1.1 boostbook.css 19a20
margin-top: 1pc;
61c62 < div.table table, div.informaltable table, .section-title ---
.toc
63c64,66 < background-color: #EEE; ---
border: 0.2em ridge lightcoral;
padding: 0.5pc;
background-color: #DDD;
font-family: Courier, Lucida Console;
font-size: 80%;
.table table, div.informaltable table, .section-title { background-color: #EEE; }
98c108,110 < .toc ---
table, td, th{ border: 0pc; }
.table table tr td, div.informaltable table tr td
100,102c112 < border: 0.2em ridge lightcoral; < padding: 0.5pc; < background-color: #DDD; ---
background-color: #CCC;
121d130 <
Index: html.xsl
===================================================================
RCS file: /cvsroot/boost/boost/tools/boostbook/xsl/html.xsl,v
retrieving revision 1.10
diff -w -u -r1.10 html.xsl
--- html.xsl 5 Feb 2004 15:16:39 -0000 1.10
+++ html.xsl 6 Feb 2004 19:44:08 -0000
@@ -7,7 +7,7 @@
<xsl:import
href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"/>
- <xsl:param name="html.stylesheet" select="'reference.css'"/> + <xsl:param name="html.stylesheet" select="'boostbook.css'"/> <xsl:param name="navig.graphics" select="1"/> <xsl:param name="navig.graphics.extension" select="'.png'"/> <xsl:param name="chapter.autolabel" select="1"/> @@ -18,41 +18,40 @@ <xsl:param name="make.year.ranges" select="1"/> <xsl:param name="generate.manifest" select="1"/> <xsl:param name="generate.section.toc.level" select="3"/> + <xsl:param name="doc.standalone" select="true"/>
<xsl:template name="header.navigation">
- <table border="1" cellpadding="2" bgcolor="#007F7F">
+ <table border = "1" cellpadding = "2" width = "100%" class = "boost-head">
<tr>
- <td bgcolor="#FFFFFF">
+ <td bgcolor = "#FFFFFF" width = "50%">
<img src="../../c++boost.gif"
alt="c++boost.gif (8819 bytes)" width="277" height="86"/>
</td>
- <td>
- <a href="../../index.htm">
- <font color="#FFFFFF" size="4" face="Arial">Home</font>
- </a>
- </td>
- <td>
- <a href="libraries.html">
- <font color="#FFFFFF" size="4" face="Arial">Libraries</font>
- </a>
- </td>
- <td>
- <a href="../../people/people.htm">
- <font color="#FFFFFF" size="4" face="Arial">People</font>
- </a>
- </td>
- <td>
- <a href="../../more/faq.htm">
- <font color="#FFFFFF" size="4" face="Arial">FAQ</font>
- </a>
- </td>
- <td>
- <a href="../../more/index.htm">
- <font color="#FFFFFF" size="4" face="Arial">More</font>
- </a>
+ <xsl:choose>
+ <xsl:when test = "$doc.standalone = 'true'">
+ <td align = "center" class = "boost-headtd">Home</td>
+ <td align = "center" class = "boost-headtd">Libraries</td>
+ <td align = "center" class = "boost-headtd">People</td>
+ <td align = "center" class = "boost-headtd">FAQ</td>
+ <td align = "center" class = "boost-headtd">More</td>
+ </xsl:when><xsl:otherwise>
+ <td align = "center" class = "boost-headtd">
+ <a href="../../index.htm" class = "boost-headelem">Home</a>
+ </td><td align = "center" class = "boost-headtd">
+ <a href="libraries.html" class = "boost-headelem">Libraries</a>
+ </td><td align = "center" class = "boost-headtd">
+ <a href="../../people/people.htm" class = "boost-headelem">People</a>
+ </td><td align = "center" class = "boost-headtd">
+ <a href="../../more/faq.htm" class = "boost-headelem">FAQ</a>
+ </td><td align = "center" class = "boost-headtd">
+ <a href="../../more/index.htm" class = "boost-headelem">More</a>
</td>
+ </xsl:otherwise>
+ </xsl:choose>
</tr>
</table>
+ <div class = "nav-top">[Nav Links: UNDER CONSTRUCTION]</div>
+ <hr/>
</xsl:template>
<xsl:template name="format.cvs.revision">
@@ -192,4 +191,18 @@
<!-- We don't want refentry's to show up in the TOC because they
will merely be redundant with the synopsis. -->
<xsl:template match="refentry" mode="toc"/>
+
+ <!-- override the behaviour of some DocBook elements for better
+ rendering facilities -->
+
+ <xsl:template match = "programlisting[ancestor::informaltable]">
+ <pre class = "table-{name(.)}"><xsl:apply-templates/></pre>
+ </xsl:template>
+
+ <xsl:template match = "refsynopsisdiv">
+ <h2 class = "{name(.)}-title">Synopsis</h2>
+ <div class = "{name(.)}">
+ <xsl:apply-templates/>
+ </div>
+ </xsl:template>
</xsl:stylesheet>Regards, Reece
_________________________________________________________________
It's fast, it's easy and it's free. Get MSN Messenger today! http://www.msn.co.uk/messenger
------------------------------------------------------- The SF.Net email is sponsored by EclipseCon 2004 Premiere Conference on Open Tools Development and Integration See the breadth of Eclipse activity. February 3-5 in Anaheim, CA. http://www.eclipsecon.org/osdn _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
