wiki:BoostSpecificWikiMacros

Version 10 (modified by Matias Capeletto, 15 years ago) ( diff )

--

Improving Boost Docs Project

Boost Trac Wiki macros

Introduction

Trac Wiki allows the use of macros to help with common needs like a TOC or the insertion of a n 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 makes common things like referring to a particular section of boost docs very easy. Something like: 

   [[BoostDocSection(regex,introduction)]]

Objectives

  • Write a not too clutter 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 an ​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 look in the wiki page like this:


Joel de Guzman
Joel de Guzman
​Ohloh Statistics
​Linked In Profile
joel at somewhere dot com

We can look the person in an external xml file with 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 a mail to the ​boost-docs list telling us you want to help.

Help wanted

Note: See TracWiki for help on using the wiki.