Difference between revisions of "User:Dominique Pautrel/Structure Wiki FR"
m (Ventilation) |
m (Actualisation) |
||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:Structure du Wiki {{OOo}} français}} | {{DISPLAYTITLE:Structure du Wiki {{OOo}} français}} | ||
{{Documentation/FR/Attention| | {{Documentation/FR/Attention| | ||
− | 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. | + | * 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. |
+ | * Un guide de l'éditeur est démarré ici : [[FR/Wiki/Aide:Editeur]] ;-) | ||
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. | 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. |
Revision as of 21:35, 15 May 2009
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. |
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...
Contenu déplacé ici : FR/Wiki/Aide:Nouvelle_page
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.
Voir également cette page française...
Documentation
Section déplacée : FR/Wiki/Structure:Documentation
Des pages pour des liens externes
Nous devrions créer nombre de sous-pages pour référencer - progressivement - l'ensemble de la documentation francophone.
- Par le fait, le cahier des charges est assez conséquent. Mais si cela représente un effort, il reste évidemment bien moindre que la documentation elle même. C'est aussi lui rendre hommage - et surtout visibilité. Un document de qualité mérite bien une page, visible au moins depuis une catégorie.
- À terme, les pages d'accueils des guides, How-Tos pourront être nourries par requêtes. Si la catégorie devient vraiment peuplée, il sera alors agréable de créer des sous-catégories, et ainsi constituer une table des matières qui saura rester claire...
- Pour le coté visuel de cette tâche, nous pourrions créer au moins deux modèles :
- Template:FR/LienExterne présentant, sous forme d'un tableau, les paramètres suivants :
- Titre >> Titre du document
- PlateForme >> Optionnel. Sinon valeur par défaut: "Toutes"
- Descriptif >> Court descriptif d'une à quelques phrases
- Version >> Version concernée de Apache OpenOffice
- Date >> De dernière modification
- Lien >> Lien vers la page (d'accueil)
- Template:FR/DocumentExterne, contenant en plus du premier :
- Lien >> Cette fois le lien de téléchargement direct
- Type >> Type du document (ODT, PDF, etc...)
- Poids >> Poids du fichier, exprimé en Ko, Mo...
- Template:FR/LienExterne présentant, sous forme d'un tableau, les paramètres suivants :
à suivre...
Catégories
Section transférée sur cette page : FR/Wiki/Aide:Categories
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.
Requêtes
Contenu déplacé : FR/Wiki/Aide:Requete
Quelques listes ainsi générées à partir de catégories anglophones existantes :
{{#dpl:category=Documentation|resultsheader=%PAGES% pages dans la catégorie Documentation.|mode=userformat}} | {{#dpl:category=FR|resultsheader=Il y a %PAGES% pages dans la catégorie FR.|mode=userformat}} | |
<DPL> category=Documentation replaceintitle=/Documentation\/Docs\//, </DPL> |
<DPL> category=FR </DPL> | |
How-Tos
Section déplacée : FR/Wiki/Structure:EN_How_Tos
FAQ
Section déplacée : FR/Wiki/Structure:EN_FAQ
L'existant
Les pages sans catégories n'apparaîtront pas ici...
A partir de cette page spéciale je tente de répertorier (manuellement, c'est un peu fastidieux) les catégories appartenant à la branche FR en colonne 1, les catégories EN contenant des pages FR en colonne 2 - c'est l'ordre alphabétique par défaut de ce tableau. La colonne 3 est le nombre de pages FR dans cette catégorie, et un commentaire. J'oublie fatalement quelque chose...
Catégorie FR | Category EN | Pages / commentaire |
---|---|---|
Base_Documentation | 3, ou 4 ? Cette page est en fait un instantané (?) l'original de la FAQ actuelle... | |
Basic:Tutorials | Extensions_development_basic_fr (4 pages (+DE) à créer modèle pour lien interwiki) | |
Calc/Fonctions/FR | 339 pages concernées, et ça continue... je n'ai pas vu de catégorie anglophone pour les fonctions de Calc mais elle devrait sans doute avoir des sous-catégories (financières, mathématiques, etc.) Ainsi la (super) catégorie constitue l'ordre alphabétique, et les sous-catégories la liste des fonctions classées par... catégories ! (en ordre alphabétique à l'intérieur). Chaque fonction devra pour cela inclure deux catégories : Calc/Fonctions/FR (puisqu'elle existe ainsi), mais pour l'autre je proposerais plutôt une nomenclature commençant par FR, soit par exemple FR/Calc/Fonctions/Financieres, et ainsi de suite | |
Collections | Étonnant: MediaWiki:Collections/HsqldbUserGuidefr (que je ne peux modifier !) | |
Database | 2, ou 3 ;-) pages faisant également partie de Base_Documentation | |
FR/Documentation | Documentation | Le wiki est comme "vivant", ces catégories s'étoffent de jour en jour... |
Documentation/FR | Demande de suppression par le modèle {{Delete}} | |
Lien interwiki | Documentation/AdministrationGuide | Le document, en quatre langues, 15 pages par langue... regardez les quatre modèles... |
Lien interwiki | Documentation/BASIC_Guide | Cinq langues de celui-ci... |
Documentation/FR/EnCours | Documentation/BeingEdited | |
Documentation/Candidate | FR/Documentation/Base/Rapports/Fonctions | |
(Traduction à faire) | Documentation/Developer's Guide | Il serait plaisant d'avoir ce guide également en français, évidemment... 21 sous-catégories et quelques centaines de pages... |
Documentation/HelpNeeded | La catégorie anglophone n'est plus utilisée | |
Documentation/FR/EnAttente | Documentation/NeedsRework | Politique d'édition du Wiki |
Education | Deux pages d'accueil francophones. | |
Extensions | Quatre pages. | |
FR | NLC | Racine logique des catégories fancophones. |
Category:FR/Calendrier | 22 modèles pour le calendrier. | |
Fr.openoffice.org | NLC | Fait peut-être double emploi avec FR. |
Français | NLC | Deux pages... |
Guidelines | Politique d'édition du Wiki | |
HSQLDB | Guide (à déplacer) | |
MainIndex | Category:Documentation/FR | |
Marketing | Trois pages. | |
Localisation | NLC | |
PDL License | Je n'ai pas tenté de compter... | |
Project | Deux pages... | |
Category:Quality_Assurance | FAQ MS Access et Base | |
Templates | Templates/website/guide_fr | |
User FAQ | Deux pages. |
Arbre des catégories
Voir aussi l'arborescence des catégories.
Ci-dessous un extrait de ce que l'on pourrait définir en français, et qui pourrait donner par des listes DPL (Dynamic Page List) une visibilité accrue et automatique de la documentation existante.
Une autre solution serait de partager les catégories internationalement: Une page référencée dans les quatre catégories FR, Documentation, Writer et FAQ ne pourrait être qu'une page de la FAQ française de documentation dédiée à Writer. Cependant si cela pouvait faciliter la tâche des localisations, il n'en irait pas de même pour les pages anglophones, de loin les plus nombreuses, qu'il faudrait remanier, sans doute en profondeur... ou déplacer en insérant "EN/" dans toutes les pages concernées... Que de redirections en vue...)
Cette dernière option n'a pas été retenue. Ci dessous la traduction de ce message de Clayton du 4 Mai 2009 :
Template:Documentation/FR/Note
Il est donc préférable d'avoir de multiples catégories plutôt que de les recouper, comme des mots-clés combinables entre eux.
J'ai choisi de marquer "/Documentation" pour toutes ces catégories, car si c'est plus long à éditer c'est plus robuste (sans surprises) pour l'intégration.
Par exemple j'ai noté Category:FR/Documentation/FAQ au lieu de Category:FR/FAQ ou Category:FR/Doc/FAQ pour regrouper tous les documents de la FAQ francophone.
Parent | Catégorie - Descriptif | Enfants |
---|---|---|
Category:MainIndex | Category:FR | Category:FR/Documentation Y a-t-il besoin de Category:FR/Développement, car Category:Development est peut-être plus judicieux... |
Category:FR | Category:FR/Documentation Existe actuellement comme Category:Documentation/FR. Devrait regrouper l'ensemble de la documentation française au moyen de "sous"-catégories... |
Category:FR/Documentation/FAQ Category:FR/Documentation/How_Tos Category:FR/Documentation/Guide |
Category:FR | Category:FR/Writer Parce que le Wiki FR n'héberge pas que de la documentation. Une requête DPL simple permettra l'affichage de toute documentation francophone afférente à Writer :-) |
En option, une autre table des matières serait disponible, mais gourmande en catégories. Créer Category:FR/Section, puis Category:FR/Section/Puces_Numeros, Category:FR/Section/Styles, etc. |
Category:FR/Documentation | Category:FR/Documentation/FAQ Toute la FAQ francophone. |
Appliquer cette catégorie et aussi Category:FR/Writer pour référencer une page appartenant à la FAQ de Writer. |
Cette liste était de seulement quinze entrées, car il était prévu des recoupements entre les catégories... Il n'y en aura pas à ce niveau de tri car la maintenance s'en trouve simplifiée...
Récapitulatif
Liste numérotée: Récapitulatif
|
Template:Documentation/FR/Note
Renommer une catégorie
Déplacé ici : FR/Wiki/Aide:Categories/Renommer
Modèles
Contenu déplacé. Voir FR/Wiki/Aide:Modeles
Assignation automatique de catégories
Dans l'optique ou nous déciderions d'assigner une série de deux ou trois catégories à toutes les pages existantes pour pouvoir ensuite toutes les répertorier lisiblement et automatiquement, nous pourrions simplifier et rendre plus polyvalent encore ce processus d'associations par le biais de modèles.
Utilisons l'acronymie avec les trois lettres F, G, H en début du nom de modèle...
Signifiant respectivement FAQ, Guide et How-to. (A priori surtout utile pour la FAQ, car dans le cas des guides, on peut peut-être se contenter de catégoriser la première page seulement.) Il serait possible, par exemple de créer un modèle Template:FR/FWriter qui appliquerait automatiquement les deux catégories Category:FR/Documentation/FAQ et Category:FR/Documentation/Writer à la page... Par exemple encore, cette page FR/Documentation/Base/SUN_Report_Builder, ainsi que FR/Documentation/Base/Rapports/Fonctions qui lui est reliée, pourraient être étiquetées ("taguées") facilement par la "commande" : {{FR/HBase|Rapport}}. Elles apparaîtraient ainsi dans la section How-Tos pour Base où elles seront classées à la lettre R, et même plus précisément à "Rapport", feront automatiquement partie de la documentation française, etc. |
Architecture comparée
C'est peut-être un peu dur (entendez cruel) de vouloir comparer le site anglophone (principal) et le site français (une branche de l'arbre). Cependant certaines choses sont comparables et cela aide à se faire une idée...
Anglophone | Francophone |
---|---|
http://wiki.services.openoffice.org/wiki Accueil anglophone, et également l'adresse de "base". Aussi appelée "Main_Page". | FR Accueil francophone. Tous les documents en français devraient apparaitre sous cette branche. |
Development | Se reporter à l'adresse ci-contre, ou compléter cette cellule... |
Documentation | FR/Documentation |
Documentation/FAQ | FR/FAQ (tiens, ce n'est pas FR/Documentation/FAQ ? ) |
Documentation/How_Tos | FR/Documentation/How_Tos |
Pour les guides, c'est un peu plus compliqué mais toujours à la racine de Documentation. Par exemple, les guides v3 ou les guides v2... | A la racine de FR/Documentation. Voir dans cette page la section Guides |
Il y a également la page Documentation/Reference qui contient certains manuels existants en FR | Par exemple, FR/Documentation/Expressions_Regulieres_dans_Writer Ou bien FR/Documentation/Calc/Fonctions_listees_par_categories |
Documentation/Tutorials | Nous pourrions créer FR/Documentation/Tutoriels car effectivement il y a des documents téléchargeables, des liens externes, par exemple le site de christianwtd, les tutoriels du forum, ou d'autres perles qui pourraient bien avoir un petit article, ou au moins une ligne dans une liste qui... montre la documentation ! Tout n'est pas si mouvant et cette page devrait être consistante également... |
Other interesting pages for this purpose... | Autres pages intéressantes dans l'esprit de celle ci... |
Documentation/Dashboard | Tableau de bord du projet visible depuis FR/Documentation. :-/ |
Documentation/Dashboard/Wiki_Editing_Policy |
|
Wiki/Guidelines | A peine comparable : FR/FAQ/Wiki (à mettre à jour) |
FR/Documentation/TableauBord/Structure_Wiki_FR conviendrait-elle pour cette présente page ? | |
De même [[FR/Documentation/TableauBord/Editer_Simplement pour cette ébauche, qui aura besoin d'être épurée, réduite à un strict minimum, tout en restant attractif pour qui veut écrire... maintenant. A moins que l'on transfert en déplacant dans l'onglet Discussion le contenu actuel de FR/Wiki. (Tiens, il faudrait déplacer Bibliographie ?) |
Content on this page is licensed under the Public Documentation License (PDL). |