Difference between revisions of "User:Dominique Pautrel/Structure Wiki FR"
m (→Exemples de catégories) |
m (→Exemples de catégories) |
||
Line 87: | Line 87: | ||
* Dans la liste ci dessous il nous faut opter pour l'un des trois cas de figures. Il sera dès lors le même partout et cette liste nettoyée des deux autres options devenues inutiles. | * Dans la liste ci dessous il nous faut opter pour l'un des trois cas de figures. Il sera dès lors le même partout et cette liste nettoyée des deux autres options devenues inutiles. | ||
}} | }} | ||
+ | ;[[:Category:MainIndex]]: La catégorie regroupant toutes les autres. Dans l'esprit francophone, nous pourrions aussi créer [[:Category:FR/Categories]] et assigner cette dernière uniquement, à MainIndex. Ou bien l'assigner comme toutes les autres à la catégorie suivante : | ||
;[[:Category:FR]]: Les pages du Wiki francophone d'{{OOo}}. C'est notre catégorie principale. | ;[[:Category:FR]]: Les pages du Wiki francophone d'{{OOo}}. C'est notre catégorie principale. | ||
;Pour l'instant [[:Category:Documentation/FR]], mais [[:Category:FR/Documentation]] ou même [[:Category:FR/Doc]] conviendrait mieux : La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories, ci dessous proposées : | ;Pour l'instant [[:Category:Documentation/FR]], mais [[:Category:FR/Documentation]] ou même [[:Category:FR/Doc]] conviendrait mieux : La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories, ci dessous proposées : |
Revision as of 12:47, 27 April 2009
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 :
Quelques guides en français :
- Le guide d'administration
- Le guide de programmation Basic
- Le guide pour Writer v3
- Le guide HSQLDB devrait être déplacé ici : FR/Documentation/HSQLDB_Guide, pour l'homogénéité.
- Les fonctions listées par catégories pour Calc.
- Ajoutez un oubli...
A noter que les deux premiers cités ont été réalisés en accord avec les liens inter-wikis automatiques. L'unique différence réside dans les adresses des pages, chez nous augmentées des trois caractères "/FR" directement après l'adresse de base. Ceci permet de "synchroniser" les langues, un modèle simple assurant la liaison automatique entre chaque page.
Mais ceci enlèverait la recherche en français dans les moteurs de recherche. Je m'exprime au conditionnel car je n'ai pas trouvé d'exemple probant de ce défaut, partant du principe que les mots-clés de ma recherche sont ceux présents dans le titre affiché par la commande DISPLAYTITLE. Mais j'ai également observé que, si la réponse arrive bien en première ligne dans Google, elle s'effectue sur les mots dans la page, et non la commande DISPLAYTITLE. Ce dernier constat implique au rédacteur de reprendre les mots traduits dans le corps de la page, en plus de la commande DISPLAYTITLE, pour qu'une recherche en français soit efficiente.
Par exemple, quelques recherches efficaces dans le guide d'administration via Google :
Si vous trouvez une recherche inefficace malgré que les termes recherchés soient inclus dans la commande DISPLAYTITLE, merci de l'ajouter ici-même afin de discuter ce constat :
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:MainIndex
- La catégorie regroupant toutes les autres. Dans l'esprit francophone, nous pourrions aussi créer Category:FR/Categories et assigner cette dernière uniquement, à MainIndex. Ou bien l'assigner comme toutes les autres à la catégorie suivante :
- Category:FR
- Les pages du Wiki francophone d'Apache OpenOffice. C'est notre catégorie principale.
- Pour l'instant Category:Documentation/FR, mais Category:FR/Documentation ou même Category:FR/Doc conviendrait mieux
- La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories, ci dessous proposées :
- 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. Exemple pour Draw :
- Category:FR/How_Tos/Draw ou Category:FR/Doc/How_Tos/Draw ou Category:FR/Documentation/How_Tos/Draw
- Deux excellents exemples en français, et il est toujours possible de créer ou d'utiliser une page pointant sur les autres documents accessibles par téléchargement.
Autres catégories possibles :
- Category:FR/Doc/Calc ou Category:FR/Documentation/Calc
- Pour regrouper toute la documentation francophone sur Calc. Qu'elle soit de type Guide, How-To ou FAQ.
- Category:FR/Modele
- Pour référencer tous les modèles spécifiquement francophones...
Catégories existantes :
- Category:Documentation/BASIC_Guide
- Ne sera pas renommée pour préserver les liens interwikis.
- Category:Documentation/AdministrationGuide
- Ne sera pas renommée pour préserver les liens interwikis.
Renommer une catégorie
Il n'est pas possible de renommer une catégorie puisqu'il n'y a pas d'onglet correspondant sur la page. Mais il est cependant très facile d'arriver au même résultat :
- Créer la nouvelle catégorie [N] et relever le nombre de pages contenues dans l'ancienne catégorie [A].
- A partir de [A], visiter et éditer toutes les pages qui la peuple, en remplaçant [A] par [N].
- Vérifier que [N] contient bien le même nombre de pages que [A] au début de l'opération quand [A] est vide.
- Inscrire dans [A] la catégorie [N] maintenant utilisée, pour éviter le doute aux futurs éditeurs
Un exemple d'une telle catégorie [A] pour un cas de figure similaire avec l'ancienne catégorie : Category:Localisation ou [N] est Localization.
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.
Quelques listes ainsi générées :
How-Tos
FAQ
Modèles
Ci dessous la liste existante reprise et actualisée de la page FR/Documentation/TableauBord/Organisation...
Modèles existants (Templates)
Nom du modèle | Syntaxe | Résultat | ||
---|---|---|---|---|
Template:OOo | {{OOo}} Même effet que le modèle ci-dessous |
Apache OpenOffice | ||
Template:Documentation/PRODUCTNAME | {{Documentation/PRODUCTNAME}} Même effet que le modèle ci-dessus |
Template:Documentation/PRODUCTNAME | ||
Template:Documentation/Abstract | {{Documentation/Abstract|Votre note}} | |||
Template:Documentation/Banner | {{Documentation/Banner|Texte de la bannière}} ? ? ? |
Template:Documentation/Banner | ||
Template:Documentation/FR/PremierJet | {{Documentation/FR/PremierJet|Verifiez le texte et l'orthographe}} Vous ne pouvez pas ajouter de commentaires... |
Cette page est un premier jet !
| ||
Template:Documentation/FR/AideDemandee | {{Documentation/FR/AideDemandee|Verifiez le texte et l'orthographe}} Vous ne pouvez pas ajouter de commentaires... |
Template:Documentation/FR/AideDemandee | ||
Template:Documentation/FR/EnCours | {{Documentation/FR/EnCours|Jean Dupond}} Ce document est réservé, pour rédaction, relecture, etc. Vous pouvez éventuellement ajouter un commentaire. (ici le nom de l'éditeur) |
| ||
Template:Documentation/FR/EnAttente | {{Documentation/FR/EnAttente|Pas sur de la section macro}} Demandez une relecture... Vous ne pouvez pas ajouter de commentaires dans ce cadre... |
|||
Template:Documentation/FR/PertinenceVerifiee | {{Documentation/FR/PertinenceVerifiee|Jean Dupond}} Retour du relecteur. Entrez votre nom d'utilisateur pour créer un lien direct vers votre page... |
| ||
Template:Documentation/FR/PlusValable | {{Documentation/FR/PlusValable|0.5}} Cet article n'est plus à jour ou ne correspond plus au comportement de la version actuelle. |
| ||
Template:Documentation/FR/Attention | {{Documentation/FR/Attention|Faites très attention à ce qui est écrit ici.}} Série 1 |
| ||
Template:Documentation/FR/Note | {{Documentation/FR/Note|Information notable}} Série 1 |
Template:Documentation/FR/Note | ||
Template:Documentation/FR/Astuce | {{Documentation/FR/Astuce|Essayez cette astuce.}} Série 1 |
| ||
Template:Attention | {{Attention|Faites très attention à ce qui est écrit ici.}} Série 2 |
! Faites très attention à ce qui est écrit ici. | ||
Template:Information | {{Information|Information notable}} Série 2 |
i Information notable | ||
Template:Tip | {{Tip|Essayez cette astuce.}} Série 2 |
|||
Template:Documentation/hbar | {{Documentation/hbar|200}} | Template:Documentation/hbar | ||
Template:Documentation/Hook | {{Documentation/Hook}} | |||
Template:Documentation/Imported | {{Documentation/Imported|Jean Dupont|Pierre Durand}} ? ? ? |
Template:Documentation/Imported | ||
Template:Documentation/LastEdited | ||||
Template:Documentation/Linux | {{Documentation/Linux|Informations spécifiques aux systèmes UNIX}} | Template:Documentation/Linux | ||
Template:Documentation/Windows | {{Documentation/Windows|Informations spécifiques aux systèmes Microsoft Windows}} |
Template:Documentation/Windows | ||
Template:Documentation/MasterTOC | {{Documentation/MasterTOC}} | {{{booktitle}}}
{{{toccontent}}}
| ||
Template:FR/Documentation/MasterTOC | {{FR/Documentation/MasterTOC}} |
| ||
Template:Documentation/OOo | {{Documentation/OOo}}Lien vers... | Template:Documentation/OOoLien vers le document (indiquez la taille du fichier) | ||
Template:Documentation/PDF | {{Documentation/PDF}}Lien vers... | Template:Documentation/PDFLien vers le fichier (indiquez sa taille) |