Difference between revisions of "User:Dominique Pautrel/Structure Wiki FR"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Requêtes sur les catégories)
m (Requêtes sur les catégories)
Line 58: Line 58:
 
</DPL>
 
</DPL>
 
</pre>
 
</pre>
Pour obtenir :
+
Pour obtenir la liste des pages contenant les deux catégories "Documentation" et "FR" :
 
<DPL>
 
<DPL>
 
   category=Documentation
 
   category=Documentation
Line 81: Line 81:
  
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
|width=40% style="text-align:center;"|Documentation toutes langues confondues
+
|width=40% style="text-align:center;"|{{#dpl:category=Documentation|resultsheader=%PAGES% pages dans la catégorie Documentation.|mode=userformat}}
 
|style="background-color: #FFF"|
 
|style="background-color: #FFF"|
|width=40% style="text-align:center;"|Documents dans la catégorie FR
+
|width=40% style="text-align:center;"|{{#dpl:category=FR|resultsheader=Il y a %PAGES% pages dans la catégorie FR.|mode=userformat}}
  
 
|-valign=top  
 
|-valign=top  
Line 99: Line 99:
 
</DPL>
 
</DPL>
 
|-valign=top
 
|-valign=top
|{{Spacer|30}} || ||
+
|{{Spacer|50}} || ||
 +
|}
  
 +
===How-Tos===
 +
 +
{|width=90% cellpadding=5 border=0 align=center cellspacing=0
 +
 +
|-style="font-size:150%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center" colspan="3"|Les différentes catégories de How-Tos :
 +
|-valign=top
 +
|{{Spacer|10}} || ||
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
|style="text-align:center"|Presentations
+
|style="text-align:center"|Presentations: "Documentation/How_Tos/Impress"
 
|style="background-color: #FFF"|
 
|style="background-color: #FFF"|
|style="text-align:center"|Installation
+
|style="text-align:center"|Installation: "Documentation/How_Tos/Installation"
  
 
|-valign=top
 
|-valign=top
Line 124: Line 133:
  
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
|style="text-align:center"|Documents Texte
+
|style="text-align:center"|Le Texte: "Documentation/How_Tos/Writer"
 
|style="background-color: #FFF"|
 
|style="background-color: #FFF"|
|style="text-align:center"|Tableur
+
|style="text-align:center"|Tableur: "Documentation/How_Tos/Calc"
  
 
|-valign=top
 
|-valign=top
Line 146: Line 155:
  
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
|style="text-align:center"|Bases de données
+
|style="text-align:center"|Bases de données: "Documentation/How_Tos/Database"
 
|style="background-color: #FFF"|
 
|style="background-color: #FFF"|
|style="text-align:center"|Dessin
+
|style="text-align:center"|Dessin: Documentation/How_Tos/Draw"
  
 
|-valign=top
 
|-valign=top
Line 168: Line 177:
  
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
|style="text-align:center"|Formules
+
|style="text-align:center"|Formules: "Documentation/How_Tos/Math"
 
|style="background-color: #FFF"|
 
|style="background-color: #FFF"|
|style="text-align:center"|Macros et API
+
|style="text-align:center"|Macros et API: "Documentation/How_Tos/Macro"
  
 
|-valign=top
 
|-valign=top
Line 181: Line 190:
 
|
 
|
 
|style="border: 1px solid #CDDBF6"|
 
|style="border: 1px solid #CDDBF6"|
<div style="float:right; margin-top: -45px;">[[image:Basic.png|50px]]</div>
+
<div style="float:right; margin-top: -45px;">[[image:Macro.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/How_Tos/Macro
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
 
 +
|-valign=top
 +
|{{Spacer|30}} || ||
 +
|}
 +
===FAQ===
 +
 
 +
{|width=90% cellpadding=5 border=0 align=center cellspacing=0
 +
 
 +
|-style="font-size:150%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center" colspan="3"|Les longues listes des FAQ :
 +
|-valign=top
 +
|{{Spacer|10}} || ||
 +
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center"|Presentations: "Documentation/FAQ/Impress"
 +
|style="background-color: #FFF"|
 +
|style="text-align:center"|Installation: "Documentation/FAQ/Installation"
 +
 
 +
|-valign=top
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Impress.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Impress
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
|
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Edit.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Installation
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
 
 +
|-valign=top
 +
 
 +
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center"|Le Texte: "Documentation/FAQ/Writer"
 +
|style="background-color: #FFF"|
 +
|style="text-align:center"|Tableur: "Documentation/FAQ/Calc"
 +
 
 +
|-valign=top
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Writer.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Writer
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
|
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Calc.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Calc
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
 
 +
|-valign=top
 +
 
 +
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center"|Bases de données: "Documentation/FAQ/Base"
 +
|style="background-color: #FFF"|
 +
|style="text-align:center"|Dessin: Documentation/FAQ/Draw"
 +
 
 +
|-valign=top
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Base.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Base
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
|
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Draw.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Draw
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
 
 +
|-valign=top
 +
 
 +
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
 +
|style="text-align:center"|Formules: "Documentation/FAQ/Math"
 +
|style="background-color: #FFF"|
 +
|style="text-align:center"|Macros et API: "Documentation/FAQ/Basic"
 +
 
 +
|-valign=top
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Math.png|50px]]</div>
 +
<DPL>
 +
category=Documentation/FAQ/Math
 +
replaceintitle=/Documentation\/How Tos\//,
 +
</DPL>
 +
|
 +
|style="border: 1px solid #CDDBF6"|
 +
<div style="float:right; margin-top: -45px;">[[image:Macro.png|50px]]</div>
 
<DPL>
 
<DPL>
category=Documentation/How_Tos/Basic
+
category=Documentation/FAQ/UNO
 
replaceintitle=/Documentation\/How Tos\//,
 
replaceintitle=/Documentation\/How Tos\//,
 
</DPL>
 
</DPL>

Revision as of 10:47, 25 April 2009

Documentation caution.png

S'il vous plait ne créez pas de liens durables vers cette page. Elle est destinée à être un brouillon et, suite à un couper/coller, supprimée. Il n'y aura donc pas de redirection suite à cela. En revanche complétez, clarifiez, discutez ici-même, ou même déplaçons la avant tout de suite, ou intégrons la à, si vous lui voyez sa place avec certitude... ;-)

L'objet de ce document est d'établir ensemble une structure univoque... S'il doit aboutir... il ne sera plus que le reflet de l'architecture existante.


Template:Documentation/Note

Préambule

Cette page focalise sur les noms des pages dans le Wiki d'Apache OpenOffice, et est incidemment destinée à vous aider à contribuer facilement à la documentation...

Faites attention de bien mémoriser les trois chaînes de caractères ci-dessous (qui sont autant de liens) pour la suite du propos :

  1. http://wiki.services.openoffice.org/wiki : L'adresse de base, donc dans la langue native du projet, en anglais. La page parente de toutes les autres.
  2. /FR : La branche française, également appelée plus bas simplement FR.
  3. /FR/Documentation : La page "racine" de la documentation en français.

Ainsi que le fait que dans ce document, il sera employé régulièrement le conditionnel. Ceci parce que les choix de structure évoluent et que bien des pages existantes ne répondent pas (ou plus ou pas encore) aux critères énoncés ci-dessous... ce n'est pas un problème... mais ce n'est pas toujours simple non plus. Si d'autre part vous voyez des adresses apparaître en rouge comme ceci, c'est ou que le débat n'est pas clos et qu'aucune décision n'a encore été prise, ou que cette page, qui en héberge cependant d'autres, n'existe pas car non jugée nécessaire...

Règles de base pour les nouvelles adresses

(en toute logique)

  1. Concises: Courtes et descriptives. Le plus précis possible sans redondance.
  2. En français: Dès lors visible depuis Google ou autres moteurs de recherches.

Différences dues à la localisation

Il y en aura toujours et probablement même pour les traductions "synchronisées" par des liens interwikis, principalement par le fait que les moteurs de recherche sont efficaces sur les noms de pages, et les traductions effectuées ne seraient sinon pas bien visibles depuis Google pour le public visé, par exemple...

Développement

Le Wiki a été conçu par les développeurs pour eux-même. Veuillez vous reporter à l'adresse #1 pour plus de détails.

Documentation

Grossièrement, on pourrait scinder la documentation existante en trois parties :

  1. Les manuels de référence ou guides, des ouvrages couvrant un domaine et pouvant atteindre plusieurs centaines de pages.
  2. Les How-tos ou mini-guides couvrant un domaine plus précis, d'un contenu généralement compris entre une et trente pages.
  3. La FAQ ou les questions fréquemment posées, une question précise, une réponse concise.

Guides

Il n'y en a pas énormément disponibles sur le Wiki en français. Mais en revanche il contiennent nombre de sous-liens et l'adresse de base gagne à être courte, sans redondance :

J'en voix deux aujourd'hui :

How-Tos

Ceux-ci sont déjà plus nombreux :

FAQ

Elles sont souvent impressionnantes :

  • FR/FAQ. A noter que les anglais en on fait une sous-page de Documentation, soit Documentation/FAQ. (c'est logique, il peut exister d'autres FAQ, mais c'est plus long et probablement inutile dans le cas d'une localisation).

Catégories

Requêtes sur les catégories

Vous pouvez afficher des listes dynamiques de page où des catégories ont été affectées :

Par exemple, entrez :

<DPL>
  category=Documentation
  category=FR
</DPL>

Pour obtenir la liste des pages contenant les deux catégories "Documentation" et "FR" :

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Moralité : Ces dernières sont sous-employées... ;-)

Autres essais : (si vous avez des exemples fonctionnels, faites disparaitre "%DPL-1.7.4-WARNING: No results!" ;-)

<DPL>
  ' Recherches infructueuses : location=FR ; special=parameter ; lang=FR ; category=category
</DPL>

Le résultat risque d'être :

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Quelques listes ainsi générées :

269 pages dans la catégorie Documentation. Il y a 112 pages dans la catégorie FR.

How-Tos

Les différentes catégories de How-Tos :
Presentations: "Documentation/How_Tos/Impress" Installation: "Documentation/How_Tos/Installation"
Impress.png
Edit.png
Le Texte: "Documentation/How_Tos/Writer" Tableur: "Documentation/How_Tos/Calc"
Writer.png
Calc.png
Bases de données: "Documentation/How_Tos/Database" Dessin: Documentation/How_Tos/Draw"
Base.png
Draw.png
Formules: "Documentation/How_Tos/Math" Macros et API: "Documentation/How_Tos/Macro"
Math.png

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Macro.png

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

FAQ

Les longues listes des FAQ :
Presentations: "Documentation/FAQ/Impress" Installation: "Documentation/FAQ/Installation"
Impress.png
Edit.png
Le Texte: "Documentation/FAQ/Writer" Tableur: "Documentation/FAQ/Calc"
Writer.png
Calc.png
Bases de données: "Documentation/FAQ/Base" Dessin: Documentation/FAQ/Draw"
Base.png

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Draw.png
Formules: "Documentation/FAQ/Math" Macros et API: "Documentation/FAQ/Basic"
Math.png

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Macro.png

Extension:DynamicPageList (DPL), version 2.3.0 : Warning: No results.

Modèles

Personal tools