wiki:UnifiedLookAndFeelProject

Version 17 (modified by Stjepan Rajko, 15 years ago) ( diff )

--

Improving Boost Docs Project

Unified Look and Feel Project

Integrate Boost documents and resources with a common look and feel.

Table of contents

  1. HTML docs
    1. Check out the new style
    2. Some of the new features
    3. Known issues
    4. Subprojects
  2. PDF docs
  3. Trac

HTML docs

Check out the new style

You can see the latest iteration of the ​new style here.

If you checkout boost from the SVN repository, you can build docs with the new style by switching the appropriate XSL directory to the updated version in the sandbox. To switch, go to the tools/boostbook/xsl directory of your checked out boost working copy, and depending on whether you check out using http or https, execute one of the following: 

      svn switch -N http://svn.boost.org/svn/boost/sandbox/boost_docs/trunk/tools/boostbook/xsl .
 (or) svn switch -N https://svn.boost.org/svn/boost/sandbox/boost_docs/trunk/tools/boostbook/xsl .

This will make that particular working copy directory be synchronized with the new style. To switch back, execute: 

      svn switch -N http://svn.boost.org/svn/boost/trunk/tools/boostbook/xsl .
 (or) svn switch -N https://svn.boost.org/svn/boost/trunk/tools/boostbook/xsl .

To use the new style, you may need to modify to your Jamfile. Either of the following lines will pull in all of the style files needed: 

      <xsl:param>project.root=path-to-project-style-root
 (or) <xsl:param>boost.root=path-to-project-style-root

Correctly structured project styles are located at:

You can use any of them as your path-to-project-style-root.

Some of the new features

  • Validated XHTML 1.1 output (better than strict XHTML)
  • New header and footer based on beta.boost.org.
  • ​GroupedLinks select boxes for Boost libraries and quick jumps to sections.
  • Google Search box for our docs.
  • Box-wrapper-based blurbs that allow us to include rounded corners, drop shadows, etc.
  • Highlighting of alternative syntax that simulates your own IDE (move the mouse to the upper righthand corner of a code block)
  • Chapter logo support
  • Modular CSS design
  • CSS-based admonitions and navigation graphics
  • Quickbook source stylesheet

Known issues

Subprojects

The following subprojects deal with HTML documents

PDF docs

PDF stylesheet matches the ULF.

Look for the following subprojects:

Trac

Trac stylesheet that matches the ULF of Boost.

Subproject

Attachments (1)

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.