Template talk:CitePage

From Apache OpenOffice Wiki
Jump to: navigation, search

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...

Personal tools