Difference between revisions of "Template talk:FR/CitePage"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Exemples...)
m (Paramètres)
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Affichage ==
+
== Pourquoi ce modèle ? ==
  
Discussion sur l'aspect graphique de la page générée par ce modèle. Il est pour l'instant d'aspect archaïque, et donc d'autant plus facile à améliorer...  
+
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 [[FR/Wiki/Aide:Requete|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
 +
:::<s>Regrouper</s> En construire une vue d'ensemble.
 +
:;Constat 2&nbsp;
 +
::Trouver ce que l'on cherche rapidement quand on est dans le besoin.
 +
::;Solution 2&nbsp;
 +
:::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.  
  
=== Comment coller des valeurs dans la page&nbsp;?  ===
+
== Fonctionnement ==
  
*Au début j'avais entré <nowiki>== Description ==</nowiki> puis la valeur du paramètre en corps de texte. Mais il y avait un défaut, lorsqu'on cliquait sur ''Modifier'' la section, on éditait le modèle&nbsp;! (logique, en même temps)  
+
=== Modèles ===
*Une autre utilité serait l'assignation de catégorie(s).
+
Pour l'instant les modèles suivants sont inclus dans CitePage :
 +
* [[Template:Color]]
 +
* [[Template:Icon]]
 +
Il est envisageable de créer '''''Licenses''''' pour référencer les principales, '''''Versions''''' pour les [http://fr.wikipedia.org/wiki/OpenOffice.org#Versions_du_logiciel numéros de versions] stables de {{OOo}}. <br>
 +
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...
  
=== Pied de page ou en-tête&nbsp;?  ===
+
=== 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. <br> Plusieurs options possibles&nbsp;:
 +
* 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 <code><nowiki>[[Category:FR/Documentation/{{{Module}}}]]</nowiki></code> 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.
  
Personnellement, je serai plutôt d'avis d'utiliser ce modèle en début de page, pour résumer les principales caractéristiques du document cité.<br> Toutefois, pour ne pas prendre toute la largeur, nous pouvons imaginer que ce modèle s'incruste sur un des côtés (gauche ou droite, on peut choisir).<br> Je me demande s'il serait facile d'ajouter un bouton &lt;cacher&gt;/&lt;masquer&gt; qui pourrait dévoiler des informations supplémentaires jugées moins importantes ([[User:Synanceia (Pierre)/Brouillons/Test1|un essai de tableaux avec un bouton &lt;cacher&gt;/&lt;masquer&gt;]]) ou si nous pouvons inclure un système d'onglets. Pour cela il me faut regarder comment sont construits d'autres modèles élaborés...<br> [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 12:30, 19 May 2009 (UTC)<br>
+
;Proposition retenue
 
+
# Assignation automatique d'une seule catégorie [[:Category:FR/Documentation_externe]] avec le champ ''Date'' comme paramètre de tri. Ainsi cette catégorie :
:;Haut ou bas&nbsp;?
+
## regroupe toutes les pages qui utilisent ce modèle.
::Pour ma part j'avais pensé qu'il n'y aurait pas forcément souvent un corps de page, et que donc ça mettrait ce dernier en valeur...
+
## les affiche dans l'ordre chronologique.
:;Droite ou gauche&nbsp;?
+
## 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.
::Si on voulait mettre un navigateur (à la place du modèle ''Français''), il serait à droite. Donc (amha) pas à droite... sinon je ne sais pas s'il faudrait le mettre à gauche ou (ce que j'aurais fait pour l'instant) le laisser pleine largeur (par défaut).
+
# 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)
::[[User:Dominique Pautrel|Dominique Pautrel]] 13:01, 20 May 2009 (UTC)
+
<br>
 
+
== Choix de méthode  ==
+
 
+
=== Un ou plusieurs modèles&nbsp;?  ===
+
 
+
:Ancien titre&nbsp;: Un seul modèle avec des paramètres optionnels <br>
+
 
+
Je ne pense pas (contrairement à mes premières idées) que nous devions élaborer plusieurs modèles. Un seul modèle peut suffire, il nous suffit de conditionner l'affichage d'une ligne du modèle à l'existence (ou non) du paramètre concerné. De même, si le document cité a pour statut "standard", on pourrait masquer cette ligne pour limiter le nombre d'information (cela me semble important si le modèle est placé en tête&nbsp;!<br>[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 12:30, 19 May 2009 (UTC)
+
 
+
:Je ne sais pas trop. D'un coté un modèle principal et plusieurs sous-modèles doivent être plus faciles à appréhender, déboguer, maintenir...  
+
:De l'autre cela fait des passages de paramètres à gérer.
+
 
+
:J'ai demandé de l'aide ou des retours (en anglais)&nbsp;: http://documentation.openoffice.org/servlets/ReadMsg?listName=dev&amp;msgNo=5459
+
::Et Clayton semble trouver que ça peut être bon, mais n'a pas vu non plus autre chose qu'un lien simple vers une page, visiblement pas encore de modèle existant pour ce type de chose. Sur ma page anglaise, il aime bien le premier tableau avec l'icône, et je suis d'accord ça fait de suite plus sympa.
+
:[[User:Dominique Pautrel|Dominique Pautrel]] 17:38, 20 May 2009 (UTC)
+
 
+
=== Assignation de catégorie(s)&nbsp;?  ===
+
 
+
Si un modèle assigne une catégorie, la changer dans celui-ci la change dans toutes les pages qui utilisent le modèle. <br> Je vois trois options possibles&nbsp;:
+
 
+
#[[#Comment_coller_des_valeurs_dans_la_page_.3F|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.
+
#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.
+
 
+
<br>  
+
  
 
== Paramètres  ==
 
== Paramètres  ==
  
Ce modèle existe également en anglais. Je vais tenter de maintenir les deux versions à jour <br> Ce qui suit n'est pour l'instant que le comportement souhaité... chaque paramètre peut avoir sa sous-section si nécessaire. <br> N'ayez surtout pas peur de discuter ou d'ajouter quelque chose. J'ai forcément oublié un paramètre.  
+
[[User:Dominique Pautrel|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 !
  
Les paramètres correctements définis (à ce niveau du développement du modèle) sont <span style="background-color: rgb(0, 255, 0);">surlignés en vert</span>.  
+
* 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 <span style="background-color: rgb(0, 255, 0);">surlignés en vert</span>.
 +
* Les paramètres en attente d'une réponse sont <span style="background-color: rgb(255, 255, 0);">en jaune</span>.
 +
* Les paramètres non retenus <span style="background-color: rgb(222, 222, 222);">en gris</span>.
  
 
{| cellpadding="5" border="1"
 
{| cellpadding="5" border="1"
Line 59: Line 57:
 
| Adresse  
 
| Adresse  
 
| Chaîne de caractères  
 
| Chaîne de caractères  
| N'oubliez pas <nowiki>http://...</nowiki> à 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
+
|
 +
* N'oubliez pas <nowiki>http://...</nowiki> à 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 :
 +
*#Le lien en lui-même.
 +
*#Le libellé du lien (terme exact: Le lien redirigé), et éventuellement :
 +
*#Le type du fichier (ODT, PDF, OXT, etc.)
 +
*#Son poids (52 Ko, 12,34 Mo...)
 
|-
 
|-
 
| Auteur  
 
| Auteur  
Line 67: Line 71:
 
| Date  
 
| Date  
 
| AAAA-MM-JJ  
 
| AAAA-MM-JJ  
| Date de dernière mise à jour du document.
+
| Date de dernière mise à jour du document. En dix caractères avec les deux tirets.
 
|-
 
|-
 
| Description  
 
| Description  
 
| Chaîne de caractères  
 
| 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 [http://meta.wikimedia.org/wiki/Aide:Mots_magiques#__NOEDITSECTION ce mot magique] (NOEDITSECTION) mais... ça ne me parait pas élégant.
+
|
 +
* 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 [http://meta.wikimedia.org/wiki/Aide:Mots_magiques <!-->#__NOEDITSECTION <-->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  
+
| <span style="background-color: rgb(222, 222, 222);">Doc </span>
 
|  
 
|  
 
#Oui  
 
#Oui  
Line 79: Line 85:
  
 
|  
 
|  
#Pour distinguer si le paramètre ''Adresse'' est une page Web ou un lien de téléchargement direct.  
+
*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)
+
*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.
  
 
|-
 
|-
Line 87: Line 93:
 
#Oui  
 
#Oui  
 
#Non
 
#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"&nbsp;;-) sur le DISPLAYTITLE de la page.
 
| 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"&nbsp;;-) sur le DISPLAYTITLE de la page.
 +
 +
|-
 +
| <span style="background-color: rgb(255, 255, 0);">Licence</span>
 +
|Chaîne de caractères
 +
|<small>[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:14, 26 May 2009 (UTC) : Pour [[User:Synanceia_(Pierre)/Brouillons/Test1#CitePage|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]</small>
 +
:<small> [[User:Dominique Pautrel|Dominique Pautrel]] 13:49, 28 May 2009 (UTC) Oui. J'ai suffisamment avancé maintenant (il reste encore à traduire) pour pouvoir [[Template_talk:CitePage#Licenses|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... </small>
 +
::<small>[[User:Synanceia (Pierre)|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.</small>
 +
:::<small>[[User:Dominique Pautrel|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.
 
|-
 
|-
 
| <span style="background-color: rgb(0, 255, 0);">Module</span>  
 
| <span style="background-color: rgb(0, 255, 0);">Module</span>  
Line 95: Line 108:
 
#Calc  
 
#Calc  
 
#Draw  
 
#Draw  
#Général
+
#General
 
#Impress  
 
#Impress  
#Installation
 
 
#Math  
 
#Math  
 
#Writer
 
#Writer
  
| Il faudrait (exemple avec Base) que l'icône correspondante s'affiche. [[Image:Base.png|50px]] ou carrément [[Image:Base.png]] <br>  
+
|<center>
Ce paramètre peut-ê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...  
+
{| border="1" widht=100%
 +
|+ 13:49, 28 May 2009 (UTC) Vive l'Inclusion ! <br>Deux modèles [[Template:Icon|Icon]] et [[Template:Color|Color]] assignent dynamiquement icône et couleur. ;-)
 +
|- align: "center" bgcolor="#FFFFDD"
 +
| Base || Calc || Draw || General || Impress || Math || Writer
 +
|-
 +
| bgcolor={{Color| Base}} | {{Icon| Base |5|60}}
 +
| bgcolor={{Color| Calc}} | {{Icon| Calc |5|60}}
 +
| bgcolor={{Color| Draw}} | {{Icon| Draw |5|60}}
 +
| bgcolor={{Color| General}} | {{Icon| General |5|60}}
 +
| bgcolor={{Color| Impress}} | {{Icon| Impress |5|60}}
 +
| bgcolor={{Color| Math}} | {{Icon| Math |5|60}}
 +
| bgcolor={{Color| Writer}} | {{Icon| Writer |5|60}}
 +
|-
 +
|} Outre le nom, ''Icon'' possède 2 paramètres ''Position'' (à améliorer) et ''Taille''. <br>Ils sont également facilement réutilisables dans d'autres contextes... </center>
 +
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...  
 +
<br/>
 +
:<small>[[User:Dominique Pautrel|Dominique Pautrel]] 13:49, 28 May 2009 (UTC) : Il est toutefois possible de mettre plusieurs "versions" d'un même mot... </small>
 +
::<small>[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 10:23, 30 May 2009 (UTC) : Je viens de supprimer {{Citation|Autres}} et {{Citation|Galerie}} la catégorie {{Citation|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 {{Citation|gadget}}, il ne faut pas s'embarrasser de cela !</small>
  
 
|-
 
|-
| Plate-forme  
+
| 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 <br><small>Légende: Plate-forme </small>
 
|  
 
|  
 
#Linux  
 
#Linux  
Line 136: Line 169:
 
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''...  
 
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
 +
|<small>[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:14, 26 May 2009 (UTC) : idem ''Licence''
 +
: [[User:Dominique Pautrel|Dominique Pautrel]] 13:49, 28 May 2009 (UTC) Est-ce la version du document/programme ou la version utilisée de OOo ?<br>
 +
: Je n'avais donc pas envisagé le cas d'un programme, seulement celui d'un document. <br>
 +
: Dans ce qui suit dans tous les cas cette entité s'appelle le '''''lien'''''.
 +
: Il faudrait sans doute trois champs, pour être précis
 +
:# '''''VersionDoc''''' : Est le n° de version du lien cité dans le modèle.
 +
:# '''''VerOOoDébut''''' : Est le n° de version de OOo à partir duquel ce lien fonctionne. (ex.: 2.0)
 +
:# '''''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... [[Template_talk:CitePage#Versions|Qu'en pensez-vous ?]]
 +
::[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 14:59, 30 May 2009 (UTC) : Initialement ma proposition était relative à la version du document proposé.
 +
::: [[User:Dominique Pautrel|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''. [[User:Dominique Pautrel|Dominique Pautrel]] 08:23, 2 June 2009 (UTC) : </small>
 
|}
 
|}
  
Line 141: Line 194:
 
Extraits de http://fr.openoffice.org/Documentation/How-to/indexht-writer.html
 
Extraits de http://fr.openoffice.org/Documentation/How-to/indexht-writer.html
 
* Section ''Styles et modèles de documents''
 
* Section ''Styles et modèles de documents''
{{FR/CitePage|
+
# [[FR/Externe/Writer/Numerotation_et_tables_des_matieres]]
|Légende=Non
+
# [[FR/Externe/Writer/Navigateur:_Gestion_des_documents]]
|Module=Writer
+
# [[FR/Externe/Writer/Conception:_Feuille_de_styles]]
|Statut=Standard
+
# [[FR/Externe/Writer/Mise_en_page_paysage_avec_en-tete_et_pied_de_page_en_mode_portrait]]
|Date=2006-10-11
+
# [[FR/Externe/Writer/Principes_du_traitement_de_texte]]
|Titre=La numérotation des chapitres <br> et la réalisation automatique des tables des matières.
+
# [[FR/Externe/Writer/Controler_la_qualite_d'un_document]]
|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=Jean-François Nifenecker
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/NumChapitres.odt ODT, 377 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/NumChapitres.pdf PDF, 508 Ko]
+
}}
+
 
+
{{FR/CitePage|
+
|Légende=Non
+
|Module=Writer
+
|Statut=Standard
+
|Date=2007-03-14
+
|Titre=Le Navigateur <br> 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=Jean-François Nifenecker
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/Navigateur.odt ODT, 540 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/Navigateur.pdf PDF, 564 Ko]
+
}}
+
 
+
{{FR/CitePage|
+
|Légende=Non
+
|Module=Writer
+
|Statut=Standard
+
|Date=2008-08-08
+
|Titre=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=Jean-Yves Royer
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/ConceptionStyles.odt ODT, 335 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/ConceptionStyles.pdf PDF, 461 Ko]
+
}}
+
 
+
{{FR/CitePage|
+
|Légende=Non
+
|Module=Writer
+
|Statut=Standard
+
|Date=2007-10-13
+
|Titre=Mise en page paysage <br> 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.
+
{{Quote|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=Pierre Poisson, Laurent Balland-Poirier
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/Mise_en_page_paysage.odt ODT, 533 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/Mise_en_page_paysage.pdf PDF, 461 Ko]
+
}}
+
 
+
{{FR/CitePage|
+
|Légende=Non
+
|Module=Writer
+
|Statut=Standard
+
|Date=2008-07-02
+
|Titre=Principes du traitement de texte <br> 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=Jean-Yves Royer, sur une idée et avec la participation de Jean-François Nifenecker
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/PrincipesTdt.odt ODT, 155 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/PrincipesTdt.pdf PDF, 330 Ko]
+
}}
+
 
+
{{FR/CitePage|
+
|Légende=Non
+
|Module=Writer
+
|Statut=Standard
+
|Date=2007-10-12
+
|Titre=Contrôler la qualité d'un document de traitement de texte <br> Ou {{OOo}} 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=Jean-Yves Royer
+
|OS=Toutes
+
|Lien=[http://fr.openoffice.org/Documentation/How-to/writer/ControleDocument.odt ODT, 97 Ko] <br>
+
[http://fr.openoffice.org/Documentation/How-to/writer/ControleDocument.pdf PDF, 123 Ko]
+
}}
+

Latest revision as of 10:20, 3 June 2009

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