Descriptions of wiki macros should be translated

[Jun Omae]

extract_messages extracts all descriptions of wiki macros and [[MacroList]] macro shows the translated messages.

[Jun Omae]

I worked the issue, ​https://github.com/jun66j5/trac/compare/t10038-i18n-macro-doc.

cleandoc_

New keyword to extract localized strings. This function don't translate like N_, however it returns cleandoc'ed text and the extractor extracts cleandoc'ed text.

IWikiMacroProvider.get_macro_description

It can return a tuple of gettext domain and a description of the macro. The values are used to translate in [[MacroList]].

WikiMacroBase

Adds doc_domain variable to translate with the domain. If speicfied, get_macro_description returns a tuple of self.doc_domain and docstring of the subclass. If not specified, it returns simply docstring of the subclass.

Increase +14 messages.

[Christian Boos]

Nice! Works great. I even think we should push this further: the macro documentation should be placed only in the get_macro_description(), and no longer as the class docstring. That way, we could use the docstrings as developer specific documentation if needed. The user facing documentation would not be that useful in the ApiDoc, and anyway gets badly formatted because of the wiki syntax.

It seems cleandoc_ can be useful in other places if we'd like to get long messages translated, but maybe we should replace existing ones carefully in order to play well with the update.

[Jun Omae]

Ok, updated the branch.

1. WikiMacroBase.get_macro_description() returns (self._domain, self._description), _domain and _description are specified in the subclasses. When _domain and _descriptino are None, it returns the class docstring for pre-0.12 compatibility.
2. The subclasses of WikiMacroBase no longer use the class docstring.

BTW, should we move WikiMacroBase from trac.wiki.macro to trac.wiki.api in 0.13?

[Jun Omae]

Commited in [10617]. We can translate the macro documents.