wiki:BoostSpecificWikiMacros

Version 13 (modified by paolog, 15 years ago) ( diff )

proof-reading

Improving Boost Docs Project


Boost Trac Wiki macros

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

  • Write a not-too-cluttered proposal for new Boost-specific WikiMacros, including the rationale behind each decision.

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
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.

Help wanted


Knowledgeable people whom you can contact for help



Dave Abrahams
Ohloh statistics
Linked In profile
dave at boost-consulting dot com


Note: See TracWiki for help on using the wiki.