[[Image(ImprovingBoostDocs:ibdp.png,nolink)]]

   * [ImprovingBoostDocs Improving Boost Docs]
      * [ImprovingBoostDocs About this project]
      * [BoostDocsRepository Boost docs repository]
      * [UnifiedLookAndFeelProject Unified look and feel project]
      * [HelpingBoostAuthors Helping Boost authors]
      * [GlueDocsProject Glue docs project]
      * [StandardCppLibraryDocumentation Standard C++ Library docs]
      * [DocumentationBestPractices Documentation best practices]
      * [DocumentationTools Documentation tools]
      * [ImprovingBoostDocsSubprojects Subprojects]
           * [BoostDocTest Boost.DocTest ]
           * [BoostHtmlStylesheet Boost HTML stylesheet]
           * [BoostKateSupport Boost Kate support]
           * [BoostPdfStylesheet Boost PDF stylesheet]
           * [BoostSpecificWikiMacros Boost-specific WikiMacros]
           * [BoostTracStylesheet Boost Trac stylesheet]
           * [BoostscriptProject Boostscript]
           * [GoogleSearchBoxProject Google Search box project]
           * [HtmlToDockbookProject HTML to docbook]
           * [QuickbookWikiProcessor Quickbook WikiProcessor]
           * '''[QuickbookSourceStylesheetProject Quickbook source stylesheet]'''
           * [SvgIconsSetProject SVG icons set project]
           * [SyntaxHighlightingProject Syntax-highlighting project]
           * [BoostTracSyntaxColoring Trac syntax-coloring]
           * [DebuggerVisualizers Debugger visualizers]
      * [BrowserTestingChart Browser-testing chart]
      * [LibrariesLogos Logo playground]

----

[[Image(ImprovingBoostDocsSubprojects:quickbook_source_stylesheet.png,nolink)]]

=== 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 [HtmlToDockbookProject 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 
[http://beta.boost.org/development/doc/doc_test/doc/html/index.html 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 [http://tinyurl.com/2jh25t Boost.Bind page].
     [[Br]]To use it, you must add a CSS link to the header of your HTML:
     [[Br]]
     [[Br]]''<link rel="stylesheet" href="{BOOST_ROOT}/doc/style/html/conversion/html_to_quickbook.css" type="text/css" />''
     [[Br]]
     [[Br]]The results are not so good as before: there is no navigation support, no
     admonitions rendering, etc

   * A better option will be to first use the results of the 
     [HtmlToDockbookProject HTML to docbook project].


=== 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 
[ImprovingBoostDocsSubprojects#Subprojectsorganization subprojects repository] soon.

In Boost root, the stylesheets can be found at:

{{{
doc/style/html/conversion
}}}

----

=== Active developers ===

[[Br]][[Image(People:matias_capeletto.png,50)]]
[[Br]]'''Matias Capeletto''' 
[[Br]][http://www.ohloh.net/accounts/5462/positions/2302 Ohloh statistics]
[[Br]][http://www.linkedin.com/in/matiascapeletto Linked In profile]
[[Br]]''matias dot capeletto at gmail dot com''
[[Br]]
[[Br]][[Image(People:rene_rivera.png,50)]]
[[Br]]'''Rene Rivera'''
[[Br]][http://www.ohloh.net/accounts/911/positions/1130 Ohloh statistics]
[[Br]][http://www.linkedin.com/in/rrivera Linked In profile]
[[Br]]''email unknown''

----

   * [ImprovingBoostDocs Improving Boost Docs]
      * [ImprovingBoostDocs About this project]
      * [BoostDocsRepository Boost docs repository]
      * [UnifiedLookAndFeelProject Unified look and feel project]
      * [HelpingBoostAuthors Helping Boost authors]
      * [GlueDocsProject Glue docs project]
      * [StandardCppLibraryDocumentation Standard C++ Library docs]
      * [DocumentationBestPractices Documentation best practices]
      * [DocumentationTools Documentation tools]
      * [ImprovingBoostDocsSubprojects Subprojects]
           * [BoostDocTest Boost.DocTest ]
           * [BoostHtmlStylesheet Boost HTML stylesheet]
           * [BoostKateSupport Boost Kate support]
           * [BoostPdfStylesheet Boost PDF stylesheet]
           * [BoostSpecificWikiMacros Boost-specific WikiMacros]
           * [BoostTracStylesheet Boost Trac stylesheet]
           * [BoostscriptProject Boostscript]
           * [GoogleSearchBoxProject Google Search box project]
           * [HtmlToDockbookProject HTML to docbook]
           * [QuickbookWikiProcessor Quickbook WikiProcessor]
           * '''[QuickbookSourceStylesheetProject Quickbook source stylesheet]'''
           * [SvgIconsSetProject SVG icons set project]
           * [SyntaxHighlightingProject Syntax-highlighting project]
           * [BoostTracSyntaxColoring Trac syntax-coloring]
           * [DebuggerVisualizers Debugger visualizers]
      * [BrowserTestingChart Browser-testing chart]
      * [LibrariesLogos Logo playground]