Structure du Wiki OpenOffice.org français

From Apache OpenOffice Wiki
Jump to: navigation, search
Documentation caution.png
  • 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.


Documentation note.png

J'aimerais un groupe de pages unies dans un seul but. J'en vois aujourd'hui trois, ou quatre, qui, une fois complétées, pourraient être des sous-pages de FR/Documentation/TableauBord :

  1. FR/Documentation/TableauBord/Organisation. Cette page doit-être mise, et maintenue à jour.
  2. FR/Documentation/Dashboard/Wiki_Editing_Policy qui n'est utile que considérée comme la traduction "rigoureuse", mais commentée, de la page anglaise, et donc inexacte si on la transpose au modèle français, qui est lui à mettre à jour à l'adresse #1 de cette note. Elle est je trouve cependant justifiée pour les utilisateurs bilingues qui pourraient sinon ressentir parfois des contre-sens. Pour preuve en lire l'onglet Discussion ou le bas de page et le comparer à la suite du présent document, qui explique le contraire.
  3. Éditer simplement, plutôt destiné au b-a-ba des techniques du code Wiki, munie de liens pour approfondir chaque thème abordé.
  4. Cette présente page... doit soit être créée soit fusionner avec la première.
  • Pour la dynamique du projet :-)

Préambule

Cette page focalise sur les noms des pages dans le Wiki d'OpenOffice.org, 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

Même page que ci-dessus

Catégories

Section transférée sur cette page : FR/Wiki/Aide:Categories

Exemples de catégories

Documentation note.png
  • 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, je demande ici l'avis des experts. "Doc" est peut-être un mot réservé pour la branche "Dev", signifiant notamment le format natif de la suite concurrente - 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... (même si on évoque les noms de page ici alors que nous sommes dans la section Catégories, faire court dans les adresses est objectivement un bon réflexe)
  • 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'OpenOffice.org. 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 :

255 pages dans la catégorie Documentation. Il y a 113 pages dans la catégorie FR.

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...
Category: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 :

Documentation note.png

Exemple : une page française de la FAQ dédiée à Writer :

  1. avec les quatre catégories FR, Documentation, FAQ et Writer
  2. avec une seule catégorie FR/Documentation/FAQ/Writer

Serait-il meilleur de partager les catégories ou chaque langage doit-il posséder les siennes ?

