Difference between revisions of "User:Dominique Pautrel/Structure Wiki FR"
m (→Développement) |
m (→Catégories) |
||
| Line 48: | Line 48: | ||
* [[FR/FAQ]]. A noter que les anglais en on fait une sous-page de Documentation, soit [[Documentation/FAQ]]. (c'est logique, il peut exister d'autres FAQ, mais c'est plus long et probablement inutile dans le cas d'une localisation). | * [[FR/FAQ]]. A noter que les anglais en on fait une sous-page de Documentation, soit [[Documentation/FAQ]]. (c'est logique, il peut exister d'autres FAQ, mais c'est plus long et probablement inutile dans le cas d'une localisation). | ||
=Catégories= | =Catégories= | ||
| + | Les [[Categories|catégories]] peuvent-être considérées comme autant de mots-clefs. Prenons pour exemple une page (française) affublée de la catégorie [[:Category:FR|FR]] : <pre>[[Category:FR]]</pre> S'affiche en bas de page un bandeau avec le lien vers la (page) catégorie FR, et notre présente page apparait dès lors dans cette page particulière qu'est une catégorie, à coté de toutes les autres pages (françaises) pareillement catégorisées. | ||
| − | == | + | {{Documentation/Note| |
| + | C'est d'ailleurs un bon réflexe pour conserver simplement une vue globale, en ordre alphabétique, de toutes les pages françaises. Ce comportement est similaire au résultat d'une recherche depuis un dossier de votre disque dur, excepté le fait que le "dossier" en question est en fait une catégorie Wiki. | ||
| + | |||
| + | Aujourd'hui, beaucoup de pages sont encore non référencées car sinon cette catégorie serait beaucoup plus étoffée... ;-) | ||
| + | }} | ||
| + | Reprenons notre page FR du début et assignons lui une autre catégorie, par exemple [[:Category:Documentation|Documentation]] : <pre>[[Category:Documentation]]</pre> Le bandeau en bas de page contient bien maintenant les deux catégories. | ||
| + | |||
| + | Toutefois, cette catégorie Documentation n'étant pas dédiée qu'aux francophones, notre page sera donc également visible de nos amis anglo-saxons. Selon la teneur et la portée du document, c'est bienvenue ou peu souhaitable. C'est pour cela qu'il existe une catégorie [[:Category:FR/Documentation|FR/Documentation]] | ||
| + | {{Documentation/Note| | ||
| + | # En fait c'est actuellement [[:Category:Documentation/FR|Documentation/FR]], mais je pense vraiment qu'il serait bon d'uniformiser l'entrée des trois caractères "/FR" systématiquement immédiatement à suivre l'adresse #1 : [[Main_Page|http://wiki.services.openoffice.org/wiki]], de façon que toutes les pages françaises de portée francophone uniquement soient des sous-pages de notre accueil [[FR|http://wiki.services.openoffice.org/wiki/FR]]<br> | ||
| + | Enfin au moins le définir clairement pour les pages à venir. :-D | ||
| + | # Vous pouvez aussi n'afficher que les pages répondant aux deux catégories. Voir à ce propos les requêtes. | ||
| + | }} | ||
| + | ==Exemples de catégories== | ||
| + | {{Documentation/Note| | ||
| + | * En fait énormément de liens sont en rouge, car nous devrions en décider ensemble... | ||
| + | * Peut-être aurais-je du écrire '''Propositions de catégories''' | ||
| + | * Personnellement je ne suis pas dérangé (dans ce qui suit) par l'abréviation de "Documentation" en "Doc" - toujours à condition que ce soit univoque - L'avantage est un gain de place, donc de lisibilité, dans la barre d'adresse du navigateur, car les sous-pages et titres de sections rallongent souvent considérablement l'adresse complète couramment utilisée... | ||
| + | }} | ||
| + | ;[[:Category:FR]]: Les pages du Wiki francophone d'{{OOo}}. C'est notre catégorie principale. | ||
| + | ;[[:Category:FR/Documentation]] ou même [[:Category:FR/Doc]], mais pour l'instant [[:Category:Documentation/FR]]: La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories... | ||
| + | ;[[:Category:FR/FAQ]] ou [[:Category:FR/Doc/FAQ]] ou [[:Category:FR/Documentation/FAQ]]: La FAQ francophone. Contenant des sous-catégories, par exemple: | ||
| + | ;[[:Category:FR/FAQ/Writer]] ou [[:Category:FR/Doc/FAQ/Writer]] ou [[:Category:FR/Documentation/FAQ/Writer]]: FAQ francophone de Writer | ||
| + | ;[[:Category:FR/How_Tos]] ou [[:Category:FR/Doc/How_Tos]] ou [[:Category:FR/Documentation/How_Tos]]: La catégorie principale de tous les mini-guides. | ||
| + | ;[[:Category:FR/FAQ/Math]]: FAQ francophone de l'éditeur de formules | ||
| + | |||
| + | ==Requêtes== | ||
Vous pouvez afficher des listes dynamiques de page où des catégories ont été affectées : | Vous pouvez afficher des listes dynamiques de page où des catégories ont été affectées : | ||
| Line 59: | Line 86: | ||
</DPL> | </DPL> | ||
</pre> | </pre> | ||
| − | Pour obtenir la liste des pages contenant les | + | Pour obtenir la liste des pages contenant à la fois les catégories "Documentation" et "FR" : |
<DPL> | <DPL> | ||
category=Documentation | category=Documentation | ||
category=FR | category=FR | ||
</DPL> | </DPL> | ||
| − | |||
| − | Autres essais : (si vous avez des exemples fonctionnels, faites disparaitre ''"%DPL-1.7.4-WARNING: No results!"'' ;-) | + | Autres essais : (si vous avez des exemples fonctionnels, faites disparaitre l'erreur ci dessous ''"%DPL-1.7.4-WARNING: No results!"'' ;-) |
<pre> | <pre> | ||
<DPL> | <DPL> | ||
Revision as of 00:19, 26 April 2009
 |
S'il vous plait ne créez pas de liens durables vers cette page. Elle est destinée à être un brouillon et, suite à un couper/coller, supprimée. Il n'y aura donc pas de redirection suite à cela. En revanche complétez, clarifiez, discutez ici-même, ou même déplaçons la avant tout de suite, ou intégrons la à, si vous lui voyez sa place avec certitude... ;-) L'objet de ce document est d'établir ensemble une structure univoque... S'il doit aboutir... il ne sera plus que le reflet de l'architecture existante. |
Contents
Préambule
Cette page focalise sur les noms des pages dans le Wiki d'Apache OpenOffice, et est incidemment destinée à vous aider à contribuer facilement à la documentation...
Faites attention de bien mémoriser les trois chaînes de caractères ci-dessous (qui sont autant de liens) pour la suite du propos :
- http://wiki.services.openoffice.org/wiki : L'adresse de base, donc dans la langue native du projet, en anglais. La page parente de toutes les autres.
- /FR : La branche française, également appelée plus bas simplement FR.
- /FR/Documentation : La page "racine" de la documentation en français.
Ainsi que le fait que dans ce document, il sera employé régulièrement le conditionnel. Ceci parce que les choix de structure évoluent et que bien des pages existantes ne répondent pas (ou plus ou pas encore) aux critères énoncés ci-dessous... ce n'est pas un problème... mais ce n'est pas toujours simple non plus. Si d'autre part vous voyez des adresses apparaître en rouge comme ceci, c'est ou que le débat n'est pas clos et qu'aucune décision n'a encore été prise, ou que cette page, qui en héberge cependant d'autres, n'existe pas car non jugée nécessaire...
Règles de base pour les nouvelles adresses
(en toute logique)
- Concises: Courtes et descriptives. Le plus précis possible sans redondance.
- En français: Dès lors visible depuis Google ou autres moteurs de recherches.
Différences dues à la localisation
Il y en aura toujours et probablement même pour les traductions "synchronisées" par des liens interwikis, principalement par le fait que les moteurs de recherche sont efficaces sur les noms de pages, et les traductions effectuées ne seraient sinon pas bien visibles depuis Google pour le public visé, par exemple...
Développement
Le Wiki a initialement été conçu par les développeurs pour eux-même. Veuillez vous reporter à l'adresse #1 pour plus de détails.
Documentation
Grossièrement, on pourrait scinder la documentation existante en trois parties :
- Les manuels de référence ou guides, des ouvrages couvrant un domaine et pouvant atteindre plusieurs centaines de pages.
- Les How-tos ou mini-guides couvrant un domaine plus précis, d'un contenu généralement compris entre une et trente pages.
- La FAQ ou les questions fréquemment posées, une question précise, une réponse concise.
Guides
Il n'y en a pas énormément disponibles sur le Wiki en français. Mais en revanche il contiennent nombre de sous-liens et l'adresse de base gagne à être courte, sans redondance :
J'en voix deux aujourd'hui :
- Le guide HSQLDB et le guide pour Writer v3.
How-Tos
Ceux-ci sont déjà plus nombreux :
- FR/How_Tos (au lieu de FR/Documentation/How_Tos)
FAQ
Elles sont souvent impressionnantes :
- FR/FAQ. A noter que les anglais en on fait une sous-page de Documentation, soit Documentation/FAQ. (c'est logique, il peut exister d'autres FAQ, mais c'est plus long et probablement inutile dans le cas d'une localisation).
Catégories
Les catégories peuvent-être considérées comme autant de mots-clefs. Prenons pour exemple une page (française) affublée de la catégorie FR :[[Category:FR]]S'affiche en bas de page un bandeau avec le lien vers la (page) catégorie FR, et notre présente page apparait dès lors dans cette page particulière qu'est une catégorie, à coté de toutes les autres pages (françaises) pareillement catégorisées. Reprenons notre page FR du début et assignons lui une autre catégorie, par exemple Documentation :
[[Category:Documentation]]Le bandeau en bas de page contient bien maintenant les deux catégories.
Toutefois, cette catégorie Documentation n'étant pas dédiée qu'aux francophones, notre page sera donc également visible de nos amis anglo-saxons. Selon la teneur et la portée du document, c'est bienvenue ou peu souhaitable. C'est pour cela qu'il existe une catégorie FR/Documentation Template:Documentation/Note
Exemples de catégories
- Category:FR
- Les pages du Wiki francophone d'Apache OpenOffice. C'est notre catégorie principale.
- Category:FR/Documentation ou même Category:FR/Doc, mais pour l'instant Category:Documentation/FR
- La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories...
- Category:FR/FAQ ou Category:FR/Doc/FAQ ou Category:FR/Documentation/FAQ
- La FAQ francophone. Contenant des sous-catégories, par exemple:
- Category:FR/FAQ/Writer ou Category:FR/Doc/FAQ/Writer ou Category:FR/Documentation/FAQ/Writer
- FAQ francophone de Writer
- Category:FR/How_Tos ou Category:FR/Doc/How_Tos ou Category:FR/Documentation/How_Tos
- La catégorie principale de tous les mini-guides.
- Category:FR/FAQ/Math
- FAQ francophone de l'éditeur de formules
Requêtes
Vous pouvez afficher des listes dynamiques de page où des catégories ont été affectées :
Par exemple, entrez :
<DPL> category=Documentation category=FR </DPL>
Pour obtenir la liste des pages contenant à la fois les catégories "Documentation" et "FR" :
Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.
Autres essais : (si vous avez des exemples fonctionnels, faites disparaitre l'erreur ci dessous "%DPL-1.7.4-WARNING: No results!" ;-)
<DPL> ' Recherches infructueuses : location=FR ; special=parameter ; lang=FR ; category=category </DPL>
Le résultat risque d'être :
Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.
Quelques listes ainsi générées :
