Template talk:FR/CitePage

Pourquoi ce modèle ?

L'option permettant au modèle d'être intégré plusieurs fois n'est qu'une option, qui n'est pas définie par défaut. Ceci pour les raisons suivantes :

• Les titres des documents sont suffisament précis et les documents eux-mêmes suffisament détaillés pour nécessiter une page propre par document, et ceci même si la page wiki peut paraître courte et toujours pareillement présentée, de par le fait de l'utilisation d'un modèle.
• Une page par page/document externe est selon moi la seule méthode efficace à terme de mise en visibilité de la documentation, puisqu'on pourra faire appel ensuite aux requêtes DPL.
• L'option Légende=Non de ce modèle permettant de l'afficher en liste ne devrait exister que pour les tutoriels abordant véritablement le même sujet (ex: Les styles de paragraphe dans Writer, La mise en forme conditionnelle dans Calc, Imprimer un livret, etc.) pouvant seuls être considérés comme "doublons", (mais comme ils sont exprimés différemment, ça peut toujours permettre de mieux comprendre - quand on se place comme lecteur)
• But général : Rendre visible en un lieu (le Wiki me semble la meilleure place par définition) toute la documentation francophone pertinente et Open-Source, tous horizons confondus, en détaillant ces pages "marque-pages" pour pouvoir construire au fur et à mesure une "table des matières" (par listes de pages dynamiques DPL)

Constat 1

Il y a beaucoup de matière, mais disséminée...

Solution 1

Regrouper En construire une vue d'ensemble.

Constat 2 

Trouver ce que l'on cherche rapidement quand on est dans le besoin.

Solution 2 

Utilisons les catégories pour chacune de ces pages utilisant un modèle. Aujourd'hui les sous-catégories FR sont encores très basiques (moins que le mois dernier et maintenant presque toutes conformes à la nouvelle organisation, je crois) mais on pourrait notamment faire d'autres familles (Entrées de menus, Thèmes) pour les croiser (toujours DPL) et monter ainsi progressivement un système ou moyennant le respect de 2 ou 3 règles simples (une fois bien définies) ces TdM sont à jour et bien vivantes.

Choix de méthode

Comment coller des valeurs dans la page ?

L'utilité serait l'assignation de catégorie(s).

Un ou plusieurs modèles ?

Pour l'instant les modèles suivants sont inclus dans CitePage :

• Template:Color
• Template:Icon

Assignation de catégorie(s) ?

Si un modèle assigne une catégorie, la changer dans celui-ci la change dans toutes les pages qui utilisent le modèle.
Plusieurs options possibles :

• Figer la catégorie en bas de page, comme si elle avait été entrée à la main...
• Construire un "moteur" éprouvé pour les générer finement. Il y aurait beaucoup de contraintes...
• Procéder par mots-clés. Non retenu...

