Difference between revisions of "Template talk:CitePage"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Added French content. To be translated.)
 
(About licenses)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[fr:Template_talk:FR/CitePage]]
 +
 +
This page is only a translation today and I may write like a child. If you find non sense I've just hidden the french text :-) [[User:Dominique Pautrel|Dominique Pautrel]] 23:25, 21 May 2009 (UTC)
 +
 
== Display ==
 
== Display ==
About graphical display
+
About graphical display. It is really basic today, thus easy to enhance...
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...
+
=== How to paste values in a page ? ===
 +
* I started with entering this parameter in a heading, i.e. ''<nowiki>== Description ==</nowiki>'', then the value in textbody. But when one's click on ''Edit'', it was (obviously) the template !
 +
* Another use could be assigning categories.
 +
 
 +
=== Footer or Header ? ===
 +
For my part, I'd think it more as a header, to resume essentials about the given document. <br>
 +
<!--> 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> <-->
 +
 
 +
However, for not to take the whole page width, we could imagine that this template include itself on one side (left or right, one's can choose). <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> <-->
  
=== Comment coller des valeurs dans la page ? ===
+
I wonder if it would be easy to add a <hide>/<show> button who could show additionnals informations of minor importance ([[User:Synanceia_(Pierre)/Brouillons/Test1|a table test with a hide/show button]]) or if we could include a tab system. For this we need to observe how other sophisticated templates are built... <br>
* 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 ! (logique, en même temps)
+
<!--> Je me demande s'il serait facile d'ajouter un bouton <cacher>/<masquer> qui pourrait dévoiler des informations supplémentaires jugées moins importantes ([[User:Synanceia_(Pierre)/Brouillons/Test1|un essai de tableaux avec un bouton <cacher>/<masquer>]]) 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> <-->
* Une autre utilité serait l'assignation de catégorie(s).  
+
  
=== Pied de page ou en-tête ? ===
 
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 <cacher>/<masquer> qui pourrait dévoiler des informations supplémentaires jugées moins importantes ([[User:Synanceia_(Pierre)/Brouillons/Test1|un essai de tableaux avec un bouton <cacher>/<masquer>]]) 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>
 
[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 12:30, 19 May 2009 (UTC)<br>
  
:;Haut ou bas ?
+
:;Top or Bottom ?
:: 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...
+
:: For my part I thinked there should not have frequently more data in the page, and so, when there is it need to be shown...
:;Droite ou gauche ?
+
<!--> :: 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... <-->
:: 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).
+
:;Right or Left ?
 +
:: If one's want to put an "explorer" (to replace our old [[Template:Français]]), it will be right aligned. Thus, imho, not to the right... To tell a bit more... I don't know if it need to float on the left or (what I'd made alone for today), keep it in full width (default).
 +
<!--> :: 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). <-->
 
:: [[User:Dominique Pautrel|Dominique Pautrel]] 13:01, 20 May 2009 (UTC)
 
:: [[User:Dominique Pautrel|Dominique Pautrel]] 13:01, 20 May 2009 (UTC)
  
== Choix de méthode ==
+
== Choosing a method ==
=== Un ou plusieurs modèles ? ===
+
=== One or more Templates ? ===
: Ancien titre : Un seul modèle avec des paramètres optionnels <br>  
+
: Old title : One template only with optionnal parameters <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 !<br>[[User:Synanceia (Pierre)|Synanceia (Pierre)]] 12:30, 19 May 2009 (UTC)
+
I don't think (Not as my firsts thoughts) that we need to build many templates. Only one could suffice, we just need to condition the display of a template row to the existence of the concerned parameter. Also, if the cited document as a "standard" status, one could hide this row to limit the numbers of information. (seem important to me if the template is a header !) <br>
 +
<!--> : Ancien titre : 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 !<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...
+
: I wonder... In a manner a main template and some sub-templates could be easiest to understand, debug, maintain...
:De l'autre cela fait des passages de paramètres à gérer.
+
: On the other way we'll probably need to deal with passing parameters.
 +
<!-->: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) : http://documentation.openoffice.org/servlets/ReadMsg?listName=dev&msgNo=5459
+
: I've asked for help or feedback (in english) : http://documentation.openoffice.org/servlets/ReadMsg?listName=dev&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.
+
:: And Clayton seem to find it could be a good idea, but as myself didn't saw nothing but a single link to a page, there is probably no template yet for doing such a thing. On [[User:Dominique_Pautrel/Wiki_Localization_Structure|my english page]], he says he like the first one with an icon, and I agree with him it's look prettier. <br>
 +
