wiki:QuickbookSourceStylesheetProject

Improving Boost Docs Project

Quickbook source stylesheet

Introduction

Using modern CSS capabilities, we can change to a great degree the way HTML pages will be rendered. A stylesheet can be developed that takes the HTML generated by Boostbook and shows it as Quickbook source. This will allow the easy translation of Boostbook docs to Quickbook, and, once the HTML to docbook project finds a good solution, we will have achieved a path from common HTML docs to Quickbook sources that is very appealing.

Status

The stylesheet is fully functional. You can sample it for the ​on-line Boost.DocTest document. From the View menu in Firefox 2, select Page Style > Quickbook Source.

Common HTML

Non-docbook-based HTML translations can be made in two ways:

  • Use a version of the CSS that allows HTML to be viewed as Quickbook. You can see the results in a ​Boost.Bind page.
    To use it, you must add a CSS link to the header of your HTML:

    <link rel="stylesheet" href="{BOOST_ROOT}/doc/style/html/conversion/html_to_quickbook.css" type="text/css" />

    The results are not so good as before: there is no navigation support, no admonitions rendering, etc

Resources

See an up-to-date online version at: 

http://beta.boost.org/development/doc/doc_test/doc/html/index.html

Sources are currently stored in the main trunk of the Boost docs project but will be moved to the subprojects repository soon.

In Boost root, the stylesheets can be found at: 

doc/style/html/conversion

Active developers


Matias Capeletto
Matias Capeletto
​Ohloh statistics
​Linked In profile
matias dot capeletto at gmail dot com

Rene Rivera
Rene Rivera
​Ohloh statistics
​Linked In profile
email unknown

Last modified 15 years ago Last modified on Jul 17, 2007, 9:36:07 AM
Note: See TracWiki for help on using the wiki.