Difference between revisions of "User:Dominique Pautrel/Wiki Localization Structure"
(My first Template) |
m (→About Templates) |
||
Line 52: | Line 52: | ||
We could have [[Template:Cite_Page]] for an external page and [[Template:Cite_File]] for a downloadable file direct link... | 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/ | + | And for each, i.e. the French version, [[Template:FR/CitePage]] and [[Template:FR/CiteFichier]] |
But with specific information concerning {{OOo}} documentation. Because (at least in the FR domain) we have more documentation that only on the Wiki, downloadables files or tutorials on the forum | But with specific information concerning {{OOo}} documentation. Because (at least in the FR domain) we have more documentation that only on the Wiki, downloadables files or tutorials on the forum | ||
Line 88: | Line 88: | ||
|Or it could look like [[Template:Specification_Header]] || {{Specification_Header| Pierre-Yves Samyn| 2007-09-10| Standard}} | |Or it could look like [[Template:Specification_Header]] || {{Specification_Header| Pierre-Yves Samyn| 2007-09-10| Standard}} | ||
|- | |- | ||
− | |My first Template ! [[Template:FR/CitePage]] | + | |My first Template ! [[Template:FR/CitePage]] <br> |
− | |{{FR/CitePage|Titre=Débuter à partir d'une application exemple commentée. | + | <pre>{{FR/CitePage| |
+ | |Titre=Débuter à partir d'une application exemple commentée. | ||
+ | |Auteur=Pierre-Yves Samyn | ||
+ | |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 | ||
+ | |Statut=Standard | ||
+ | |OS=Toutes | ||
+ | |Site=Forum | ||
+ | |SiteCode=6460 | ||
+ | |Lien=http://user.services.openoffice.org/fr/forum/ftopic6460.html | ||
+ | }} </pre> | ||
+ | |{{FR/CitePage| | ||
+ | |Titre=Débuter à partir d'une application exemple commentée. | ||
|Auteur=Pierre-Yves Samyn | |Auteur=Pierre-Yves Samyn | ||
|Description=Questions fréquentes sur la mise en oeuvre de Base. | |Description=Questions fréquentes sur la mise en oeuvre de Base. | ||
Line 103: | Line 117: | ||
|- | |- | ||
|} | |} | ||
+ | |||
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... | 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... |
Revision as of 22:25, 18 May 2009
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. :-)
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=Débuter à partir d'une application exemple commentée. |Auteur=Pierre-Yves Samyn |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 |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...