<!--> :: 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)
 
: [[User:Dominique Pautrel|Dominique Pautrel]] 17:38, 20 May 2009 (UTC)
  
=== Assignation de catégorie(s) ? ===
+
=== Assigning Categories ? ===
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>  
+
If a template assign a category, changing the category in the template will change the category in all pages who use the template. <br>
 +
I see three possibles choices :
 +
# [[#How to paste values in a page ?|Pasting the value in the bottom of the page]], as if the category had been entered by hand...
 +
# Build a robust "engine" to deal with them smartly.
 +
# Go with keywords. Not retained...
 +
:: Exemple was an FR FAQ page about Writer. One's could assignate the four categories FR, Documentation, FAQ, and Writer. And use DPL queries to retrieve pages when intersecting many categories, which could be huges if asked alone. Existent structure is not like that (and perhaps it's better, I don't know). <br>
 +
 
 +
<!-->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 :
 
Je vois trois options possibles :
 
# [[#Comment coller des valeurs dans la page ?|Figer la catégorie en bas de page]], comme si elle avait été entrée à la main...
 
# [[#Comment coller des valeurs dans la page ?|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.  
 
# Construire un "moteur" éprouvé pour les générer finement.  
 
# Procéder par mots-clés. Non retenu...
 
# 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.
+
:: 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. <-->
  
 +
== Parameters ==
 +
This template exist also in French. I'll try to keep the two versions up to date <br>
 +
What is following is nothing more than wished behavior... One could make a subsection for a parameter if necessary. <br>
 +
Please feel free to correct or add something. I've obviously missed a parameter.
  
== Paramètres ==
+
<!--> Ce modèle existe également en anglais. Je vais tenter de maintenir les deux versions à jour <br>
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>
 
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.
+
N'ayez surtout pas peur de discuter ou d'ajouter quelque chose. J'ai forcément oublié un paramètre. <-->
  
 
{| border=1 cellpadding=5
 
{| border=1 cellpadding=5
 
|-
 
|-
! Paramètre !! Valeurs !! Commentaires
+
! Parameter !! Values !! Comments
 
|-
 
|-
|Adresse
+
|Address
|Chaîne de caractères
+
|String
|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
+
|Don't forget <nowiki>http://...</nowiki> to make visible in the Help. (One's could dream with an info-balloon ...). We could also take the easiest method... no restriction and the user of the template put here document's type and weight.
 
|-
 
|-
|Auteur
+
|Authors
|Chaîne de caractères
+
|String
|Liste des auteurs (Conseiller de séparer par une virgule et une espace)
+
|Author(s) list. Recommend to split with a coma and a space.
 
|-
 
|-
 
|Date
 
|Date
 
|AAAA-MM-JJ
 
|AAAA-MM-JJ
|Date de dernière mise à jour du document.
+
|Last update of the document.
 
|-
 
|-
 
|Description
 
|Description
|Chaîne de caractères
+
|String
|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] (amusant, l'effet secondaire de ce lien NOEDITSECTION) mais... ça ne me parait pas élégant.
+
|It should be the largest string entered by the user. It can be built like a page, with headings, etc. But in that case the ''Edit'' links appears in the table cell and edit the template... hum, there's the magic word NOEDITSECTION but it don't seem smart to me.
 
|-
 
|-
 
|Doc
 
|Doc
 
|
 
|
# Oui
+
# Yes
# Non
+
# No
 
|
 
|
# Pour distinguer si le paramètre ''Adresse'' est une page Web ou un lien de téléchargement direct.
+
# To distinguish if the ''Address'' parameter is a web page or a direct download link.
# Obligatoire. (enfin, c'est ce que j'aimerais... à priori)
+
# Mandatory. (hu, I'd like so... at the first glance)
 
|-
 
|-
|Légende
+
|Legend
 
|
 
|
# Oui
+
# Yes
#Non
+
# No
| 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.
+
| If "Yes", then include the Title parameter as a DISPLAYTITLE command, thus only one instance per page, for How-Tos, Tutorials or Guides. "No" could permit to include more instances (FAQ) and assign "Main Entrance" with DISPLAYTITLE. ;-)
 
