This title is given via a template...
First I would like to apologize to speak and write such a bad english... but as my fathers always told me, the first and most important thing is to be understood ! I simply try this here ;-) Feel free to correct my misspellings and thanks in advance, for that too.
I'm trying to focuses only on the Documentation Project... and particularly on it's structure. With the fact that there is an international project and some documentation in many languages, even if the native-lang one is (naturally) the more represented.
The goal of this short page is to define a valuable category tree for (the French) localization(s).
- After update , I redefine the goal of this page with more headings. Hopefully the page name is still valid. :-)
Contents
About Categories
How should I attribute categories so that all the French documentation (for example) could appears in a nice way through dynamic page lists ?
I see two major and different ways to could use them :
For example, I've just added a new French entry in Documentation FAQ about paragraph styles in Writer. (It's not a translation of another language).
- Keywords
In the case of a "keyword" behavior, I'll add four categories :- [[Category:Documentation]]
- [[Category:FR]]
- [[Category:Writer|Style_Paragraphe]], so that in the Writer category it will be sorted at "Style_Paragraphe" (yes, with the final "e" cause we are in the FR domain)
- [[Category:FAQ|Style_Paragraphe]]
- Meta-Keywords
There's just one category to use :- Category:FR/Documentation/FAQ/Writer, sub-category of Category:FR/Documentation/FAQ and Category:FR/Documentation/Writer
- The old [[:Category:Documentation/FR]] is now candidate for deletion. The only one is Category:FR/Documentation ?)
This concept imply much more categories to be created for each language. And Documentation from different countries could not be retrieved so easily, although each country should have it's own Documentation category, with the Category:Documentation and the Category:NLC as super-category - A compromise
Using both Category:Documentation/FAQ/Writer and Category:FR
But if it look easy for others language, this will all mix in the English Documentation.
Or the same apply in English with the combination of both Category:Documentation/FAQ/Writer and Category:EN
The second option has been retained.
About Templates
Should it be a nice idea to have one or two (or even more) templates for refering to external documentation ?
Something near from those for WikiPedia : http://en.wikipedia.org/wiki/Wikipedia:Template_messages/Sources_of_articles#Examples
We could have Template:Cite_Page for an external page and Template:Cite_File for a downloadable file direct link...
And for each, i.e. the French version, Template:FR/CitePage and Template:FR/CiteFichier
But with specific information concerning Apache OpenOffice documentation. Because (at least in the FR domain) we have more documentation that only on the Wiki, downloadables files or tutorials on the forum
Entering | Could give | ||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{{FR/Cite_Page| |Titre=Débuter à partir d'une application exemple commentée |Description=Questions fréquentes sur la mise en oeuvre de Base. Les exemples présentés ici n'utilisent volontairement aucune macro. |Module=Base |Date=2007-09-10 |Site=Forum-FR |Link=6460 }} |
Questions fréquentes sur la mise en oeuvre de Base. Les exemples présentés ici n'utilisent volontairement aucune macro. Dernière mise à jour : 10 Sept. 2007 Lien : http://user.services.openoffice.org/fr/forum/ftopic6460.html | ||||||||||||||||||||||||||||||||||||||||||||||||
Or it could look like Template:Specification_Header |
| ||||||||||||||||||||||||||||||||||||||||||||||||
My first Template ! Template:FR/CitePage {{FR/CitePage| |Titre=This title is given via a template... |Auteur=Pierre-Yves Samyn |Description=Le Titre véritable est : Débuter à partir d'une application exemple commentée. Questions fréquentes sur la mise en oeuvre de Base. Les exemples présentés ici n'utilisent volontairement aucune macro. |Module=Base |Date=2007-09-10 |Statut=Standard |OS=Toutes |Site=Forum |SiteCode=6460 |Lien=http://user.services.openoffice.org/fr/forum/ftopic6460.html }} |
Résumé
|
This way we could have a normalization for formatting pages that point to external links. The'll all have the same look and could be easily categorized, and thus the reader could see (at least in the FR domain) much more documentation easily...