Template talk:FR/CitePage

From Apache OpenOffice Wiki
Jump to: navigation, search

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.

Fonctionnement

Modèles

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

Il est envisageable de créer Licenses pour référencer les principales, Versions pour les numéros de versions stables de Apache OpenOffice.
On pourrait imaginer un modèle référençant les WebSites les plus connus, y associant le lien direct sous l'image / l'icône du site (flottant à gauche, en regard de l'icône du module, avec Titre au milieu). Ce qui ajouterait une information visuelle dont nous sommes friands, et égayerait un peu plus la monotonie de l'aspect de ces pages créées à partir du modèle...

Catégories

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... Pour cela il faudrait que le modèle puisse ajouter/écrire la valeur réelle de [[Category:FR/Documentation/{{{Module}}}]] dans la page... Aucune idée de comment faire pour ma part...
  • Construire un "moteur" éprouvé pour les générer finement. Mais 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 retenue
  1. Assignation automatique d'une seule catégorie Category:FR/Documentation_externe avec le champ Date comme paramètre de tri. Ainsi cette catégorie :
    1. regroupe toutes les pages qui utilisent ce modèle.
    2. les affiche 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.
  2. 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...).
  • Le champ est libre et l'utilisateur du modèle devra renseigner :
    1. Le lien en lui-même.
    2. Le libellé du lien (terme exact: Le lien redirigé), et éventuellement :
    3. Le type du fichier (ODT, PDF, OXT, etc.)
    4. Son poids (52 Ko, 12,34 Mo...)
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. En dix caractères avec les deux tirets.
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.
  • Dans ce cas construire la page normalement et insérer le modèle en haut, en bas ou même dans le milieu de la page selon la présentation voulue. Et dans ce champ Description, entrer par exemple un sous-titre ou un très court résumé.
Doc
  1. Oui
  2. Non
  • Pour distinguer si le paramètre Adresse est une page Web ou un lien de téléchargement direct.
  • Option non retenue. Le champ Adresse est libre et l'utilisateur responsable de le compléter correctement. Ce qui est cependant relativement naturel (libellé du lien, cible du lien, éventuellement taille et type du fichier) et ne devrait pas être problématique.
Légende
  1. Oui
  2. 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.
Dominique Pautrel 08:23, 2 June 2009 (UTC) : Je m'imagine en tant qu'utilisateur. Je vais donc chercher un libellé (lien redirigé selon Wikipedia) et un lien, a pouvoir coller dans ce champ. Ne risquais-je pas de me tromper de temps en temps, et de plus sans m'en rendre compte ? Je pense encore à un modèle, qui aurait non pas toutes les possibilités (c'est effectivement trop exigeant) mais permettrait toujours en plus une entrée libre, pour le nouveau cas. S'il s'avère que cette entrée est redondante et revient régulièrement, l'intégrer au modèle simplifie le processus et élimine les risques d'erreurs pour cette entrée. Tant que l'acronyme est reconnu, un lien s'affiche, et l'utilisateur est sur de son coup.
Module
  1. Base
  2. Calc
  3. Draw
  4. General
  5. Impress
  6. Math
  7. 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
Base.png


Calc.png


Draw.png


Edit.png


Impress.png


Math.png


Writer.png


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 !
Mots-clés Item, Itération, Libellé, Mot, Occurrence, Terme Peut-être serait-il simple et efficace d'avoir un tel champ, libre, et séparer les mots par une virgule. L'avantage obtenu serait de disposer de synonymes qui rendraient plus large les recherches des moteurs (Google ou autres)
OS
Légende: Plate-forme
  1. Linux
  2. Mac
  3. Toutes (défaut)
  4. Windows
  5. etc. ?
Le fin du fin serait que si ce paramètre n'est pas renseigné, au lieu d'une erreur il affiche "Toutes"
Statut
  1. Préliminaire
  2. Standard
  3. Obsolète

Autres

  1. Tant qu'il n'est pas finalisé.
  2. Stable.
  3. 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
  1. VersionDoc : Est le n° de version du lien cité dans le modèle.
  2. VerOOoDébut : Est le n° de version de OOo à partir duquel ce lien fonctionne. (ex.: 2.0)
  3. VerOOoFin : Est le n° de version de OOo à partir duquel ce lien possède le Statut=Obsolète ex.: (Ne fonctionne plus depuis la) 2.4
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é.
Dominique Pautrel 08:23, 2 June 2009 (UTC) : Oui, je crois avoir bien compris ta première proposition comme ça. C'est le paramètre Version, que je viens de renommer en VersionDoc dans cette cellule. (je répond après chaque phrase pour consolider au point par point :-)
Ceci nous permettrait de nous rendre compte si un article du wiki est à jour par rapport à la dernière version proposé du document.
Si je comprend bien, ceci s'applique au cas ou le document concerné est une référence en soi. Ne pourrions nous pas (arrête moi si je mélange) avoir, un peu comme Wikipedia a ses "Articles de qualité", une catégorie pour nos pages ou "Documents de qualité", en expliquant que ce document a été classé ainsi par les experts (ce n'est donc pas moi qui assignerait cette catégorie, comme il se dit parfois : "Fou, mais pas dingue !" ;-). Qu'il faudrait donc mobiliser. Ou alors faire un vote, mais nous n'avons pas de moyen aussi simple pour cela sur le Wiki. (que le forum, par exemple). Ou alors comme d'habitude, le lecteur estimera la popularité de l'article à son nombre de visites. Ou bien tu réussi un modèle qui va bien, mais moi je ne vois pas comment réaliser un vote avec cases à cocher qui sache enregistrer le nombre de votes (et reconnaît l'utilisateur qui ne peut donc voter qu'une fois, même si il peut déplacer son vote). Basiquement, je dirais pas possible tel quel...
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).
Oui, je n'avais pas assez précisé, mais ça va devenir compliqué à utiliser avec tous ces paramètres, même si l'on gagne en précision. Je rajouterais donc un 4ème :
4. VerOOoTest : Est le dernier n° de version de OOo ayant été testé avec succès par rapport à ce document.
Donc si tout est complété (le document est obsolète), VersionFin est normalement la version suivante de VersionTest. Dominique Pautrel 08:23, 2 June 2009 (UTC) :

Exemples

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

  • Section Styles et modèles de documents
  1. FR/Externe/Writer/Numerotation_et_tables_des_matieres
  2. FR/Externe/Writer/Navigateur:_Gestion_des_documents
  3. FR/Externe/Writer/Conception:_Feuille_de_styles
  4. FR/Externe/Writer/Mise_en_page_paysage_avec_en-tete_et_pied_de_page_en_mode_portrait
  5. FR/Externe/Writer/Principes_du_traitement_de_texte
  6. FR/Externe/Writer/Controler_la_qualite_d'un_document
Personal tools