|-
 
|-
 
|Module
 
|Module
Line 85: Line 111:
 
# Calc
 
# Calc
 
# Draw
 
# Draw
# Général
+
# General
 
# Impress
 
# Impress
# Installation
 
 
# Math
 
# Math
 +
# Setup
 
# 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>
+
|It would be nice (example with Base) that corresponding icon appears. [[Image:Base.png|50px]] ou carrément [[Image:Base.png]] <br>
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...
+
This parameter could also be used for defining a category to assign, but it's not sufficient for distinguish the document type, FAQ, How-To...
 
|-
 
|-
|Plate-forme
+
|Platform
 
|
 
|
 
# Linux
 
# Linux
 
# Mac
 
# Mac
# Toutes (défaut)
+
# All (default)
 
# Windows
 
# Windows
 
# etc. ?
 
# etc. ?
|Le fin du fin serait que si ce paramètre n'est pas renseigné, au lieu d'une erreur il affiche "Toutes"
+
|State of the art could be that if absent, no exception is generated but string "All"
 
|-
 
|-
|Statut
+
|Status
 
|
 
|
# Préliminaire
+
# Preliminary
 
# Standard
 
# Standard
# Obsolète
+
# Obsolete
Autres
+
Other
 
|
 
|
# Tant qu'il n'est pas finalisé.
+
# While the document is not finalized.
 
# Stable.
 
# Stable.
# Plus à jour où uniquement utilisable avec d'anciennes versions. Dans ce cas, préciser.
+
# Out of Date or usable only with older versions. In this case, add comment.
Donc autoriser les commentaires et se servir de ces trois termes comme balise d'en-tête de la chaîne.
+
Thus authorize comments and use the three terms as [Balise] , at the beginning of the string.
 
|-
 
|-
|Titre
+
|Title
|Chaîne de caractères
+
|String
|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... <br>
+
|At this time it appears twice, for the page and for the table... It's also for this reason I imagined it as a footer... <br>
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). En fait il faudrait créer un paramètre interrupteur...
+
The fact of not including DISPLAYTITLE give the advantage to can put many instances of the template on one page (for FAQ type document]. Indeed one's need to create a switch parameter...
 
|-
 
|-
 
|}
 
|}
 +
 +
{{Spacer|50}}
 +
 +
=== Icon and Color ===
 +
 +
* Icon display : [[Template:Icon]].
 +
* Color display : [[Template:Color]]
 +
For this purpose one's need to use the [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions extension from MediaWiki], particularly the #switch function, which permit a "mapping" table so that entering "Base" will output Base.png for ''Icon'' and relative RVB color for ''Color'' as well.
 +
 +
<br>
 +
<center>
 +
{| border="1" style="width: 800px; height: 120px;"
 +
|+ [[Template:Icon|Icon]] and [[Template:Color|Color]] templates included together.
 +
|-
 +
! 2nd Parameter: Position. Mapping:
 +
! Call
 +
! Result of the two templates :
 +
|-
 +
|
 +
{| style="width: 300px; height: 80px;"
 +
|-
 +
| Nine values from 1 to 9
 +
::From Top Left
 +
:::To bottom Right
 +
 +
|
 +
{| cellpadding="3"
 +
|-
 +
| 1
 +
| 2
 +
| 3
 +
|-
 +
| 4
 +
| 5
 +
| 6
 +
|-
 +
| 7
 +
| 8
 +
| 9
 +
|}
 +
|}
 +
Encountering problems with other than 1 and 3...
 +
| '''Code&nbsp;:'''<br><nowiki>bgcolor={{Color|Calc}} | {{Icon|Calc|3|50}}The result is...</nowiki>
 +
| align="left" bgcolor={{Color|Calc}} | {{Icon|Calc|3|50}}The result is now a 50 pixels floating Calc icon, at the top right of the green cell, permitting text to fill in cell without blank space for a more esthetic result... (but I wonder for now how to eliminate this unwanted "blank line" at the top of cell)
 +
|}
 +
