wiki:DocsTranslationsProject

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

--

http://matias.capeletto.googlepages.com/ibdp.png


Docs Translations

Table of contents

  1. Introduction
  2. Translation Guide
  3. Organization in the repository
  4. Volunteers looking for something to do
  5. Volunteers sweating
  6. HTML to Quickbook translations
  7. Boostbook to Quickbook translations

Introduction

The translated docs will be located in: SVN: snadbox/boost_docs/trunk/libs/lib_name/doc

Once they are stable, the lib author will be invited to see the results and commit them to the correct location CVS: boost/libs/lib_name/doc

Translation Guide

To translate html docs we should wait for the result of Glyn Matthews's Html to docbook project.

Once we have docbook docs, if the authors wants to have a Quickbook version of it (really recommended), we can use the "Quickbook source" stylesheet. It works very well in Opera ( Menu: "View" ---> "Style" ---> "Quickbook source" ).

Organization in the repository

SVN: snadbox/boost_docs/trunk/libs/lib_name

Docbook source - Required

  • doc/lib_name.xml
    Doc source in docbook format. Optionally it can include boostbook extensions.
    Example:
    
    
  • doc/lib_name.xsl
    Example:

    Library dependents output configuration parameters (i.e. chunker depth).
  • doc/Jamfile.v2
    "doc/bjam --v2" will generate the html docs.
    Example:
    
    

Quickbook Source - Optional

  • doc/lib_name.qbk
    Main quickbook file.
    Example:
    [library Quickbook
        [quickbook 1.4]
        [copyright 2007 Joel de Guzman and Eric Niebler]
        [purpose Test Formatting Document]
        [license
            Distributed under the Boost Software License, Version 1.0.
            (See accompanying file LICENSE_1_0.txt or copy at
            [http://www.boost.org/LICENSE_1_0.txt])
        ]
        [authors [de Guzman, Joel], [Niebler, Eric] ]
        [category math]
    ]
    
    [/ Templates ]
    
    [/ Images ]
    
    [template Diagram [$../images/diagram.png]]
    
    [/ External Links ]
    
    [template SgiAssignable [@http://www.sgi.com/tech/stl/Assignable.html Assignable]]
    
    [/ Sections ]
    
    [section Small Section]
    
    A few lines.
    
    [endsect]
    
    [/ Moderate section abstract ]
    [include moderate_size_section.qbk]
    
    [/ Larger section abstract ]
    [include larger_size_section.qbk]
    
    [section Other Small Section]
    
    Some more lines.
    
    [endsect]
    
    
  • doc/*.qbk
    Moderate size main sections quickbook files
  • doc/larger_section.qbk
  • doc/larger_section/*.qbk
    Large size main sections (i.e reference) may be splitted again, organizing them in a directory tree to avoid clutering the doc directory.

Images - Optional

  • doc/images/*.png
    You can use other formats, but be a good web citizen and use portable networks graphics.
  • doc/images/*.svg
    If you intend to have a decent rendering in the pdf docs, use svg.

Examples - Optional

  • example/doc/*.cpp
    Quickbook allows us to import code chuncks, instead of harcoding them in the qbk source. This allow as to be sure that every code example will be in sync and with out typos.
    Example:

    Use it qbk source:
    Example:
    
    
  • example/doc/Jamfile.v2
    Testsuite for the doc examples.
    Example:
    
    

Navigation aid - Will be automated in the future

  • doc/html/sections.xml
    Nested links xml definition of the library sections. This file is used to generate the navigation select boxes and tree sidebar (expected it soon'').
    Example:

Volunteers looking for something to do

Add yourself here!

Volunteers sweating

  • Stjepan Rajko (translating smart_ptr)
  • Glyn Matthews (translating bind and mem_fun)
  • Darren Garvey (lists.drrngrvy@… : translating tribool and range)
  • Andrew Sutton (translating and improving graph docs)
  • Matias Capeletto (translating boostbook to quickbook)

HTML to Quickbook translations

Finished work

  • optional (Matias Capeletto)
  • numeric_conversion (Matias Capeletto)
  • config (Matias Capeletto)

Ongoing

  • smart_ptr (assigned to Stjepan Rajko)
  • bind (assigned to Glyn Matthews)
  • mem_fun (assigned to Glyn Matthews)
  • graph (assigned to Andrew Sutton)

Pending

  • wave (translator wanted)
  • serialization (translators wanted... it may be too big for one person)
  • spirit (translators wanted)

Authozarization from author needed

  • compatibility
  • crc
  • dynamic_bitset
  • integer
  • pool
  • random
  • rational
  • timer
  • tokenizer

Boostbook to Quickbook translations

  • tribool (assigned to Darren Garvey)
  • range (assigned to Darren Garvey)

This translations are low priority for now.

  • string_algo (translator wanted)
  • function (translator wanted)
  • signals (translator wanted)
  • assign (translator wanted)
  • ptr_container (translator wanted)

Note: See TracWiki for help on using the wiki.