L'exemple portait sur une page de FAQ FR pour Writer. Il aurait fallu assigner les quatre catégories FR, Documentation, FAQ, et Writer. Et user de requêtes pour retrouver les pages en intersectant plusieurs catégories, géantes si extraites seules. Ce n'est pas conçu (et c'est peut-être mieux) ainsi.

Proposition plus réaliste

• Assigner une seule catégorie Category:FR/Documents_externes avec le champ Date comme paramètre de tri. Ainsi cette catégorie :
  1. Regrouperait toutes les pages qui utilisent ce modèle.
  2. Les afficherait dans l'ordre chronologique.
  3. Devrait être désactivée si Légende=Non. Et donc dans ce cas rajoutée à la main sur la page de liste, surtout sans paramètre de tri sur la date... éventuellement sans paramètre de tri du tout, ces "compilations" seraient donc seules à F, après 2 ! (soit 2005, 2006, etc.)
• Laisser à l'utilisateur le soin d'apposer (au moins) une catégorie et un paramètre de tri en bas de page (souvent sous le modèle). Ce qui laissera de la souplesse et de l'indépendance entre le modèles et toutes les catégories (futures y compris)

Paramètres

Dominique Pautrel 13:49, 28 May 2009 (UTC) Le but du jeu est d'obtenir un modèle simple d'utilisation et malgré tout suffisamment performant pour couvrir correctement la tâche. Nous sommes ici dans l'onglet Discussion, et donc ajoutez une idée directement, dans le tableau ou en dessous. Ne craignez pas que la page devienne brouillon, l'important est d'obtenir un modèle robuste et (je me répète mais tant pis) simple, surtout pour... que l'on s'en serve !

• Ce modèle existe également en anglais. Je vais tenter de maintenir les deux versions à jour.
• Ce qui suit n'est quelquefois que le comportement souhaité... chaque paramètre peut avoir sa sous-section si nécessaire.
• Les paramètres actuellement correctement définis sont surlignés en vert.
• Les paramètres en attente d'une réponse sont en jaune.
• Les paramètres non retenus en gris.

Paramètre	Valeurs	Commentaires
Adresse	Chaîne de caractères	N'oubliez pas http://... à faire apparaître dans l'aide. (On peut rêver avec une infobulle...). Soit on ne s'embête pas avec la méthode la plus simple... aucune restriction et l'utilisateur du modèle renseigne ici le type de document et son poids
Auteur	Chaîne de caractères	Liste des auteurs (Conseiller de séparer par une virgule et une espace)
Date	AAAA-MM-JJ	Date de dernière mise à jour du document.
Description	Chaîne de caractères	Normalement la plus grande chaîne entrée par l'utilisateur. À noter que l'on peut la construire comme une page, avec titres et tout. Mais dans ce cas les liens Modifier apparaissent dans la cellule du tableau et modifient le modèle... bon il y a bien ce mot magique (NOEDITSECTION) mais... ça ne me parait pas élégant.
Doc	Oui Non	Pour distinguer si le paramètre Adresse est une page Web ou un lien de téléchargement direct. Obligatoire. (enfin, c'est ce que j'aimerais... à priori)
Légende	Oui Non	Réglé sur Oui, inclus le titre dans DISPLAYTITLE, donc un seul modèle par page, pour un How-To, Guide ou autre Tutoriel. Non permet d'en inclure plusieurs instances et de marquer "Entrée principale" ;-) sur le DISPLAYTITLE de la page.
Licence	Chaîne de caractères	Synanceia (Pierre) 07:14, 26 May 2009 (UTC) : Pour présenter Milifred3, j'ai vraiment senti le besoin de faire apparaitre cet aspect. Il serait bon de prévoir que ce paramètre pourrait ne soit être affiché s'il n'est pas renseigné. [Note : je n'ai aucune idée de la difficulté de gérer cela dans un tableau] Dominique Pautrel 13:49, 28 May 2009 (UTC) Oui. J'ai suffisamment avancé maintenant (il reste encore à traduire) pour pouvoir demander cela à Clayton car il y aurait là un autre modèle dont je vois bien le fonctionnement/comportement mais ne maîtrise pas le contenu... (A priori nous compléterions au fur et à mesure des besoins) car si j'avais pensé à PDL ou CCBY il y a évidemment aussi GPL comme tu le montre ici, entre autres... à suivre... Synanceia (Pierre) 10:25, 30 May 2009 (UTC) : Nous ne pourrons pas tout prévoir, pour se simplifier la vie, je proposerai plutôt un champ libre avec l'intitulé de la licence et un lien vers une description de celle-ci.
Module	Base Calc Draw General Impress Math Writer	13:49, 28 May 2009 (UTC) Vive l'Inclusion ! Deux modèles Icon et Color assignent dynamiquement icône et couleur. ;-) Base Calc Draw General Impress Math Writer Outre le nom, Icon possède 2 paramètres Position (à améliorer) et Taille. Ils sont également facilement réutilisables dans d'autres contextes... Ce paramètre pourrait être également utilisé pour définir la catégorie à assigner, mais il ne suffit pas seul à distinguer une astuce de type FAQ à une procédure complète type How-To... Dominique Pautrel 13:49, 28 May 2009 (UTC) : Il est toutefois possible de mettre plusieurs "versions" d'un même mot... Synanceia (Pierre) 10:23, 30 May 2009 (UTC) : Je viens de supprimer « Autres » et « Galerie » la catégorie « General » devrait pouvoir couvrir ces 2 cas là ! On peut toujours 'se'/'me' faire plaisir en mettant une version Fr et une version En pour chaque proposition. Mais c'est inutile, c'est « gadget », il ne faut pas s'embarrasser de cela !
OS Légende: Plate-forme	Linux Mac Toutes (défaut) Windows etc. ?	Le fin du fin serait que si ce paramètre n'est pas renseigné, au lieu d'une erreur il affiche "Toutes"
Statut	Préliminaire Standard Obsolète Autres	Tant qu'il n'est pas finalisé. Stable. Plus à jour où uniquement utilisable avec d'anciennes versions. Dans ce cas, préciser. Donc autoriser les commentaires et se servir de ces trois termes comme balise d'en-tête de la chaîne.
Titre	Chaîne de caractères	Pour l'instant il apparaît deux fois, pour la page et pour le tableau... c'est également pour cette raison que j'avais imaginé l'option Pied de page... Le fait de ne pas inclure DISPLAYTITLE apporterait l'avantage qu'on pourrait mettre plusieurs fois le modèle sur une page (pour des documents de type FAQ). C'est la raison du paramètre Légende...
Version	Chaîne de caractères	Synanceia (Pierre) 07:14, 26 May 2009 (UTC) : idem Licence Dominique Pautrel 13:49, 28 May 2009 (UTC) Est-ce la version du document/programme ou la version utilisée de OOo ? Je n'avais donc pas envisagé le cas d'un programme, seulement celui d'un document. Dans ce qui suit dans tous les cas cette entité s'appelle le lien. Il faudrait sans doute trois champs, pour être précis Version : Est le n° de version du lien cité dans le modèle. VersionDebut : Est le n° de version de OOo à partir duquel ce lien fonctionne. (ex.: 2.0) VersionFin : Est le n° de version de OOo à partir duquel ce lien possède le Statut=Obsolète (ex.: 2.3.1) Personnellement je n'aime pas les noms des paramètres que j'ai écris là, ne sont pas assez parlants... Qu'en pensez-vous ? Synanceia (Pierre) 14:59, 30 May 2009 (UTC) : Initialement ma proposition était relative à la version du document proposé. Ceci nous permettrait de nous rendre compte si un article du wiki est à jour par rapport à la dernière version proposé du document. Mais il faut aussi prévoir une information Compatibility. En effet, les informations indiquées peuvent être de plusieurs natures, je pense à une autre information : dernière version (de Ooo) testée/approuvée (le doc. peut être valable pour une version postérieure mais celle-ci n'a pas été testée).

