wiki:DocsTranslationsProject

Version 14 (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 ]

[def SgiAssignable [@http://www.sgi.com/tech/stl/Assignable.html Assignable]]

[/ Sections ]

[section Small Section]

A few lines.

[endsect]

[include moderate_size_section.qbk]
[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.