Version 45 (modified by 15 years ago) ( diff ) | ,
---|
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look & feel project
- Helping Boost Authors
- Glue docs project
- Standard C++ Library Docs
- Documentation Best Practices
- Documentation Tools
- Subprojects
- Boost.DocTest
- Boost HTML stylesheet
- Boost Kate support
- Boost PDF stylesheet
- Boost-Specific WikiMacros
- Boost Trac stylesheet
- Boostscript
- Google Search Box project
- HTML to docbook
- Quickbook WikiProcessor
- Quickbook source stylesheet
- SVG icons set project
- Syntax highlighting project
- Trac Syntax Coloring
- Debugger Visualizers
- Browser Testing Chart
- Logo Playground
Improving Boost Docs Subprojects
Table of contents
- Subprojects organization
- Projects waiting for developers
- Projects in progress
- Important External Projects
Subprojects organization
The branch organization presented here is based on the discussion in the Boost dev list about the best way to organize the main Boost repository. Since we must define our work methodology, this subproject can be used as a proof of concept.
Projects (such as the translation effort) are being committed directly to the Boost Docs project trunk. The repository is in the following location:
https://svn.boost.org/svn/boost/sandbox/boost_docs/trunk
The Docs project can not affect the work of other people. If we commit a buggy version of a subproject to the trunk, we can bother the work of other users! To avoid this, we will use the trunk as a merging repository. Each subproject will have its own repository placed at:
https://svn.boost.org/svn/boost/sandbox/boost_docs/subprojects
The organization will be the same for each subproject
- subproject_name
- branches
- tags
We will use dates to specify not so buggy versions with the format: subproject_name_yyyy-mm-dd
Example: boostbook_2007-06-28 - trunk
Development branch for the subproject.- doc
- example
- test
There are some subprojects that must be integrated in the Boost Docs trunk repository, such as Improving Boostbook and Stylesheets projects. When you feel confident with a given version, you can simply copy the last tag of your subproject to the main trunk.
Each subproject has a Wiki page with additional information.
Projects waiting for developers
If you are interested, please send a mail to the Boost-docs list telling us you want to help.
- Boost Specific WikiMacros
Write a simple proposal for new Boost-specific WikiMacros. Proposals should include the rationale behind each decision and the implementation of each proposed macro.
- Google Search Box Project
We need help with the Google Search Box that appears in the banner. Our idea is to use a Linked CSE Custom Google Search, an XML-based approach that allows us to specify the generated search page.
We need to investigate the Linked CSE technology and came up with a tested XML definition for our libs.
- Quickbook WikiProcessor
A Trac WikiProcessor written in Python that integrates Rene Rivera's HTML backend in the Trac Wiki.
- Syntax highlighting project
This project consists of checking that the colors are right. Workers will also create color schemas for missing IDEs. When this first task is finished, this project will determine a default syntax highlighting scheme for Boost. This color scheme may be a combination of existing schemes.
- Trac Syntax Coloring
Trac can be extended to support coloring of source code both in the Wiki and while browsing the repository.
The project will consist in developing style definitions for common Boost file extensions (.hpp, .xml, etc) so Trac correctly performs source coloring.
Projects in progress
- Boost.DocTest
A Quickbook based document that exercise all possible constructs.
Eric Niebler, Joel de Guzman, John Maddock, Matias Capeletto, Paul Bristow
- Boost HTML Stylesheet
As part of the Unified Look & Feel Project, we are making a standard CSS file that can be used in Boost HTML docs.
Rene Rivera, Matias Capeletto, Joel de Guzman
- Boost Kate Support
Syntax coloring, auto-commet and folding support for Boost C++, Quickbook and Jamfiles.
Matias Capeletto
- Boost PDF Stylesheet
Another project member of the Unified Look & Feel Project. We will adapt the PDF look and feel to be as close as possible to the HTML generated docs (but not closer, because PDF design rationale is different from HTML design decisions.
John Maddock
- Boost Trac Stylesheet
Once we settled down with a look and feel for our docs, we will tuned the Trac CSS to match it. We have started by doing some testing.
Douglas Gregor, Matias Capeletto
- Boostscript
Javascript library used by Boostbook to achieve things like dynamic selection of syntax coloring, easy navigation of Boost docs, and old browser fixes.
Matias Capeletto
- HTML to docbook
We are looking for solution to convert normal HTML into Docbook files.
Glyn Matthews
- Quickbook source stylesheet
We are developing a CSS file that allows a Boostbook-based HTML as Quickbook source in a common browser.
Rene Rivera, Matias Capeletto
- SVG icons set project
Find scalable vector graphics icons for navigation and admonitions. These can be used in PDF and HTML output.
Peter Foley
- Debugger Visualizers
Support for Boost data types debugging in common IDEs.
Filip Konvička
Important External Projects
These projects are independent from the "Improving Boost Docs" umbrella. They are included here because they are helpful to this project. If you are a developer from one of the projects, feel free to move them to the list above!
- Quickbook HTML backend
Rene Rivera
- Automatic Generation of Doc Files Standard Structure
Stjepan Rajko
- Generation of SVG Images From Standard Containers
Jacob Robert Voytko
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look & feel project
- Helping Boost Authors
- Glue docs project
- Standard C++ Library Docs
- Documentation Best Practices
- Documentation Tools
- Subprojects
- Boost.DocTest
- Boost HTML stylesheet
- Boost Kate support
- Boost PDF stylesheet
- Boost-Specific WikiMacros
- Boost Trac stylesheet
- Boostscript
- Google Search Box project
- HTML to docbook
- Quickbook WikiProcessor
- Quickbook source stylesheet
- SVG icons set project
- Syntax highlighting project
- Trac Syntax Coloring
- Debugger Visualizers
- Browser Testing Chart
- Logo Playground
Attachments (15)
-
boost_doc_test.png
(69.3 KB
) - added by 15 years ago.
Boost.DocTest
-
boost_hs.png
(29.9 KB
) - added by 15 years ago.
boost::hs
-
boost_html_stylesheet.png
(17.7 KB
) - added by 15 years ago.
Boost HTML stylesheet
-
boost_pdf_stylesheet.png
(17.6 KB
) - added by 15 years ago.
Boost PDF stylesheet
-
boostscript.png
(15.7 KB
) - added by 15 years ago.
Boostscript
-
boost_trac_stylesheet.png
(15.9 KB
) - added by 15 years ago.
Boost Trac stylesheet
-
boost_trac_syntax_coloring.png
(11.8 KB
) - added by 15 years ago.
Boost Trac Syntax coloring
-
boost_trac_wiki_macros.png
(11.4 KB
) - added by 15 years ago.
Boost Trac Wiki macros
-
boost_trac_wiki_processors.png
(13.4 KB
) - added by 15 years ago.
Boost Trac Wiki processors
-
google_at_boost.png
(12.1 KB
) - added by 15 years ago.
Google at Boost
-
html_to_dockbook.png
(37.1 KB
) - added by 15 years ago.
HTML to Docbook
-
quickbook_source_stylesheet.png
(75.3 KB
) - added by 15 years ago.
Quickbook source stylesheet
-
svg_icons_set.png
(35.5 KB
) - added by 15 years ago.
SVG Icons set
-
syntax_highlighting.png
(12.4 KB
) - added by 15 years ago.
Syntax Highlighting
-
boost_debugger_visualizers.png
(14.2 KB
) - added by 15 years ago.
Boost Debugger Visualizers
Download all attachments as: .zip