Version 13 (modified by 15 years ago) ( diff ) | ,
---|
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look and 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
Introduction
Trac Wiki allows the use of macros to help with common needs like a table of contents (TOC) or the insertion of an image. They work similarly to Quickbook templates. There are only a bunch of them in the official Trac release, and it will be very helpful to have a set of Boost-specific macros that make it easy to do common things like referring to a particular section of boost docs. Something like:
[[BoostDocSection(regex,introduction)]]
Objectives
- Investigate current official Macros and not-so-official macros to look for the things we may find useful ( See Includes, Last modified, Add comment, footnote, rss get and visit counter for some examples).
- Write a not-too-cluttered proposal for new Boost-specific WikiMacros, including the rationale behind each decision.
- Implement the Macros specified in the proposal. Luckily Trac uses Python for this!
Initial Ideas
Link to Boost libraries documentation
[[BoostDocLink(regex,introduction)]]
TOC-generator
A macro that generates something similar to the naviagtion TOCs used by this wiki page.
It will be great if we could reuse the XML format that we are pushing for the sections in the new HTML style. See online XML for the sections of the DocTest document.
People info
[[PeopleInfo(Joel de Guzman)]]
This will render:
[[Br]][[Image(People:joel_de_guzman.png,nolink)]] [[Br]]'''Joel de Guzman''' [[Br]][http://www.ohloh.net/projects/3/contributors/92 Ohloh statistics] [[Br]][http://www.linkedin.com/pub/0/89/716 Linked In profile] [[Br]]''joel at somewhere dot com''
This will look like this in the wiki page:
Joel de Guzman
Ohloh statistics
Linked In profile
joel at somewhere dot com
We can see the person in an external XML file in the format:
<booster id="joel_de_guzman" > <name>Joel de Guzman</name> <linkedIn>http://www.linkedin.com/pub/0/89/716</name> <ohloh>http://www.ohloh.net/projects/3/contributors/92</ohloh> <mail>joel at somewhere dot com</mail> <picture>url</picture> <!-- More useful info --> <tracId>jdguzman</tracId> <sourceforgeId>jdg</sourceforgeId> <years>5</years> <maintainerOf> <library>Spirit</library> <library>Fusion</library> </maintainerOf> <authorOf> <library>Spirit</library> <library>Fusion</library> </authorOf> <!-- etc... --> </booster>
Help wanted
If you are interested, please send an email to the boost-docs list telling us you want to help.
Knowledgeable people whom you can contact for help
Dave Abrahams
Ohloh statistics
Linked In profile
dave at boost-consulting dot com
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look and 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