Tu peux utiliser les catégories et noms de catégories que tu souhaites pour les pages traduites (l'exception étant dans certains cas, avec les caractères multibyte (ex. Japonais, chinois) dans les noms de catégories qui ont posé des problèmes par le passé).

Voir:

http://wiki.services.openoffice.org/wiki/FR/Documentation/Dashboard/Wiki_Editing_Policy#Utilisation_des_cat.C3.A9gories

pour un peu plus d'informations sur les catégories.

Les catégories sont employées pour grouper les pages communes du wiki. Il est sensé de regrouper les pages localisées sous leurs propres catégories.

Si les documents sur lesquels tu travailles sont publiés sous licence PDL (comme la majorité de la documentation anglophone) tu peux ajouter le modèle {{PDL1}} à tes pages. Il ajoutera le texte de la licence PDL en bas de page et inclura cette dernière dans la catégorie PDL.

Quelles que soient les catégories que tu décides de définir, il est préférable d'utiliser au moins une catégorie qui soit unique à chaque jeu de documents. Le (robot) Wikibot utilisé pour la maintenance et les changements de masse aux pages wiki peut être paramétré pour agir sur une catégorie spécifique. Si (un jeu de) des documents sont regroupés par au moins une catégorie unique, toute future maintenance sur ces documents devient plus aisée.

Clayton Cornell

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

Tip.png

Liste numérotée: Récapitulatif

  1. Category:FR contient toutes les autres. Sous catégorie de NLC
  2. Category:FR/Documentation (existait comme Category:Documentation/FR). Sous-catégorie de FR et de Documentation
    1. Category:FR/Documentation/Base
    2. Category:FR/Documentation/Calc
    3. Category:FR/Documentation/Draw
    4. Category:FR/Documentation/Generale
    5. Category:FR/Documentation/Impress
    6. Category:FR/Documentation/Math
    7. Category:FR/Documentation/Programmation avec, par exemple des sous-catégories comme suit :
      1. Category:FR/Basic
        1. Category:FR/Basic/Base
        2. Category:FR/Basic/Calc
      2. Category:FR/Java
      3. Category:FR/C++ ou Category:FR/Cpp. Voir les pages de Category:FR/Cpp Guide
      4. Category:FR/Csharp
    8. Category:FR/Documentation/Writer
  3. Category:FR/Documentation/Guide (optionnel : Pourrait regrouper toutes les pages d'accueil des manuels, mais cette liste serait également facile à maintenir manuellement). Sous-catégorie de FR/Documentation.
  4. Category:FR/Documentation/How_Tos. Sous-catégorie de FR/Documentation. Super-catégorie des six suivantes :
    1. Category:FR/Documentation/How_Tos/Base
    2. Category:FR/Documentation/How_Tos/Calc
    3. Category:FR/Documentation/How_Tos/Draw
    4. Category:FR/Documentation/How_Tos/Impress
    5. Category:FR/Documentation/How_Tos/Math
    6. Category:FR/Documentation/How_Tos/Writer
  5. Category:FR/Documentation/FAQ. Sous-catégorie de FR/Documentation. Super-catégorie des huit suivantes :
    1. Category:FR/Documentation/FAQ/Base
    2. Category:FR/Documentation/FAQ/Calc
    3. Category:FR/Documentation/FAQ/Draw
    4. Category:FR/Documentation/FAQ/Generale
    5. Category:FR/Documentation/FAQ/Impress
    6. Category:FR/Documentation/FAQ/Installation
    7. Category:FR/Documentation/FAQ/Math
    8. Category:FR/Documentation/FAQ/Writer
  6. Autres
    1. Category:FR/Aide
    2. Category:FR/TableauBord, dont cette page fait partie. Sous-catégorie de FR/Documentation.
    3. Category:FR/Archives. Improprement utilisée au moment de sa création...
    4. Category:FR/Corbeille pourrait présenter une méthode préalable au modèle Template:Delete.


Documentation note.png (Le premier point est obsolète...)
  • Ces quinze catégories devraient permettre de classer simplement toute la documentation francophone, et incidemment la rendre facilement visible. Pour chaque page de documentation, deux catégories à apposer, une pour le format (Guide, How-To ou FAQ) et une pour le "module" concerné. Ou alors créer des modèles pour automatiser et simplifier encore la procédure).
  • On pourrait également recréer une autre table des matières, plus conventionnelle, par l'utilisation de catégories "Section" comme présenté en exemple dans le tableau ci-dessus. Mais il faudrait créer nombre de sous-catégories (bien pensées) de Category:FR/Section, et apposer à chaque page Wiki une troisième catégorie.
  • L'apposition des catégories suffirait alors à faire apparaitre la page dans la section souhaitée, sans plus avoir à maintenir manuellement les différentes tables des matières. Les pages redirigées laisseraient toutes apparaitre la nouvelle adresse puisque les listes sont dynamiques, et l'on ne verrait plus dans ce cas en haut de page "Redirigée depuis...", et la barre d'adresses du navigateur n'afficherait plus l'ancien chemin (souvent plus long), otant le doute à l'éditeur débutant... :-D

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.

Tip.png 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
  1. FR/Documentation/TableauBord/Organisation. Cette page doit-être mise, et maintenue à jour.
  2. FR/Documentation/Dashboard/Wiki_Editing_Policy qui n'est utile que considérée comme la traduction "rigoureuse", mais commentée, de la page anglaise, et donc inexacte si on la transpose au modèle français, qui est lui à mettre à jour à l'adresse #1 de cette cellule. Elle est je trouve cependant justifiée pour les utilisateurs bilingues qui pourraient sinon ressentir parfois des contre-sens. Pour preuve en lire l'onglet Discussion ou Localisation du contenu et le comparer à ce présent document, qui explique aussi pourquoi le contraire est vrai.
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).
Personal tools