Difference between revisions of "User:Dominique Pautrel/Wiki Localization Structure"
m |
m (→Citation of a page/file of an external site) |
||
(9 intermediate revisions by the same user not shown) | |||
Line 6: | Line 6: | ||
The goal of this short page is to define a valuable category tree for (the French) localization(s). | The goal of this short page is to define a valuable category tree for (the French) localization(s). | ||
− | ==About [[Categories]]== | + | : After update , I redefine the goal of this page with more headings. Hopefully the page name is still valid. :-) |
+ | |||
+ | __TOC__ | ||
+ | |||
+ | == About [[:Category:MainIndex|Categories]] == | ||
How should I attribute categories so that all the French documentation (for example) could appears in a nice way through dynamic page lists ? | How should I attribute categories so that all the French documentation (for example) could appears in a nice way through dynamic page lists ? | ||
Line 25: | Line 29: | ||
<li>'''Meta-Keywords'''<br> | <li>'''Meta-Keywords'''<br> | ||
There's just one category to use : | 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 <nowiki>[[:Category:Documentation/FR]]</nowiki> is now candidate for deletion. The only one is [[:Category:FR/Documentation]] ?) | |
− | + | ||
− | + | ||
− | + | ||
It would be just like the [[:Category:Documentation/FAQ/Writer]], and by this way there's nothing to change with English language. <br> | It would be just like the [[:Category:Documentation/FAQ/Writer]], and by this way there's nothing to change with English language. <br> | ||
Line 43: | Line 44: | ||
</li> | </li> | ||
</ol> | </ol> | ||
+ | The second option has been retained. | ||
+ | |||
+ | == About [[:Category:Wiki Templates|Templates]] == | ||
+ | |||
+ | === Citation of a page/file of an external site === | ||
+ | |||
+ | 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:CitePage]] for an external page and [[Template:CiteFile]] for a downloadable file direct link... or one template with more sophisticated parameters... | ||
+ | |||
+ | And in the same way, i.e. the French version, [[Template:FR/CitePage]] and [[Template:FR/CiteFichier]] | ||
+ | |||
+ | {| | ||
+ | |+ A French Example with http://user.services.openoffice.org/fr/forum/viewtopic.php?f=29&t=6460 | ||
+ | |- | ||
+ | ! Entering | ||
+ | ! Could give | ||
+ | |- | ||
+ | | <pre>{{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 | ||
+ | }}</pre> | ||
+ | | <div style="float: right; margin-top: -45px;">[[Image:Base.png|70px]]</div> '''<center>Débuter à partir d'une application exemple commentée</center>''' <br> <small>Questions fréquentes sur la mise en oeuvre de Base. Les exemples présentés ici n'utilisent volontairement aucune macro.</small> <br> Dernière mise à jour : 10 Sept. 2007 <br> Lien : http://user.services.openoffice.org/fr/forum/ftopic6460.html | ||
+ | |- | ||
+ | | Or it could look like [[Template:Specification Header]] | ||
+ | | {{Specification_Header| Pierre-Yves Samyn| 2007-09-10| Standard}} | ||
+ | |- | ||
+ | | My first Template ! [[Template:FR/CitePage]] <br> <pre>{{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 | ||
+ | }} </pre> | ||
+ | | See [[FR/Externe/Base/Documents/Debuter:_Application_exemple_commentee]] | ||
+ | |} | ||
+ | |||
+ | <br> 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... | ||
+ | |||
+ | === Icon === | ||
+ | |||
+ | For icon display, I intend to build : [[Template:Icon]]. If it fail it will only be candidate for speedy deletion :-) | ||
+ | |||
+ | For this purpose one's need to use the [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions extension from MediaWiki]. | ||
+ | |||
+ | <br> | ||
+ | |||
+ | {| border="1" style="width: 800px; height: 120px;" | ||
+ | |+ If a was a working template... | ||
+ | |- | ||
+ | ! 2nd Parameter: Position. Mapping: | ||
+ | ! Call | ||
+ | ! Result of the template : | ||
+ | |- | ||
+ | | <center> | ||
+ | {| style="width: 360px; height: 90px;" | ||
+ | |- | ||
+ | | Nine values from 1 to 9 | ||
+ | ::From Top Left | ||
+ | :::To bottom Right | ||
+ | |||
+ | | | ||
+ | {| | ||
+ | |- | ||
+ | | 1 | ||
+ | | 2 | ||
+ | | 3 | ||
+ | |- | ||
+ | | 4 | ||
+ | | 5 | ||
+ | | 6 | ||
+ | |- | ||
+ | | 7 | ||
+ | | 8 | ||
+ | | 9 | ||
+ | |} | ||
+ | |||
+ | |} | ||
+ | </center> | ||
+ | | <center>'''Code :'''<br><nowiki>{{Icon|Calc|3|40}}</nowiki></center> | ||
+ | | <div style="float: right; margin-top: 2px;">[[Image:Calc.png|40px]]</div> | ||
+ | The result is now a 40 pixels floating Calc icon, at the top right of the cell... | ||
+ | |||
+ | |} |
Latest revision as of 11:20, 31 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. :-)
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
Citation of a page/file of an external site
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:CitePage for an external page and Template:CiteFile for a downloadable file direct link... or one template with more sophisticated parameters...
And in the same way, i.e. the French version, Template:FR/CitePage and Template:FR/CiteFichier
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 }} |
See FR/Externe/Base/Documents/Debuter:_Application_exemple_commentee |
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...
Icon
For icon display, I intend to build : Template:Icon. If it fail it will only be candidate for speedy deletion :-)
For this purpose one's need to use the ParserFunctions extension from MediaWiki.
2nd Parameter: Position. Mapping: | Call | Result of the template : | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
{{Icon|Calc|3|40}} |
The result is now a 40 pixels floating Calc icon, at the top right of the cell... |