1.18rc1 docs now available via new web site

[Ian Clatworthy]

Dmitry Vasiliev wrote:
> Ian Clatworthy wrote:
>> As previously, the documentation itself is available in English, Russian
>> and Spanish. I believe some efforts are under way to translate the
>> documentation to Japanese as well. To assist with documentation
>> localisation, please download the main bzr branch (lp:bzr) and add the
>> localised documents under the doc/ directory. To minimise duplication of
>> effort, it's worth posting a message to the mailing list as well in case
>> others are already working on it or would like to help.
> 
> BTW what the best way to translate doc/_templates/* and doc/_static/* to
>   other languages? I guess this structure need to be changed.
> 

Good question. This bit of the structure is imposed by Sphinx so I'm not
sure how easy/possible it is to change it. I suspect we want to replace
the English text in there with variables of some kind and use gettext()
and po files behind the scenes to set those variables.

I'm yet to experiment with variables and substitutions in Sphinx.
Perhaps someone more familiar with it could offer some advice and/or try
something like above and let us know what they find.

Ian C.