(Cross-posted to the Documentation mailing list)
One the things we've added (some time ago) to the OOoWiki is a feature
to link pages that have been translated so that you can see all
languages that Wiki page is available in.
The Wiki syntax is:
[[iso_lang_code:Wiki_article]]
For example,
[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]
adds a link to the Chinese translation of the first page of the
Developer's Guide. This link shows in the left column, under the
heading "In other languages".
Advantage:
- this provides an easy to use and consistent link style to link the
Wiki pages that are translated.
Disadvantage:
- as a page is translated into more languages, the maintenance becomes
a problem because you must open and edit each translated page to add a
link for a new localization.
Solution:
- use a Template.
I've created a template we can use for the Developer's Guide.
The Wiki Syntax is:
{{Documentation/DevGuideLanguages|Page_Name}}
where Page_Name is the current Wiki page name.
For example:
{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org
Developers Guide}}
Will add the localized page links for the first page in the Developer's
Guide.
Currently those localized links are: Bulgarian, English and Chinese.
If one of the NL teams begins translating the Developer's Guide into a
new language, they will have to:
1. Add the new language to the template:
http://wiki.services.openoffice.org/wiki/Template:Documentation/DevGuideLanguages
For example to add Dutch to this template, you would edit the Template
and add: [[nl:NL/{{{1}}}]]
2. Make sure the template is referenced correctly in each of the
translated pages. Once the Template is added to the English master
document (my action), you should only need to be sure that the template
is still referenced in your translated page.. no additional action
should be necessary.
Advantage:
- maintenance is reduced to a minimum, and new localizations of this
manual automatically show up on all translations.
Disadvantage:
- after adding the new language to the Template, pages that have not
yet been translated will show as red links in the "In other languages" box.
Action:
I will pass the WikiBot over the known localized pages (Chinese and
English) to remove the existing InterWiki links, and replace them with
the Template link.
The Bulgarian translation of this document has just started. Other than
the first page of the Developer's Guide, have any other pages been
prepared or translated?
Are there any other localization efforts underway for the Developer's Guide?
If you have any questions on this, please speak up.
C.
--
Clayton Cornell ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org