Exemples

Extraits de http://fr.openoffice.org/Documentation/How-to/indexht-writer.html

• Section Styles et modèles de documents

La numérotation des chapitres et la réalisation automatique des tables des matières.

La numérotation des chapitres et la réalisation automatique des tables des matières.
Description	Qui dit document long, dit bien souvent rapport, compte-rendu, mémoire, etc. Ce type de document est toujours articulé autour d’un plan qui comporte des chapitres, souvent numérotés, un sommaire, des annexes, lesquelles peuvent également être dotées de leur propre sommaire et, éventuellement, un ou plusieurs index...
Auteur(s)	Jean-François Nifenecker					Date	2006-10-11
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 377 Ko PDF, 508 Ko

Le Navigateur. Déplacements rapides et gestion des documents

Le Navigateur. Déplacements rapides et gestion des documents
Description	La suite bureautique OpenOffice.org propose à ses utilisateurs de très nombreux outils de gestion des documents : la gestion des styles et celle des modèles en sont deux exemples. Il est cependant un outil fort méconnu, et à tort, car il offre des possibilités variées et étendues. Nous voulons parler du Navigateur. L’utilisateur fréquent de la suite OpenOffice.org ne saurait s’en passer sans se priver d’une aide toujours précieuse, d’autant plus que le Navigateur est présent dans tous les modules de la suite...
Auteur(s)	Jean-François Nifenecker					Date	2007-03-14
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 540 Ko PDF, 564 Ko

Conception d'une feuille de styles.

Conception d'une feuille de styles.
Description	La réalisation d’un modèle avec feuille de styles est bien décrite dans le document : StylesModeles – OpenOffice.org Writer et dans d’autres documents du site fr.openoffice.org. Cependant, est-il suffisant de connaître toutes les fonctions du logiciel pour que les modèles créés soient efficaces et ergonomiques ? Il faut en plus quelques repères qui guident la conception...
Auteur(s)	Jean-Yves Royer					Date	2008-08-08
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 335 Ko PDF, 461 Ko

Mise en page paysage avec en-tête et pied de page en mode portrait

Mise en page paysage avec en-tête et pied de page en mode portrait
Description	L'objectif de ce document est de donner une solution à une question posée le 28 mai 2007 sur la liste des utilisateurs francophones d'OOo. Dans la doc de Writer, j'ai trouvé comment changer l'orientation d'une page d'un document. Très bien. Mais comment faire pour que cette page garde l'entête et le pied de page dans le même sens que les autres pages ?
Auteur(s)	Pierre Poisson, Laurent Balland-Poirier					Date	2007-10-13
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 533 Ko PDF, 461 Ko

Principes du traitement de texte. Seulement ce qu'un rédacteur doit connaître

Principes du traitement de texte. Seulement ce qu'un rédacteur doit connaître
Description	Pour qui aborde le traitement de texte, le nombre et l’étendue des possibilités ont de quoi donner le vertige. De plus, les traitements de texte modernes, pour des questions de compétition, sont dotés de multiples fonctions et prétendent permettre de réaliser tous les types de documents. Ce n’est pas faux, mais pour un travail professionnel il ne faut sortir de leur domaine privilégié que dans des cas exceptionnels.
Auteur(s)	Jean-Yves Royer, sur une idée et avec la participation de Jean-François Nifenecker					Date	2008-07-02
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 155 Ko PDF, 330 Ko

Contrôler la qualité d'un document de traitement de texte ou Apache OpenOffice Writer en trois minutes.

Contrôler la qualité d'un document de traitement de texte ou Apache OpenOffice Writer en trois minutes.
Description	S’il est long de découvrir toutes les subtilités d’un logiciel de traitement de texte, il est rapide d’en apprendre les caractéristiques essentielles et de juger la qualité d’un fichier qui garantit : des modifications aisées par tout contributeur ; les échanges entre logiciels et versions. Cette note récapitule des points à respecter pour rédiger « vite et bien ».
Auteur(s)	Jean-Yves Royer					Date	2007-10-12
Plate-forme	Toutes	Module	Writer	Version	{{{VersionDoc}}}	Statut (Aide)	Standard
Licence	{{{Licence}}}			Valide depuis la {{{VerOOoDébut}}}. Testé avec la {{{VerOOoTest}}}. Obsolescence: {{{VerOOoFin}}}
Adresse	ODT, 97 Ko PDF, 123 Ko