</center>
 +
 +
{{Spacer|50}}
 +
 +
=== Licenses ===
 +
[[User:Dominique Pautrel|Dominique Pautrel]] 13:23, 29 May 2009 (UTC) (About the possibles licenses for the pointed link, not the page itself.) <br>
 +
* When started, I thinked the way was to cite only free documentation, for simply respect everyone's works. Seem to be a bit more complicated...
 +
* Well, I've thought essentially to documentation, so PDL and CCBY for example. But, amongst others, there is the extension case which could have the GPL license as well...
 +
* So I thought to another [[Template:Licenses]] with #switch again. This way user could comfortably make use of known acronyms for licenses...
 +
* If you agree with me, try to complete, in alphabetical order, the following. (If no, thank you for a little explanation to make me understand why, if I could :-)
 +
 +
{{Spacer|20}}
 +
<center>
 +
{| class="prettytable sortable" border="1" cellpadding="10"
 +
|+ This table need '''HELP''' if <br>a correct '''link''' don't appears in the output. <br>Values could be added when needed. <br>If the template is created, then this table will move...
 +
|-
 +
! Input !! Output
 +
|-
 +
! CCBY
 +
| [http://creativecommons.org/licenses/by/3.0/ Creative Common Attribution 3.0 license (CC-BY)]
 +
|-
 +
! GFDL || GNU (or Global ?) Free Documentation License
 +
|-
 +
! GPL || Global public license
 +
|-
 +
! LGPL || Lesser Global public license
 +
|-
 +
! PDL
 +
| [http://www.openoffice.org/licenses/PDL.html Public Documentation License (PDL)]
 +
|-
 +
|}
 +
</center>
 +
 +
* 11:00, 31 May 2009 (UTC) : A bit more informations at : http://www.gnu.org/licenses/licenses.html
 +
* In a slightly different way of mind, friend [[User:Synanceia_(Pierre)|Pierre]] has asked ([http://fr.wikipedia.org/wiki/Wikip%C3%A9dia:Legifer/mai_2009#R.C3.A9utiliser_un_mod.C3.A8le_de_wikipedia.org French discuss...]) if he could re-use a few templates from Wikipedia's ones for our wiki. The answer was (I try to do my best with translation, sorry for mistakes... beware about content ;-) that our PDL License is not (completely) free, since "authors copyright's notice say that author's rights are owned by Sun Microsystems Corporation and contributors. There is not freedom of reuse of contents, except the specific contributions frome eight contributeurs which give their job under four free licences. (An only one of this contributors, contributions of which are strictly under GFDL and CC-by-sa-3.0, could perhaps in some weeks to reuse the contents of Wikipédia, and in pages which would contain his own contributions only.) In conclusion, this not free site and not GFDL is incompatible with contents under GFDL and therefore can't reuse the contents of Wikipédia, nor other contents under GFDL."
 +
* But here it's not the same, because this template only "Cite" content. The ''License'' parameter is only a link to the external document's license type.
 +
 +
{{Spacer|50}}
 +
 +
=== Versions ===
 +
It seem obvious to distinguish three distinct ''Version...'' parameters :
 +
# '''Version''' of the document or application itself, simply called here the '''link'''
 +
# '''VersionStart''' The version of {{OOo}} from witch it's possible to use this link. (i.e. 2.0)
 +
# '''VersionEnd''' The version of {{OOo}} since this link is obsolete, as set in the ''Status'' parameter.
 +
What I don't like are the parameters names themselves. I don't even know if there is (probably) a norm. Could you suggest better names ? Thanks in advance !

Latest revision as of 11:00, 31 May 2009

fr:Template_talk:FR/CitePage

This page is only a translation today and I may write like a child. If you find non sense I've just hidden the french text :-) Dominique Pautrel 23:25, 21 May 2009 (UTC)

Display

About graphical display. It is really basic today, thus easy to enhance...

How to paste values in a page ?

  • I started with entering this parameter in a heading, i.e. == Description ==, then the value in textbody. But when one's click on Edit, it was (obviously) the template !
  • Another use could be assigning categories.

Footer or Header ?

For my part, I'd think it more as a header, to resume essentials about the given document.

However, for not to take the whole page width, we could imagine that this template include itself on one side (left or right, one's can choose).

I wonder if it would be easy to add a <hide>/<show> button who could show additionnals informations of minor importance (a table test with a hide/show button) or if we could include a tab system. For this we need to observe how other sophisticated templates are built...

Synanceia (Pierre) 12:30, 19 May 2009 (UTC)

Top or Bottom ?
For my part I thinked there should not have frequently more data in the page, and so, when there is it need to be shown...
Right or Left ?
If one's want to put an "explorer" (to replace our old Template:Français), it will be right aligned. Thus, imho, not to the right... To tell a bit more... I don't know if it need to float on the left or (what I'd made alone for today), keep it in full width (default).
Dominique Pautrel 13:01, 20 May 2009 (UTC)

Choosing a method

One or more Templates ?

Old title : One template only with optionnal parameters

I don't think (Not as my firsts thoughts) that we need to build many templates. Only one could suffice, we just need to condition the display of a template row to the existence of the concerned parameter. Also, if the cited document as a "standard" status, one could hide this row to limit the numbers of information. (seem important to me if the template is a header !)
Synanceia (Pierre) 12:30, 19 May 2009 (UTC)

I wonder... In a manner a main template and some sub-templates could be easiest to understand, debug, maintain...
On the other way we'll probably need to deal with passing parameters.
I've asked for help or feedback (in english) : http://documentation.openoffice.org/servlets/ReadMsg?listName=dev&msgNo=5459
And Clayton seem to find it could be a good idea, but as myself didn't saw nothing but a single link to a page, there is probably no template yet for doing such a thing. On my english page, he says he like the first one with an icon, and I agree with him it's look prettier.
Dominique Pautrel 17:38, 20 May 2009 (UTC)

Assigning Categories ?

If a template assign a category, changing the category in the template will change the category in all pages who use the template.
I see three possibles choices :

  1. Pasting the value in the bottom of the page, as if the category had been entered by hand...
  2. Build a robust "engine" to deal with them smartly.
  3. Go with keywords. Not retained...
Exemple was an FR FAQ page about Writer. One's could assignate the four categories FR, Documentation, FAQ, and Writer. And use DPL queries to retrieve pages when intersecting many categories, which could be huges if asked alone. Existent structure is not like that (and perhaps it's better, I don't know).


Parameters

This template exist also in French. I'll try to keep the two versions up to date
What is following is nothing more than wished behavior... One could make a subsection for a parameter if necessary.
Please feel free to correct or add something. I've obviously missed a parameter.


Parameter Values Comments
Address String Don't forget http://... to make visible in the Help. (One's could dream with an info-balloon ...). We could also take the easiest method... no restriction and the user of the template put here document's type and weight.
Authors String Author(s) list. Recommend to split with a coma and a space.
Date AAAA-MM-JJ Last update of the document.
Description String It should be the largest string entered by the user. It can be built like a page, with headings, etc. But in that case the Edit links appears in the table cell and edit the template... hum, there's the magic word NOEDITSECTION but it don't seem smart to me.
Doc
  1. Yes
  2. No
  1. To distinguish if the Address parameter is a web page or a direct download link.
  2. Mandatory. (hu, I'd like so... at the first glance)
Legend
  1. Yes
  2. No
If "Yes", then include the Title parameter as a DISPLAYTITLE command, thus only one instance per page, for How-Tos, Tutorials or Guides. "No" could permit to include more instances (FAQ) and assign "Main Entrance" with DISPLAYTITLE. ;-)
Module
  1. Base
  2. Calc
  3. Draw
  4. General
  5. Impress
  6. Math
  7. Setup
  8. Writer
It would be nice (example with Base) that corresponding icon appears. Base.png ou carrément Base.png

This parameter could also be used for defining a category to assign, but it's not sufficient for distinguish the document type, FAQ, How-To...

Platform
  1. Linux
  2. Mac
  3. All (default)
  4. Windows
  5. etc. ?
State of the art could be that if absent, no exception is generated but string "All"
Status
  1. Preliminary
  2. Standard
  3. Obsolete

Other

  1. While the document is not finalized.
  2. Stable.
  3. Out of Date or usable only with older versions. In this case, add comment.

Thus authorize comments and use the three terms as [Balise] , at the beginning of the string.

Title String At this time it appears twice, for the page and for the table... It's also for this reason I imagined it as a footer...

The fact of not including DISPLAYTITLE give the advantage to can put many instances of the template on one page (for FAQ type document]. Indeed one's need to create a switch parameter...

Icon and Color

For this purpose one's need to use the ParserFunctions extension from MediaWiki, particularly the #switch function, which permit a "mapping" table so that entering "Base" will output Base.png for Icon and relative RVB color for Color as well.


Icon and Color templates included together.
2nd Parameter: Position. Mapping: Call Result of the two templates :
Nine values from 1 to 9
From Top Left
To bottom Right
1 2 3
4 5 6
7 8 9

Encountering problems with other than 1 and 3...

Code :
bgcolor={{Color|Calc}} | {{Icon|Calc|3|50}}The result is...
Calc.png


The result is now a 50 pixels floating Calc icon, at the top right of the green cell, permitting text to fill in cell without blank space for a more esthetic result... (but I wonder for now how to eliminate this unwanted "blank line" at the top of cell)

Licenses

Dominique Pautrel 13:23, 29 May 2009 (UTC) (About the possibles licenses for the pointed link, not the page itself.)

  • When started, I thinked the way was to cite only free documentation, for simply respect everyone's works. Seem to be a bit more complicated...
  • Well, I've thought essentially to documentation, so PDL and CCBY for example. But, amongst others, there is the extension case which could have the GPL license as well...
  • So I thought to another Template:Licenses with #switch again. This way user could comfortably make use of known acronyms for licenses...
  • If you agree with me, try to complete, in alphabetical order, the following. (If no, thank you for a little explanation to make me understand why, if I could :-)
This table need HELP if
a correct link don't appears in the output.
Values could be added when needed.
If the template is created, then this table will move...
Input Output
CCBY Creative Common Attribution 3.0 license (CC-BY)
GFDL GNU (or Global ?) Free Documentation License
GPL Global public license
LGPL Lesser Global public license
PDL Public Documentation License (PDL)
  • 11:00, 31 May 2009 (UTC) : A bit more informations at : http://www.gnu.org/licenses/licenses.html
  • In a slightly different way of mind, friend Pierre has asked (French discuss...) if he could re-use a few templates from Wikipedia's ones for our wiki. The answer was (I try to do my best with translation, sorry for mistakes... beware about content ;-) that our PDL License is not (completely) free, since "authors copyright's notice say that author's rights are owned by Sun Microsystems Corporation and contributors. There is not freedom of reuse of contents, except the specific contributions frome eight contributeurs which give their job under four free licences. (An only one of this contributors, contributions of which are strictly under GFDL and CC-by-sa-3.0, could perhaps in some weeks to reuse the contents of Wikipédia, and in pages which would contain his own contributions only.) In conclusion, this not free site and not GFDL is incompatible with contents under GFDL and therefore can't reuse the contents of Wikipédia, nor other contents under GFDL."
  • But here it's not the same, because this template only "Cite" content. The License parameter is only a link to the external document's license type.

Versions

It seem obvious to distinguish three distinct Version... parameters :

  1. Version of the document or application itself, simply called here the link
  2. VersionStart The version of Apache OpenOffice from witch it's possible to use this link. (i.e. 2.0)
  3. VersionEnd The version of Apache OpenOffice since this link is obsolete, as set in the Status parameter.

What I don't like are the parameters names themselves. I don't even know if there is (probably) a norm. Could you suggest better names ? Thanks in advance !

Personal tools