Discussion: Référencement de documentation externe.
Le but est de générer une TdM (table des matières) automatique et ordonnée de la documentation francophone dédiée à OOo, tous sites confondus, avec pour principaux critères la licence libre et la pertinence.
La page Sommaire principale est FR/Externe, mais si elle devient trop longue, sera subdivisée par modules (6 + Générale)
Pour que les pages Sommaire se mettent à jour automatiquement, il faut assigner aux nouvelles pages deux à trois catégories :
- Tag systématique (automatique avec le modèle) de Category:FR/Documentation externe|Date MaJ
- Le paramètre de tri permet l'ordre chronologique.
- Assignation manuelle d'une catégorie FR existante parmi les modules.
- Premier niveau de titre de TdM.
- Assignation manuelle d'une catégorie FR existante parmi les thèmes. Deuxième niveau de TdM. Nécessaire pour :
Les TdM sont donc construites par requêtes listant l'intersection de deux ou trois catégories. L'une d'entre elles est ici invariablement FR/Documentation_externe.
Plusieurs familles de catégories
Au départ du référencement, la logique la plus simple a été de distinguer la documentation par module. Mais les listes risquent d'être longues et pas suffisamment triées, donc moins intéressantes. Ceci peut s'arranger par subdivisions en différentes familles de catégories, sans vraiment de rapports entre elles, mais qui par intersection, permettront plus de détails et des listes plaisantes.
Par modules
- Sept catégories principales en ordre alphabétique
- Base : subdivisé en trois parties :
- Category:FR/Documentation/Base (catégorie principale) Partie propre à OOo (dont HSQLDB)
- Category:FR/Base/Moteur (sous-catégorie)
- Category:FR/Base/Document (sous-catégorie)
- Calc : Category:FR/Documentation/Calc
- Draw : Category:FR/Documentation/Draw
- Général : Category:FR/Documentation/Generale
- Impress : Category:FR/Documentation/Impress
- Math : Category:FR/Documentation/Math
- Writer : Category:FR/Documentation/Writer
- Mais on peut peut-être en avoir d'autres
- Programmation : Category:FR/Documentation/Programmation
Par thèmes
Cette famille est nécessaire pour créer des sous-sections à cette TdM (d'abord classée par modules). Ce tableau devrait être complété au fur et à mesure de l'avancement de cette collection.
Un renvoi dans FR/Theme y est d'ailleurs placé afin que l'on puisse voir le pourquoi des choix existants quand on est tenté de créer une nouvelle catégorie.
Ne créez pas de nouvelle catégorie sans y placer au moins une page !
Mieux, ajoutez là dans ce tableau comme proposition à étudier.
Libellé | Catégorie | Description |
---|---|---|
Automation | Auto-textes, remplacements automatiques, etc. | |
Autres | FR/Theme | Catégorie à ventiler au moment opportun. En même temps parente des autres catégories thématiques. |
Conception | Création de styles, modèles, document maître | |
Etiquettes | Pas forcément nécessaire si l'on groupe avec la catégorie Publipostage et que le libellé devient: Publipostage, étiquettes... | |
Formatage | ||
Impression | ||
Modèles | FR/Modeles | Ne fait pas partie des FR/Theme puisque ce mot fait déjà partie des projets. Cela ne se verrait que dans les DPL (et dans la catégorie mais elle désigne la même chose...) |
Publipostage | FR/Theme/Publipostage | Pourrait (à mon avis mais je ne sais pas vraiment) contenir également les étiquettes. |
Styles | FR/Theme/Styles | |
Tableau |
L'ensemble Modules + Thèmes devrait permettre une vue complète et ordonnée des documents francophones.
Par niveaux
Cette différenciation serait intéressante pour obtenir des TdM plus courtes, mais mieux ciblées.
Libellé | Catégorie |
---|---|
Débutant | Category:FR/Niveau/Debutant |
Confirmé | Category:FR/Niveau/Confirme |
Expert | Category:FR/Niveau/Expert |
Par projets
Noté ici parce qu'une famille de catégories existe déjà en partie. Quelqu'un trouvera peut-être utile de délimiter selon ce critère.
Libellé | Catégorie | Adresse |
---|---|---|
Dictionnaire | Projet Dicollecte | |
Documentation | Category:FR/Documentation | Projet Documentation |
Education | Category:FR/Education | Projet Éducation |
Extensions | Category:FR/Extensions | Extensions (multilingue) |
Modèles | FR/Modeles (ne pas confondre avec FR/Modeles_Wiki) | Centre de modèles |
Validité
Il serait aisé de maintenir une section Archives en apposant aux anciens documents la catégorie supplémentaire Category:FR/Archives. Les pages / documents en cours n'en ayant pas, il est aisé de les différencier par le paramètre notcategory dans les requêtes DPL.
Maintenance
- La page des How-Tos Writer est référencée, incluant les mises en ligne du 7 Novembre 2009.
- La page des How-Tos Draw - Impress - Math est référencée, incluant les mises en ligne du 7 Novembre 2009.