Bonjour et bonne année a tous,
voila donc le retour du sujet multilingue puisque Frank Peters sur la
liste documentation-dev repose la question du support multilingue dans
le wiki dont
voila une traduction succincte , le message original en anglais est tout
en bas de ce texte :
Désolé de crossposter, mais cela peu intéresser plusieurs groupes.
Pilotes des projets locaux,
J'ai discuté de la section Documentation sur le wiki OOO a la convention
OOoCon cette année et de ce sujet avec certains en personne ou par mail.
Je voudrais vous décrire le problème encore dans ce mail et proposer des
solutions, je vous demande de donner votre opinion afin de trouver
rapidement une approche multilingue.
Nous recherchons a trouver une solution pour le wiki, d'autre outils
existent mais cela nécessiterait d'utiliser d'autres outils ce qui
impliquerait des soucis de maintenance de configuration et de nouveaux
efforts d'apprentissage.
Cela devra peut être une option a réévaluer après être passé par une
phase d'évaluation, mais pour l'instant je voudrais avoir une approche
pragmatique.
LE PROBLÈME SE POSE AINSI :
Le projet documentation a crée une sous section structurée qui a pour
but de contenir tous les contenus documentaires, pour permettre une
collaboration facile ( il y a des exceptions a cette regle, qui sont en
dehors du sujet de cette discussion)
a) Beaucoup de communauté de langue ont crées des documentations qui ne
sont pas disponibles dans d'autre langue.
b) le projet documentation contient beaucoup de contenus qui ne sont pas
ou seulement partiellement accessible dans d'autre langues que
l'anglais ( ndt)
c) passer d'une langue a une autre sur le wiki n'est pas simple ou facile.
SOLUTION PROPOSÉE :
La solution nécessite d'avoir une structure agrée par tous pour la
documentation qui permettrai de placer les différentes langues cote a cote.
Si toutes les langues suivait la même structure bien définie, il serait
facile de de mettre en place un système de changement de langue sur le
wiki sans avoir a maintenir une table de correspondance entre langues.
Ceci ne s'appliquerait qu'a la documentation le projet local de chaque
langue pourra garder sa structure propre.
MISE EN OEUVRE :
La structure du schéma de la section documentation contiendrai :
wiki/Documentation/$DocTypeOrBook/$SubSections/$SubSubSections
Des exemples Pour $DocTypeOrBook sont :
- FAQ
- HowTos
- OOoAuthorsManuals
- BASIC Guide
Des exemples pour $SubSections sont :
- FAQ/Writer
- Howtos/Calc
- OOoAuthorsManuals/Getting Started Guide
- BASIC Guide/Language
$SubSubSections sert a des sous-sous-sections, (si nécessaire) je pense
que vous saisissez l'esprit.
L'idée est de maintenir une structure parallele pour les projets locaux
ce qui donnerait par exemple :
wiki/Documentation/FAQ Pour les FAQs en anglais , ou
wiki/Documentation/en/FAQ pour la FAQ en anglais
(Cela nécéssiterait de deplacer des pages
dans le wiki)
wiki/Documentation/fr/FAQ Pour la FAQ en francais
wiki/Documentation/de/FAQ Pour la FAQ en allemand
Par conséquent pour une FAQ particuliere , par exemple :
wiki/Documentation/FAQ/Writer/General/HowToFormatACharacter (en anglais)
wiki/Documentation/fr/FAQ/Writer/General/HowToFormatACharacter (en
francais)
wiki/Documentation/de/FAQ/Writer/General/HowToFormatACharacter (en
allemand)
Le code ISO De la langue apres le wiki/documentation dans le chemin
serait l'identifiant, cette approche permettant d'utiliser google pour :
* Chercher de la documentation dans toutes les langues a travers
wiki/documentation
* Chercher de la documentation dans une langue en particulier en
recherchant a partir wiki/documentation/FR par exemple pour le francais
( cela nécéssiterait de deplacer la documentation anglaise dans
wiki/Documentation/en)
Passer d'une langue a une autre serait pris en charge par la barre des
langues qu'il est facile de configurer et la bascule entre langue se
ferait en changer le code ISO dans l'URL.
*Cependant* cela nécéssite que le pages du wiki partage des noms
communs, dans la version actuelle de mediawiki (le moteur du wiki, ndt)
les noms de pages sont aussi les titres des pages qui sont affichées. Je
comprend que cela soit inacceptable pour des pages de wiki
non-anglophones d'afficher des titres en anglais.
Lorsque le moteur du wiki sera mis a jour ( cela sera bientôt chose
faite je l'espère), nous disposeront alors de la fonctionnalité
DISPLAYTITLE qui permettra d'afficher un titre différent.
Cela permettra aux pages de partager un nom commun mais d'avoir un titre
affiché dans la langue locale.
Nous devrions donc aussi nous mettre d'accord sur un schéma de nommage
compatible avec le systeme des URL, l'anglais etant la lingua franca de
l'informatique, je propose d'utiliser des noms anglais pour les pages.
Cela veut dire que meme si vous créer des pages dans la section
francaise, elle devra avoir un nom de page anglais (qui ne touchera que
l'URL).
Nous devrons donc aussi avoir un plan de migration même basique, pour
tenir des documents existants sans trop d'efforts, ce qui veut dire les
déplacer dans la nouvelle structure et sûrement les renommer.
Le résultat final serait une page documentation contenant une barre de
langue précisant la langue affichée et toutes les langues disponibles.
Comme mediawiki affiche les liens vers des pages qui n'existe pas
différemment, les pages devant etre traduite seront facilement visible,
de meme que les pages qui seront disponibles dans plusieurs langues.
En cliquant sur la langue on ira sur la version correspondante de la
page dans cette langue. La localisation ne devant pas avoir de
langue-mere chaque communaute locale pourra choisir de décrire un sujet
de sa propre façon.
Un autre problème sera de savoir si les pages deviennent désynchronisée,
cela nécessiterai d'avoir une langue de référence et je ne pense pas que
nous cherchons cela.
Merci de votre aide et de vos commentaires,
Franck
--
Frank Peters, Documentation Project Co-Lead
The OOo Documentation Project:
SIGN UP - PARTICIPATE - CONTRIBUTE
IT'S FREE! NO OBLIGATIONS!
http://documentation.openoffice.org
http://wiki.services.openoffice.org/wiki/Documentation
--------------------------------------------------------------------
MESSAGE ORIGINAL EN ANGLAIS
--------------------------------------------------------------------
Sorry for crossposting, this may be interesting to multiple groups.
---
Native Lang Leads,
I have been talking about the layout of the Documentation section
in the OOo wiki at OOoCon this year and have been discussing this
matter with some of you in person or via email.
I would like to describe the problem again in this mail and
propose solutions. I would also like to ask you to give your
opinion soon so we can move to a multilingual docs approach soon.
We are focussing on implementing a solution on the wiki.
I know that there are other options but they would include the
usage of other tools and processes and those would require
additional setup, maintenance, and learning effort. These
may be an option later after we had a chance to go through
a thorough evaluation phase. But for now I would like to
approach that pragmatically.
PROBLEM STATEMENT
-----------------
The Documentation project created a structured subsection of
the OOo wiki that is intended to carry all documentation
content to allow easy collaboration (there may be exceptions
to the rule but they are out of scope for this discussion).
a) Many native language communities have created a rich set of
documentation that is not available in other languages.
b) The Documentation project contains much content that is
not or only partly available in other languages.
c) Switching between languages in the wiki is not
straightforward
PROPOSED SOLUTION
-----------------
The solution would include having a fixed agreed-upon structure
for documentation that would allow to place different doc
languages side-by-side.
If all languages follow the same, well-defined structure scheme
it would be easy to implement a language switcher in the wiki
that does the switch programmatically without having to
maintain matching tables.
This only applies to documentation. The mother native-lang
project may still keep its wiki structure as preferred.
IMPLEMENTATION
--------------
The structural scheme of the Documentation wiki content is as follows:
wiki/Documentation/$DocTypeOrBook/$SubSections/$SubSubSections
Examples for $DocTypeOrBook are
- FAQ
- HowTos
- OOoAuthorsManuals
- BASIC Guide
Examples for $SubSections are
- FAQ/Writer
- Howtos/Calc
- OOoAuthorsManuals/Getting Started Guide
- BASIC Guide/Language
$SubSubSections are furthr subdivisions (if required). I think you get
the idea.
The idea is to maintain a parallel structure for "native languages"
alongside the docs, for example:
wiki/Documentation/FAQ for FAQs in en, or
wiki/Documentation/en/FAQ for FAQs in en
(would require move of topics in the wiki)
wiki/Documentation/fr/FAQ for FAQs in fr
wiki/Documentation/de/FAQ for FAQs in de
Likewise, for a particular FAQ, for example:
wiki/Documentation/FAQ/Writer/General/HowToFormatACharacter (in en)
wiki/Documentation/fr/FAQ/Writer/General/HowToFormatACharacter (in fr)
wiki/Documentation/de/FAQ/Writer/General/HowToFormatACharacter (in de)
The langugage ISO code after the wiki/documentation part
of the path would be the identifier. This approach would allow
to use Google to either
* search documentation in all languages by searching
through wiki/Documentation
* search documentation in a particular languae by searching
through, e.g. wiki/Documentation/fr
(this would require to move all English documentation to
wiki/Documentation/en)
Switching languages would be handled by a language bar
that is easy to be set up and switches languages by
changing the language ISO coide in the URL.
*However*, this requires the wiki pages to share a common
page name. In the current mediawiki version, this page
name is also displayed as the page title. I understand that
it is inacceptable for a non-English wiki page to display
an English page title.
With the updated wiki engine (that will hopefully be available
soon), however, we will get the DISPLAYTITLE functionality that
allows a different title to be displayed. This would allow the
pages to share a common page name, but still display a
localized title.
We would also need to agree upon a wiki page title scheme
that makes it easy to handle the URLs. Engslih being the
lingua franca of IT, I propose to use English page names
for the wiki pages. That means, even if you create a French
page inside the French Documentation hierarchy it would need to
have an English page name (that would only affect its URL!).
We also need to have a basic migration strategy in place to
handle existing documents without too much hassle, meaning
moving them to the new hierarchy and possibly renaming them.
The result of all this would be that a Documentation page
contains a language bar marking the currently shown language
and all potentially available languages. Since mediawiki
displays links to non-existing pages differently, it's readily
visible which pages need translation and which languages
are available for a given page.
Clicking that language would bring you to the localized
version of that page. This localization does not have to be
a "mere" translation. Instead, the native-lang community
can decide to describe a given topic in a completely different
way depending on the cultural requirements.
Another issue that must be addressed is how to get notified
if wiki page localizations get out of sync. To be able to
do that, one must define a master language and I don't know if
we actually want to do that.
Thanks for your help and thoughts on this
Frank
--
Frank Peters, Documentation Project Co-Lead
The OOo Documentation Project:
SIGN UP - PARTICIPATE - CONTRIBUTE
IT'S FREE! NO OBLIGATIONS!
http://documentation.openoffice.org
http://wiki.services.openoffice.org/wiki/Documentation
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
