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 :

1. Tag systématique (automatique avec le modèle) de Category:FR/Documentation externe|Date MaJ
   • Le paramètre de tri permet l'ordre chronologique.
2. Assignation manuelle d'une catégorie FR existante parmi les modules.
   • Premier niveau de titre de TdM.
3. Assignation manuelle d'une catégorie FR existante parmi les thèmes. Deuxième niveau de TdM. Nécessaire pour :
   • Writer
   • (Pour les autres cas vous pouvez quand même l'assigner, ce qui sera une retouche de moins quand les requêtes des autres modules seront mises à jour)

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 

1. Base : subdivisé en trois parties :
   1. Category:FR/Documentation/Base (catégorie principale) Partie propre à OOo (dont HSQLDB)
   2. Category:FR/Base/Moteur (sous-catégorie)
   3. Category:FR/Base/Document (sous-catégorie)
2. Calc : Category:FR/Documentation/Calc
3. Draw : Category:FR/Documentation/Draw
4. Général : Category:FR/Documentation/Generale
5. Impress : Category:FR/Documentation/Impress
6. Math : Category:FR/Documentation/Math
7. Writer : Category:FR/Documentation/Writer

Mais on peut peut-être en avoir d'autres 

1. 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). Elle risque également d'être complétée au fur et à mesure de l'avancement de cette collection.

Libellé	Catégorie	Description
Automation		Auto-textes, remplacements automatiques, etc.
Autres	Category: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
Formatage
Impression
Modèles
Publipostage
Styles	Category:FR/Theme/Styles
Tableau

L'ensemble des 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 (à renommer avant en 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

Pour l'instant, les onze How-Tos Writer section Styles et modèles sont référencés.