wiki:UnifiedLookAndFeelProject

Version 14 (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
  2. PDF docs
  3. Trac

HTML docs

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 execute

warning: the below instructions have not been tested with a command line client - could someone test them? 

   svn switch -N http://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 .

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

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.