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

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Modèles existants (Templates))
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:Structure du Wiki {{OOo}} français}}
 
{{DISPLAYTITLE:Structure du Wiki {{OOo}} français}}
 
{{Documentation/FR/Attention|
 
{{Documentation/FR/Attention|
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... ;-)
+
* 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.  
 +
* Un guide de l'éditeur est démarré ici : [[FR/Wiki/Aide:Editeur]] ;-)
  
 
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.
 
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.
 
}}
 
}}
{{Documentation/Note|
+
{{Note|
 
J'aimerais un groupe de pages unies dans un seul but. J'en vois aujourd'hui trois, ou quatre, qui, une fois complétées, pourraient être des sous-pages de FR/Documentation/TableauBord :
 
J'aimerais un groupe de pages unies dans un seul but. J'en vois aujourd'hui trois, ou quatre, qui, une fois complétées, pourraient être des sous-pages de FR/Documentation/TableauBord :
 
# [[FR/Documentation/TableauBord/Organisation]]. Cette page doit-être mise, et maintenue à jour.
 
# [[FR/Documentation/TableauBord/Organisation]]. Cette page doit-être mise, et maintenue à jour.
Line 16: Line 17:
 
Cette page focalise sur les noms des pages dans le Wiki d'{{OOo}}, et est incidemment destinée à vous aider à contribuer facilement à la documentation...
 
Cette page focalise sur les noms des pages dans le Wiki d'{{OOo}}, 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 :
+
Contenu déplacé ici : [[FR/Wiki/Aide:Nouvelle_page]]
# ''[[Main_Page|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.
+
# [[FR|/FR]] : La branche française, également appelée plus bas simplement FR.
+
# [[FR/Documentation|/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 <font color="red">en rouge comme ceci</font>, 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)
+
 
+
# Concises: Courtes et descriptives. Le plus précis possible sans redondance.
+
# En français: Dès lors visible depuis Google ou autres moteurs de recherches.
+
# Lisibilité: .C3.89viter_quand-m.C3.AAme_les_caract.C3.A8res_accentu.C3.A9s_du_fran.C3.A7ais
+
: (Qu'il faut traduire par: Éviter_quand-même_les_caractères_accentués_du_français)
+
: Dans ce cas écrivez: Eviter quand-meme les caracteres accentues du francais
+
: Qui laissera l'adresse lisible :-)
+
 
+
 
+
  
 
==Différences dues à la localisation==
 
==Différences dues à la localisation==
Line 42: Line 28:
  
 
=Documentation=
 
=Documentation=
Grossièrement, on pourrait scinder la documentation existante en trois parties :
+
Section déplacée : [[FR/Wiki/Structure:Documentation]]
# Les manuels de référence ou guides, des ouvrages couvrant un domaine et pouvant atteindre plusieurs centaines de pages.
+
# Les How-tos ou mini-guides couvrant un domaine plus précis, d'un contenu généralement compris entre une et trente pages.
+
# La FAQ ou les questions fréquemment posées, une question précise, une réponse concise.
+
# A noter que les anglophones ont une section [[Documentation/Tutorials|Tutorials]], ou les documents sont regroupés par auteur.
+
 
+
==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 :
+
 
+
{{Documentation/FR/Note| '''Quelques guides en français :'''}}
+
* Le guide d'administration, à l'adresse [[FR/Documentation/Administration_Guide]]
+
* Le guide de programmation Basic : [[FR/Documentation/BASIC_Guide]]
+
* Le guide pour Writer v3 : [[FR/Documentation/Writer_Guide]]
+
* Le guide HSQLDB : [[FR/Documentation/HSQLDB_Guide]]
+
* Les fonctions listées par catégories pour Calc : [[FR/Documentation/Calc/Fonctions_listees_par_categories]]
+
* Sur le site standard, il y a des guides très intéressant : [http://fr.openoffice.org/Documentation/Guides/Indexguide.html]
+
** Bien sur Tony, j'aurais dû même mettre ce lien en tête de liste puisqu'il représente notre première "banque de données", dans l'ordre chronologique... et contient vraiment des mines d'information. En même temps et à moins de déjà bien en avoir exploré le contenu, il faut reconnaître que pour un débutant...
+
** Personnellement je me souhaite un bon courage en arrivant ici, car je me dis qu'il va falloir que je télécharge les quelques documents en rapport avec ce que je recherche, puis que je les compare entre eux - car notamment "date" et "pour quelle version" ne sont pas toujours clairement définis...
+
** Je tente de répondre à ce constat, au paragraphe [[#Des pages pour des liens externes|"Des pages pour des liens externes"]].
+
* Ajoutez un oubli...
+
 
+
 
+
 
+
 
+
 
+
{{Documentation/FR/Astuce|'''Pour les courageux, entreprises de traductions à lancer :'''}}
+
* [[Documentation/DevGuide]]. Voir cette discussion : http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5430
+
* [[Documentation/OOo3_User_Guides/Impress_Guide]]
+
* [[Documentation/OOo3_User_Guides/Calc_Guide]], pour prendre de l'avance avant qu'il ne soit fini.
+
* [[Documentation/OOo3_User_Guides/Draw_Guide]], de même...
+
* Pour ce qui est du guide pour le débutant, [[Documentation/OOo3_User_Guides/Getting_Started]], considérez plutôt [http://fr.openoffice.org/servlets/ReadMsg?list=doc&msgNo=9970 cette annonce d'Éric Bachard].  :-)
+
 
+
A noter que les deux premiers cités ont été réalisés en accord avec les liens inter-wikis automatiques. L'unique différence réside dans les adresses des pages, chez nous augmentées des trois caractères "/FR" directement après l'adresse de base. Ceci permet de "synchroniser" les langues, un modèle simple assurant la liaison automatique entre chaque page.
+
 
+
Mais ceci enlèverait la recherche en français dans les moteurs de recherche. Je m'exprime au conditionnel car je n'ai pas trouvé d'exemple probant de ce défaut, partant du principe que les mots-clés de ma recherche sont ceux présents dans le titre affiché par la commande DISPLAYTITLE. Mais j'ai également observé que, si la réponse arrive bien en première ligne dans Google, elle s'effectue sur les mots dans la page, et non la commande DISPLAYTITLE. Ce dernier constat implique au rédacteur de reprendre les mots traduits dans le corps de la page, en plus de la commande DISPLAYTITLE, pour qu'une recherche en français soit efficiente.
+
 
+
Par exemple, quelques recherches efficaces dans le guide d'administration via Google :
+
* [http://www.google.fr/search?hl=fr&q=autotexte+reseau&btnG=Rechercher&meta= autotexte reseau]
+
* [http://www.google.fr/search?hl=fr&q=personnaliser+interface+utilisateur&btnG=Rechercher&meta= personnaliser interface utilisateur]
+
* [http://www.google.fr/search?hl=fr&q=installer+openoffice.org+modele+reseau&btnG=Rechercher&meta= installer openoffice.org modele reseau]
+
Si vous trouvez une recherche inefficace malgré que les termes recherchés soient inclus dans la commande DISPLAYTITLE, merci de l'ajouter ici-même afin de discuter ce constat :
+
 
+
==How-Tos==
+
Ceux-ci sont déjà plus nombreux :
+
* [[FR/Documentation/How_Tos]]
+
 
+
==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).
+
 
+
==Tutoriels==
+
Nos amis anglophones ont donc une partie [[Documentation/Tutorials|Tutorials]]...
+
 
+
Et nous, nous avons de la documentation "externe" sur divers sites dédiés à {{OOo}} :
+
* En dehors de [[FR|ce wiki]] :
+
* [http://fr.openoffice.org/Documentation/Index.html La rubrique documentation]
+
* [http://user.services.openoffice.org/fr/forum/index.php Le forum]
+
* [http://www.formation-openoffice.fr/ Le centre de documentation du forum]
+
* [http://christianwtd.free.fr/ Le site de christianwtd]
+
* [http://ooo.developpez.com/faq/ La FAQ de développez.com]
+
*
+
* J'en oublie fatalement...
+
 
+
 
+
 
+
Effectivement, créer une page [[FR/Documentation/Tutoriels]] ajouterait une section non négligeable à la documentation...
+
 
+
Selon la richesse de la présentation (entre une seule liste et une sous-page par lien, accompagné d'une ou deux phrases descriptives du tutoriel), ceci représenterait une somme de travail, non seulement pour la création mais aussi la maintenance de toutes ces sous-pages... Liens dont il faudrait vérifier de temps en temps la pertinence...
+
 
+
Ceci pourrait-être également un moyen de rendre visible plus de documentation francophone sur ce wiki {{OOo}}... et par le biais des sous-pages, assigner des catégories, et recréer des "tables des matières" par requêtes DPL
+
  
 
== Des pages pour des liens externes ==
 
== Des pages pour des liens externes ==
Nous devrions créer nombre de sous-pages pour référencer - progressivement - l'ensemble de la documentation francophone.
+
[[FR/Wiki/Structure:Documentation#Des_pages_pour_des_liens_externes|Même page que ci-dessus]]
* Par le fait, le cahier des charges est assez conséquent. Mais si cela représente un [[:Category:Efforts|effort]], il reste évidemment bien moindre que la documentation elle même. C'est aussi lui rendre hommage - et surtout visibilité. Un document de qualité mérite bien une page, visible au moins depuis une catégorie.
+
* À terme, les pages d'accueils des guides, How-Tos pourront être nourries par requêtes. Si la catégorie devient vraiment peuplée, il sera alors agréable de créer des sous-catégories, et ainsi constituer une table des matières qui saura rester claire...
+
* Pour le coté visuel de cette tâche, nous pourrions créer au moins deux modèles :
+
*# [[Template:FR/LienExterne]] présentant, sous forme d'un tableau, les paramètres suivants :
+
*## Titre >> Titre du document
+
*## PlateForme >> Optionnel. Sinon valeur par défaut: "Toutes"
+
*## Descriptif >> Court descriptif d'une à quelques phrases
+
*## Version >> Version concernée de {{OOo}}
+
*## Date >> De dernière modification
+
*## Lien >> Lien vers la page (d'accueil)
+
*# [[Template:FR/DocumentExterne]], contenant en plus du premier :
+
*## Lien >> Cette fois le lien de téléchargement direct
+
*## Type >> Type du document (ODT, PDF, etc...)
+
*## Poids >> Poids du fichier, exprimé en Ko, Mo...
+
 
+
à suivre...
+
  
 
=Catégories=
 
=Catégories=
Les [[Categories|catégories]] peuvent-être considérées comme autant de mots-clefs. Prenons pour exemple une page (française) affublée de la catégorie [[:Category:FR|FR]] : <pre>[[Category:FR]]</pre> S'affiche en bas de page un bandeau avec le lien vers la (page) catégorie FR, et notre présente page apparait dès lors dans cette page particulière qu'est une catégorie, à coté de toutes les autres pages (françaises) pareillement catégorisées.
+
Section transférée sur cette page : [[FR/Wiki/Aide:Categories]]
  
{{Documentation/Note|
 
C'est d'ailleurs un bon réflexe pour conserver simplement une vue globale, en ordre alphabétique, de toutes les pages françaises. Ce comportement est similaire au résultat d'une recherche depuis un dossier de votre disque dur, excepté le fait que le "dossier" en question est en fait une catégorie Wiki.
 
 
Il est d'ailleurs possible de définir un paramètre de tri supplémentaire avec le caractère "pipe" <nowiki>("|")</nowiki> qui définit la position à laquelle la page apparait, alphabétiquement, à l'intérieur de la catégorie. A titre d'exemple, pour le guide HSQLDB qui apparait à la lettre H dans la catégorie FR :
 
<pre>[[Category:FR|HSQLDB]]</pre>
 
Aujourd'hui, beaucoup de pages sont encore non référencées car sinon cette catégorie serait beaucoup plus étoffée... ;-)
 
}}
 
Reprenons notre page FR du début et assignons lui une autre catégorie, par exemple [[:Category:Documentation|Documentation]] : <pre>[[Category:Documentation]]</pre> Le bandeau en bas de page contient bien maintenant les deux catégories.
 
 
Toutefois, cette catégorie Documentation n'étant pas dédiée qu'aux francophones, notre page sera donc également visible de nos amis anglo-saxons. Selon la teneur et la portée du document, c'est bienvenue ou peu souhaitable. C'est pour cela qu'il existe une catégorie [[:Category:FR/Documentation|FR/Documentation]]
 
{{Documentation/Note|
 
# En fait c'est actuellement [[:Category:Documentation/FR|Documentation/FR]], mais je pense vraiment qu'il serait bon d'uniformiser l'entrée des trois caractères "/FR" systématiquement immédiatement à suivre l'adresse #1 : [[Main_Page|http://wiki.services.openoffice.org/wiki]], de façon que toutes les pages françaises de portée francophone uniquement soient des sous-pages de notre accueil [[FR|http://wiki.services.openoffice.org/wiki/FR]]. Enfin au moins pour les pages à venir...
 
# Vous pouvez aussi n'afficher que les pages répondant aux deux catégories. Voir à ce propos les [[#Requ.C3.AAtes|requêtes]].
 
}}
 
 
==Exemples de catégories==
 
==Exemples de catégories==
{{Documentation/Note|
+
{{Note|
 
* En fait énormément de liens sont en rouge, car nous devrions en décider ensemble...  
 
* En fait énormément de liens sont en rouge, car nous devrions en décider ensemble...  
 
* Peut-être aurais-je du écrire '''Propositions de catégories'''
 
* Peut-être aurais-je du écrire '''Propositions de catégories'''
Line 174: Line 61:
  
 
==Requêtes==
 
==Requêtes==
Vous pouvez afficher des listes dynamiques de page où des catégories ont été affectées :
+
Contenu déplacé : [[FR/Wiki/Aide:Requete]]
 
+
Par exemple, entrez :
+
<pre>
+
<DPL>
+
  category=Documentation
+
  category=FR
+
</DPL>
+
</pre>
+
Pour obtenir la liste des pages contenant à la fois les catégories "Documentation" et "FR" :
+
<DPL>
+
  category=Documentation
+
  category=FR
+
</DPL>
+
  
 
'''Quelques listes ainsi générées à partir de catégories anglophones existantes :'''
 
'''Quelques listes ainsi générées à partir de catégories anglophones existantes :'''
Line 217: Line 91:
 
===How-Tos===
 
===How-Tos===
  
{|width=90% cellpadding=5 border=0 align=center cellspacing=0
+
Section déplacée : [[FR/Wiki/Structure:EN_How_Tos]]
 
+
|-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="text-align:center"|Presentations: "Documentation/How_Tos/Impress"
+
|style="background-color: #FFF"|
+
|style="text-align:center"|Installation: "Documentation/How_Tos/Installation"
+
 
+
|-valign=top
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Impress.png|50px]]</div>
+
<DPL>
+
category=Documentation/How_Tos/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/How_Tos/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/How_Tos/Writer"
+
|style="background-color: #FFF"|
+
|style="text-align:center"|Tableur: "Documentation/How_Tos/Calc"
+
 
+
|-valign=top
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Writer.png|50px]]</div>
+
<DPL>
+
category=Documentation/How_Tos/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/How_Tos/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/How_Tos/Database"
+
|style="background-color: #FFF"|
+
|style="text-align:center"|Dessin: Documentation/How_Tos/Draw"
+
 
+
|-valign=top
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Base.png|50px]]</div>
+
<DPL>
+
category=Documentation/How_Tos/Database
+
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/How_Tos/Draw
+
replaceintitle=/Documentation\/How Tos\//,
+
</DPL>
+
 
+
|-valign=top
+
 
+
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
+
|style="text-align:center"|Formules: "Documentation/How_Tos/Formula"
+
|style="background-color: #FFF"|
+
|style="text-align:center"|Macros et API: "Documentation/How_Tos/Macros"
+
 
+
|-valign=top
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Math.png|50px]]</div>
+
<DPL>
+
category=Documentation/How_Tos/Formula
+
replaceintitle=/Documentation\/How Tos\//,
+
</DPL>
+
|
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Macro.png|50px]]</div>
+
<DPL>
+
category=Documentation/How_Tos/Macros
+
replaceintitle=/Documentation\/How Tos\//,
+
</DPL>
+
 
+
|-valign=top
+
|{{Spacer|30}} || ||
+
|}
+
  
 
===FAQ===
 
===FAQ===
Si vous voyez une ligne commencer par "Category", considérez là comme un sous-dossier de pages...
+
Section déplacée : [[FR/Wiki/Structure:EN_FAQ]]
 
+
Vous pouvez également considérer  [http://wiki.services.openoffice.org/w/index.php?title=Special%3ACategoryTree&target=Documentation%2FFAQ&mode=all&dotree=voir+l%E2%80%99arborescence l'arborescence de Category:Documentation/FAQ depuis cette page]
+
 
+
{|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|20}} || ||
+
|-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/Databases"
+
|style="background-color: #FFF"|
+
|style="text-align:center"|Macros et API: "Documentation/FAQ/Macros"
+
 
+
|-valign=top
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Base.png|50px]]</div>
+
<DPL>
+
category=Documentation/FAQ/Databases
+
replaceintitle=/Documentation\/How Tos\//,
+
</DPL>
+
|
+
|style="border: 1px solid #CDDBF6"|
+
<div style="float:right; margin-top: -45px;">[[image:Macro.png|50px]]</div>
+
<DPL>
+
category=Documentation/FAQ/Macros
+
replaceintitle=/Documentation\/How Tos\//,
+
</DPL>
+
 
+
|-valign=top
+
 
+
|-style="font-size:120%; font-weight:bold; background-color: #CDDBF6;"
+
|style="text-align:center"|Formules: "Documentation/FAQ/Formula"
+
|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:Math.png|50px]]</div>
+
<DPL>
+
category=Documentation/FAQ/Formula
+
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
+
|{{Spacer|30}} || ||
+
|}
+
  
 
==L'existant==
 
==L'existant==
Line 437: Line 118:
 
| [[:Category:FR/Documentation|FR/Documentation]] || [[:Category:Documentation|Documentation]] || Le wiki est comme "vivant", ces catégories s'étoffent de jour en jour...
 
| [[:Category:FR/Documentation|FR/Documentation]] || [[:Category:Documentation|Documentation]] || Le wiki est comme "vivant", ces catégories s'étoffent de jour en jour...
 
|-
 
|-
| [[:Category:Documentation/FR|Documentation/FR]] || || Demande de suppression par le modèle [[Template:delete|<nowiki>{{Delete}}</nowiki>]]
+
| Category:Documentation/FR || || Demande de suppression par le modèle [[Template:delete|<nowiki>{{Delete}}</nowiki>]]
 
|-
 
|-
 
| Lien interwiki || [[:Category:Documentation/AdministrationGuide|Documentation/AdministrationGuide]] || Le document, en quatre langues, 15 pages par langue... regardez les quatre modèles...
 
| Lien interwiki || [[:Category:Documentation/AdministrationGuide|Documentation/AdministrationGuide]] || Le document, en quatre langues, 15 pages par langue... regardez les quatre modèles...
Line 496: Line 177:
 
Cette dernière option n'a pas été retenue. Ci dessous la traduction de [http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5437 ce message de Clayton] du 4 Mai 2009 :
 
Cette dernière option n'a pas été retenue. Ci dessous la traduction de [http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5437 ce message de Clayton] du 4 Mai 2009 :
  
{{Documentation/FR/Note|  
+
{{Note|  
 
Exemple : une page française de la FAQ dédiée à Writer :
 
Exemple : une page française de la FAQ dédiée à Writer :
 
# avec les quatre catégories [[:Category:FR|FR]], [[:Category:Documentation|Documentation]], [[:Category:FAQ|FAQ]] et [[:Category:Writer|Writer]]  
 
# avec les quatre catégories [[:Category:FR|FR]], [[:Category:Documentation|Documentation]], [[:Category:FAQ|FAQ]] et [[:Category:Writer|Writer]]  
Line 581: Line 262:
 
}}
 
}}
  
{{Documentation/FR/Note| (Le premier point est obsolète...)
+
{{Note| (Le premier point est obsolète...)
 
* Ces quinze catégories devraient permettre de classer simplement toute la documentation francophone, et incidemment la rendre facilement visible. Pour chaque page de documentation, deux catégories à apposer, une pour le format (Guide, How-To ou FAQ) et une pour le "module" concerné. Ou alors [[#Assignation_automatique_de_cat.C3.A9gories|créer des modèles pour automatiser et simplifier encore la procédure]]).
 
* Ces quinze catégories devraient permettre de classer simplement toute la documentation francophone, et incidemment la rendre facilement visible. Pour chaque page de documentation, deux catégories à apposer, une pour le format (Guide, How-To ou FAQ) et une pour le "module" concerné. Ou alors [[#Assignation_automatique_de_cat.C3.A9gories|créer des modèles pour automatiser et simplifier encore la procédure]]).
  
Line 590: Line 271:
  
 
==Renommer une catégorie==
 
==Renommer une catégorie==
Il n'est pas possible de renommer une catégorie puisqu'il n'y a pas d'onglet correspondant sur la page. Mais il est cependant très facile d'arriver au même résultat :
+
Déplacé ici : [[FR/Wiki/Aide:Categories/Renommer]]
# Créer la nouvelle catégorie [N] et relever le nombre de pages contenues dans l'ancienne catégorie [A].
+
# A partir de [A], visiter et éditer toutes les pages qui la peuple, en remplaçant [A] par [N].
+
# Vérifier que [N] contient bien le même nombre de pages que [A] au début de l'opération quand [A] est vide.
+
# Inscrire dans [A] la catégorie [N] maintenant utilisée, pour éviter le doute aux futurs éditeurs
+
{{Documentation/Note|
+
Un exemple d'une telle catégorie [A] pour un cas de figure similaire avec l'ancienne catégorie : [[:Category:Localisation]] ou [N] est Localization.
+
Dans le cas de de [[:Category:Documentation/FR]], il y aurait... 9 pages à éditer... plus [[:Category:MainIndex]]... si j'ai bien compris le fonctionnement... je veux bien m'en charger :-)
+
}}
+
  
 
=Modèles=
 
=Modèles=
S'il est très facile par la relation parent-enfant de faire se "mouvoir" des catégories proprement, il n'en va pas du tout de même avec les modèles. En effet, un modèle renommé provoquera une erreur dans toutes les pages ou il a été employé, mais il n'y aura d'autre moyen de le savoir que de visiter chacune de ces pages (à moins que ne soit incluse une catégorie dans le modèle, cf plus bas les modèles EnAttente et EnCours), et corriger manuellement l'erreur... attention à la casse !
 
{{Documentation/FR/Note|
 
Il est sans doute possible d'assigner temporairement une catégorie spéciale à un modèle qu'on voudrait renommer, par exemple [[:Category:Temp]] ou [[:Category:FR/Temp]], en vérifiant préalablement qu'elle soit "vide" (c.a.d. qu'aucune autre page n'y fasse référence), pour pouvoir afficher simplement (et modifier) toutes les pages qui utilisent ce modèle... Cette opération peut malgré tout s'avérer longue et fastidieuse, et le bénéfice gagné insignifiant... (pour l'exemple du modèle)
 
}}
 
Ci dessous la liste existante reprise et actualisée de la page [[FR/Documentation/TableauBord/Organisation]]...
 
  
'''Pages anglophones'''
+
Contenu déplacé. Voir [[FR/Wiki/Aide:Modeles]]
* Page d'aide pour les modèles : [[Help:Templates]]
+
* Catégorie listant les modèles existants : [[:Category:Wiki_Templates]]
+
  
==Modèles existants (Templates) ==
+
==Assignation automatique de catégories==
A noter que le mode d'emploi est généralement inclus dans le modèle lui-même (colonne de gauche).
+
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
+
|-
+
!Nom du modèle!!Syntaxe!!Résultat
+
|-
+
|[[Template:OOo]]||'''<nowiki>{{OOo}}</nowiki>'''<br>Même effet que le modèle ci-dessous || {{OOo}}
+
|-
+
|[[Template:Documentation/PRODUCTNAME]]||'''<nowiki>{{Documentation/PRODUCTNAME}}</nowiki>'''<br>Même effet que le modèle ci-dessus || {{Documentation/PRODUCTNAME}}
+
|-
+
|[[Template:Documentation/Abstract]]||'''<nowiki>{{Documentation/Abstract|Votre note}}</nowiki>'''||{{Documentation/Abstract|Votre note}}<small>[Note : quel est l'intérêt de ce modèle ?] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>
+
|--
+
|[[Template:Documentation/Banner]]
+
|'''<nowiki>{{Documentation/Banner}}</nowiki>'''
+
Met la bannière "doc OOo" en haut à droite de la page<br><small>[Note : je ne pense pas qu'il soit possible d'ajouter un texte, il ne s'agit pas d'une bannière] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>
+
|[[Image:Docbanner.png]]
+
|-
+
|[[Template:Documentation/FR/PremierJet]]||'''<nowiki>{{Documentation/FR/PremierJet}}</nowiki>'''<br>Note : vous ne pouvez pas ajouter de commentaires... || {{Documentation/FR/PremierJet}}
+
|-
+
|[[Template:Documentation/FR/AideDemandee]]||'''<nowiki>{{Documentation/FR/AideDemandee|Vérifiez le texte et l'orthographe}}</nowiki>'''<br><small>[Note : modèle modifié pour autoriser l'ajout d'un commentaire] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>||{{Documentation/FR/AideDemandee|Vérifiez le texte et l'orthographe}}
+
|-
+
|[[Template:Documentation/FR/EnCours]]||'''<nowiki>{{Documentation/FR/EnCours|Mon commentaire<br>~~~~}}</nowiki>'''<br>Indique que le document est réservé, pour rédaction, relecture, etc.<br>Ce modèle est utilisé, en particulier, lorsque l'édition de la page nécessite de travailler hors connexion ou plusieurs sessions.<br>Vous ajouterez <nowiki>~~~~</nowiki> pour faire apparaitre votre nom et la date ; vous pouvez éventuellement ajouter un commentaire. ||{{Documentation/FR/EnCours|Mon commentaire<br>[[User:Jean Dupond|Jean Dupond]] 08:14, 9 May 2009 (UTC)}}
+
|-
+
|[[Template:Documentation/FR/EnAttente]]||'''<nowiki>{{Documentation/FR/EnAttente|Section macro en attente de relecture.}}</nowiki>'''<br>Demandez une relecture... <br>Vous pouvez ajouter un commentaire dans ce cadre...|| {{Documentation/FR/EnAttente|Section macro en attente de relecture.}}
+
|-
+
|[[Template:Documentation/FR/PertinenceVerifiee]]||'''<nowiki>{{Documentation/FR/PertinenceVerifiee|~~~~ }}</nowiki>'''<br>Retour du relecteur. Ajoutez <nowiki>~~~~</nowiki>&nbsp;: votre nom et la date de la vérification seront ajoutés (un lien direct sur votre page sera également créé)... ||{{Documentation/FR/PertinenceVerifiee|Jean Dupond 08:25, 9 May 2009 (UTC)}}
+
|--valign=top
+
|[[Template:Documentation/FR/PlusValable]]
+
|'''<nowiki>{{Documentation/FR/PlusValable}}</nowiki>'''<br>Cet article n'est plus à jour ou ne correspond plus au comportement de la version actuelle.
+
|{{Documentation/FR/PlusValable}}
+
|-
+
|[[Template:Documentation/FR/Attention]]||'''<nowiki>{{Documentation/FR/Attention|Faites très attention à ce qui est écrit ici.}}</nowiki>'''<br>Série 1||{{Documentation/FR/Attention|Faites très attention à ce qui est écrit ici.}}
+
|-
+
|[[Template:Documentation/FR/Note]]||'''<nowiki>{{Documentation/FR/Note|Information notable}}</nowiki>'''<br>Série 1 || {{Documentation/FR/Note|Information notable}}
+
|-
+
|[[Template:Documentation/FR/Astuce]]||'''<nowiki>{{Documentation/FR/Astuce|Essayez cette astuce.}}</nowiki>'''<br>Série 1 ||{{Documentation/FR/Astuce|Essayez cette astuce.}}
+
|-
+
|[[Template:Attention]]||'''<nowiki>{{Attention|Faites très attention à ce qui est écrit ici.}}</nowiki>'''<br>Série 2||{{Attention|Faites très attention à ce qui est écrit ici.}}
+
|-
+
|[[Template:Information]]||'''<nowiki>{{Information|Information notable}}</nowiki>'''<br>Série 2||{{Information|Information notable}}
+
|-
+
|[[Template:Tip]]||'''<nowiki>{{Tip|Essayez cette astuce.}}</nowiki>'''<br>Série 2||{{Tip|Essayez cette astuce.}}
+
|-valign=top
+
|[[Template:Documentation/hbar]]
+
|Utilisé pour tracer des barres horizontales pour réaliser des graphiques simplistes
+
<tt><nowiki>Blabla1{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki><br>
+
<nowiki>Blabla2{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki><br>
+
<nowiki>Blabla3{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki><br>
+
<nowiki>Blabla5{{Documentation/hbar|width=150}}</nowiki></tt>
+
|
+
Blabla1{{Documentation/hbar|width=100|bg=#3333FF}}
+
Blabla2{{Documentation/hbar|width=57|bg=#33FF33}}
+
Blabla3{{Documentation/hbar|width=112|bg=#FF3333}}
+
Blabla4{{Documentation/hbar|width=150}}
+
  
|-
 
|[[Template:Documentation/Hook]]||'''<nowiki>{{Documentation/Hook}}</nowiki>''' || {{Documentation/Hook|Essai}}
 
|-
 
|[[Template:Documentation/Imported]]||'''<nowiki>{{Documentation/Imported|author=Jean Dupont|contributors=Pierre Dubois, Paul Durand}}</nowiki>'''||{{Documentation/Imported|author=Jean Dupont|contributors=Pierre Dubois, Paul Durand}}
 
|-
 
|[[Template:Documentation/LastEdited]]|| || {{Documentation/LastEdited|Only works after update of mw engine to > 1.8}}
 
|-
 
|[[Template:Documentation/Linux]]||'''<nowiki>{{Documentation/Linux|Informations spécifiques aux systèmes UNIX}}</nowiki>''' || {{Documentation/Linux|Informations spécifiques aux systèmes UNIX}}
 
|-
 
|[[Template:Documentation/Windows]]||'''<nowiki>{{Documentation/Windows|Informations spécifiques aux systèmes Microsoft Windows}}</nowiki>'''<br> ||{{Documentation/Windows|Informations spécifiques aux systèmes Microsoft Windows}}
 
|-
 
|[[Template:Documentation/MasterTOC]]||'''<nowiki>{{Documentation/MasterTOC}}</nowiki>''' <br>Vous devriez préférer le modèle francisé ci-dessous...||{{Documentation/MasterTOC}}
 
|-
 
|[[Template:FR/Documentation/MasterTOC]]
 
| <pre>{{FR/Documentation/MasterTOC
 
|ShowPrevPage=none
 
|ShowNextPage=block
 
|NextPage=The Next Page
 
|bookid=1234'''
 
|booktitle=[[Mon guide]]
 
|ShowParttitle=block
 
|parttitle=[[Première partie]]
 
|ShowPrevPart=none
 
|ShowNextPart=block
 
|NextPart=The Second Part
 
|toccontent=* Chapitre
 
* Chapitre
 
* Chapitre
 
}}</pre>
 
|{{FR/Documentation/MasterTOC
 
|ShowPrevPage=none
 
|ShowNextPage=block
 
|NextPage=The Next Page
 
|bookid=1234'''
 
|booktitle=[[Mon guide]]
 
|ShowParttitle=block
 
|parttitle=[[Première partie]]
 
|ShowPrevPart=none
 
|ShowNextPart=block
 
|NextPart=The Second Part
 
|toccontent=* Chapitre
 
* Chapitre
 
* Chapitre
 
}}
 
|-
 
|[[Template:Documentation/OOo]]||'''<nowiki>{{Documentation/OOo}}Lien vers...</nowiki>''' || {{Documentation/OOo}}Lien vers le document (Merci d'indiquer la taille du fichier pour les possesseurs d'une connexion bas-débit).
 
|-
 
|[[Template:Documentation/PDF]]||'''<nowiki>{{Documentation/PDF}}Lien vers...</nowiki>''' || {{Documentation/PDF}}Lien vers le fichier (de même que précédemment, indiquez sa taille).
 
|-
 
|[[Template:FR/Navbox]] || '''<nowiki>{{FR/Navbox}}</nowiki>''' <br>Ce modèle occupe normalement une plus grande largeur... <br>L'occasion de noter - avec ce tableau - leur adaptabilité... || {{FR/Navbox}}
 
|}
 
 
==Assignation automatique de catégories==
 
 
Dans l'optique ou nous déciderions d'[[#Arbre_des_cat.C3.A9gories|assigner une série de deux]] ou trois catégories à toutes les pages existantes pour pouvoir ensuite toutes les répertorier lisiblement et automatiquement, nous pourrions simplifier et rendre plus polyvalent encore ce processus d'associations par le biais de modèles.
 
Dans l'optique ou nous déciderions d'[[#Arbre_des_cat.C3.A9gories|assigner une série de deux]] ou trois catégories à toutes les pages existantes pour pouvoir ensuite toutes les répertorier lisiblement et automatiquement, nous pourrions simplifier et rendre plus polyvalent encore ce processus d'associations par le biais de modèles.
 
{{Documentation/FR/Astuce|'''Utilisons l'acronymie''' avec les trois lettres F, G, H en début du nom de modèle...
 
{{Documentation/FR/Astuce|'''Utilisons l'acronymie''' avec les trois lettres F, G, H en début du nom de modèle...

Latest revision as of 15:00, 3 July 2018

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.
  • Un guide de l'éditeur est démarré ici : FR/Wiki/Aide:Editeur ;-)

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.


Documentation note.png

J'aimerais un groupe de pages unies dans un seul but. J'en vois aujourd'hui trois, ou quatre, qui, une fois complétées, pourraient être des sous-pages de FR/Documentation/TableauBord :

  1. FR/Documentation/TableauBord/Organisation. Cette page doit-être mise, et maintenue à jour.
  2. FR/Documentation/Dashboard/Wiki_Editing_Policy qui n'est utile que considérée comme la traduction "rigoureuse", mais commentée, de la page anglaise, et donc inexacte si on la transpose au modèle français, qui est lui à mettre à jour à l'adresse #1 de cette note. Elle est je trouve cependant justifiée pour les utilisateurs bilingues qui pourraient sinon ressentir parfois des contre-sens. Pour preuve en lire l'onglet Discussion ou le bas de page et le comparer à la suite du présent document, qui explique le contraire.
  3. Éditer simplement, plutôt destiné au b-a-ba des techniques du code Wiki, munie de liens pour approfondir chaque thème abordé.
  4. Cette présente page... doit soit être créée soit fusionner avec la première.
  • Pour la dynamique du projet :-)

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

Contenu déplacé ici : FR/Wiki/Aide:Nouvelle_page

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 initialement été conçu par les développeurs pour eux-même. Veuillez vous reporter à l'adresse #1 pour plus de détails.

Voir également cette page française...

Documentation

Section déplacée : FR/Wiki/Structure:Documentation

Des pages pour des liens externes

Même page que ci-dessus

Catégories

Section transférée sur cette page : FR/Wiki/Aide:Categories

Exemples de catégories

Documentation note.png
  • En fait énormément de liens sont en rouge, car nous devrions en décider ensemble...
  • Peut-être aurais-je du écrire Propositions de catégories
  • Personnellement je ne suis pas dérangé (dans ce qui suit) par l'abréviation de "Documentation" en "Doc" - toujours à condition que ce soit univoque, je demande ici l'avis des experts. "Doc" est peut-être un mot réservé pour la branche "Dev", signifiant notamment le format natif de la suite concurrente - L'avantage est un gain de place, donc de lisibilité, dans la barre d'adresse du navigateur, car les sous-pages et titres de sections rallongent souvent considérablement l'adresse complète couramment utilisée... (même si on évoque les noms de page ici alors que nous sommes dans la section Catégories, faire court dans les adresses est objectivement un bon réflexe)
  • Dans la liste ci dessous il nous faut opter pour l'un des trois cas de figures. Il sera dès lors le même partout et cette liste nettoyée des deux autres options devenues inutiles.
Category:MainIndex
La catégorie regroupant toutes les autres. Dans l'esprit francophone, nous pourrions aussi créer Category:FR/Categories et assigner cette dernière uniquement, à MainIndex. Ou bien l'assigner comme toutes les autres à la catégorie suivante :
Category:FR
Les pages du Wiki francophone d'Apache OpenOffice. C'est notre catégorie principale.
Pour l'instant Category:Documentation/FR, mais Category:FR/Documentation ou même Category:FR/Doc conviendrait mieux 
La catégorie pour regrouper toute la documentation francophone. Elle même contenant plusieurs catégories, ci dessous proposées :
Category:FR/FAQ ou Category:FR/Doc/FAQ ou Category:FR/Documentation/FAQ
La FAQ francophone. Contenant des sous-catégories, par exemple:
Category:FR/FAQ/Writer ou Category:FR/Doc/FAQ/Writer ou Category:FR/Documentation/FAQ/Writer
FAQ francophone de Writer
Category:FR/How_Tos ou Category:FR/Doc/How_Tos ou Category:FR/Documentation/How_Tos
La catégorie principale de tous les mini-guides. Exemple pour Draw :
Category:FR/How_Tos/Draw ou Category:FR/Doc/How_Tos/Draw ou Category:FR/Documentation/How_Tos/Draw
Deux excellents exemples en français, et il est toujours possible de créer ou d'utiliser une page pointant sur les autres documents accessibles par téléchargement.


Autres catégories possibles :

Category:FR/Doc/Calc ou Category:FR/Documentation/Calc
Pour regrouper toute la documentation francophone sur Calc. Qu'elle soit de type Guide, How-To ou FAQ.
Category:FR/Modele
Pour référencer tous les modèles spécifiquement francophones...

Catégories existantes :

Category:Documentation/BASIC_Guide
Ne sera pas renommée pour préserver les liens interwikis.
Category:Documentation/AdministrationGuide
Ne sera pas renommée pour préserver les liens interwikis.

Requêtes

Contenu déplacé : FR/Wiki/Aide:Requete

Quelques listes ainsi générées à partir de catégories anglophones existantes :

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

How-Tos

Section déplacée : FR/Wiki/Structure:EN_How_Tos

FAQ

Section déplacée : FR/Wiki/Structure:EN_FAQ

L'existant

Les pages sans catégories n'apparaîtront pas ici...

A partir de cette page spéciale je tente de répertorier (manuellement, c'est un peu fastidieux) les catégories appartenant à la branche FR en colonne 1, les catégories EN contenant des pages FR en colonne 2 - c'est l'ordre alphabétique par défaut de ce tableau. La colonne 3 est le nombre de pages FR dans cette catégorie, et un commentaire. J'oublie fatalement quelque chose...

Catégorie FR Category EN Pages / commentaire
Base_Documentation 3, ou 4 ? Cette page est en fait un instantané (?) l'original de la FAQ actuelle...
Basic:Tutorials Extensions_development_basic_fr (4 pages (+DE) à créer modèle pour lien interwiki)
Calc/Fonctions/FR 339 pages concernées, et ça continue... je n'ai pas vu de catégorie anglophone pour les fonctions de Calc mais elle devrait sans doute avoir des sous-catégories (financières, mathématiques, etc.) Ainsi la (super) catégorie constitue l'ordre alphabétique, et les sous-catégories la liste des fonctions classées par... catégories ! (en ordre alphabétique à l'intérieur). Chaque fonction devra pour cela inclure deux catégories : Calc/Fonctions/FR (puisqu'elle existe ainsi), mais pour l'autre je proposerais plutôt une nomenclature commençant par FR, soit par exemple FR/Calc/Fonctions/Financieres, et ainsi de suite
Collections Étonnant: MediaWiki:Collections/HsqldbUserGuidefr (que je ne peux modifier !)
Database 2, ou 3 ;-) pages faisant également partie de Base_Documentation
FR/Documentation Documentation Le wiki est comme "vivant", ces catégories s'étoffent de jour en jour...
Category:Documentation/FR Demande de suppression par le modèle {{Delete}}
Lien interwiki Documentation/AdministrationGuide Le document, en quatre langues, 15 pages par langue... regardez les quatre modèles...
Lien interwiki Documentation/BASIC_Guide Cinq langues de celui-ci...
Documentation/FR/EnCours Documentation/BeingEdited
Documentation/Candidate FR/Documentation/Base/Rapports/Fonctions
(Traduction à faire) Documentation/Developer's Guide Il serait plaisant d'avoir ce guide également en français, évidemment... 21 sous-catégories et quelques centaines de pages...
Documentation/HelpNeeded La catégorie anglophone n'est plus utilisée
Documentation/FR/EnAttente Documentation/NeedsRework Politique d'édition du Wiki
Education Deux pages d'accueil francophones.
Extensions Quatre pages.
FR NLC Racine logique des catégories fancophones.
Category:FR/Calendrier 22 modèles pour le calendrier.
Fr.openoffice.org NLC Fait peut-être double emploi avec FR.
Français NLC Deux pages...
Guidelines Politique d'édition du Wiki
HSQLDB Guide (à déplacer)
MainIndex Category:Documentation/FR
Marketing Trois pages.
Localisation NLC
PDL License Je n'ai pas tenté de compter...
Project Deux pages...
Category:Quality_Assurance FAQ MS Access et Base
Templates Templates/website/guide_fr
User FAQ Deux pages.

Arbre des catégories

Voir aussi l'arborescence des catégories.

Ci-dessous un extrait de ce que l'on pourrait définir en français, et qui pourrait donner par des listes DPL (Dynamic Page List) une visibilité accrue et automatique de la documentation existante.

Une autre solution serait de partager les catégories internationalement: Une page référencée dans les quatre catégories FR, Documentation, Writer et FAQ ne pourrait être qu'une page de la FAQ française de documentation dédiée à Writer. Cependant si cela pouvait faciliter la tâche des localisations, il n'en irait pas de même pour les pages anglophones, de loin les plus nombreuses, qu'il faudrait remanier, sans doute en profondeur... ou déplacer en insérant "EN/" dans toutes les pages concernées... Que de redirections en vue...)

Cette dernière option n'a pas été retenue. Ci dessous la traduction de ce message de Clayton du 4 Mai 2009 :

Documentation note.png

Exemple : une page française de la FAQ dédiée à Writer :

  1. avec les quatre catégories FR, Documentation, FAQ et Writer
  2. avec une seule catégorie FR/Documentation/FAQ/Writer

Serait-il meilleur de partager les catégories ou chaque langage doit-il posséder les siennes ?

Tu peux utiliser les catégories et noms de catégories que tu souhaites pour les pages traduites (l'exception étant dans certains cas, avec les caractères multibyte (ex. Japonais, chinois) dans les noms de catégories qui ont posé des problèmes par le passé).

Voir:

http://wiki.services.openoffice.org/wiki/FR/Documentation/Dashboard/Wiki_Editing_Policy#Utilisation_des_cat.C3.A9gories

pour un peu plus d'informations sur les catégories.

Les catégories sont employées pour grouper les pages communes du wiki. Il est sensé de regrouper les pages localisées sous leurs propres catégories.

Si les documents sur lesquels tu travailles sont publiés sous licence PDL (comme la majorité de la documentation anglophone) tu peux ajouter le modèle {{PDL1}} à tes pages. Il ajoutera le texte de la licence PDL en bas de page et inclura cette dernière dans la catégorie PDL.

Quelles que soient les catégories que tu décides de définir, il est préférable d'utiliser au moins une catégorie qui soit unique à chaque jeu de documents. Le (robot) Wikibot utilisé pour la maintenance et les changements de masse aux pages wiki peut être paramétré pour agir sur une catégorie spécifique. Si (un jeu de) des documents sont regroupés par au moins une catégorie unique, toute future maintenance sur ces documents devient plus aisée.

Clayton Cornell

Il est donc préférable d'avoir de multiples catégories plutôt que de les recouper, comme des mots-clés combinables entre eux.

J'ai choisi de marquer "/Documentation" pour toutes ces catégories, car si c'est plus long à éditer c'est plus robuste (sans surprises) pour l'intégration.

Par exemple j'ai noté Category:FR/Documentation/FAQ au lieu de Category:FR/FAQ ou Category:FR/Doc/FAQ pour regrouper tous les documents de la FAQ francophone.

Parent Catégorie - Descriptif Enfants
Category:MainIndex Category:FR Category:FR/Documentation
Y a-t-il besoin de Category:FR/Développement, car Category:Development est peut-être plus judicieux...
Category:FR Category:FR/Documentation
Existe actuellement comme Category:Documentation/FR. Devrait regrouper l'ensemble de la documentation française au moyen de "sous"-catégories...
Category:FR/Documentation/FAQ
Category:FR/Documentation/How_Tos
Category:FR/Documentation/Guide
Category:FR Category:FR/Writer
Parce que le Wiki FR n'héberge pas que de la documentation. Une requête DPL simple permettra l'affichage de toute documentation francophone afférente à Writer :-)
En option, une autre table des matières serait disponible, mais gourmande en catégories. Créer Category:FR/Section, puis Category:FR/Section/Puces_Numeros, Category:FR/Section/Styles, etc.
Category:FR/Documentation Category:FR/Documentation/FAQ
Toute la FAQ francophone.
Appliquer cette catégorie et aussi Category:FR/Writer pour référencer une page appartenant à la FAQ de Writer.

Cette liste était de seulement quinze entrées, car il était prévu des recoupements entre les catégories... Il n'y en aura pas à ce niveau de tri car la maintenance s'en trouve simplifiée...

Récapitulatif

Tip.png

Liste numérotée: Récapitulatif

  1. Category:FR contient toutes les autres. Sous catégorie de NLC
  2. Category:FR/Documentation (existait comme Category:Documentation/FR). Sous-catégorie de FR et de Documentation
    1. Category:FR/Documentation/Base
    2. Category:FR/Documentation/Calc
    3. Category:FR/Documentation/Draw
    4. Category:FR/Documentation/Generale
    5. Category:FR/Documentation/Impress
    6. Category:FR/Documentation/Math
    7. Category:FR/Documentation/Programmation avec, par exemple des sous-catégories comme suit :
      1. Category:FR/Basic
        1. Category:FR/Basic/Base
        2. Category:FR/Basic/Calc
      2. Category:FR/Java
      3. Category:FR/C++ ou Category:FR/Cpp. Voir les pages de Category:FR/Cpp Guide
      4. Category:FR/Csharp
    8. Category:FR/Documentation/Writer
  3. Category:FR/Documentation/Guide (optionnel : Pourrait regrouper toutes les pages d'accueil des manuels, mais cette liste serait également facile à maintenir manuellement). Sous-catégorie de FR/Documentation.
  4. Category:FR/Documentation/How_Tos. Sous-catégorie de FR/Documentation. Super-catégorie des six suivantes :
    1. Category:FR/Documentation/How_Tos/Base
    2. Category:FR/Documentation/How_Tos/Calc
    3. Category:FR/Documentation/How_Tos/Draw
    4. Category:FR/Documentation/How_Tos/Impress
    5. Category:FR/Documentation/How_Tos/Math
    6. Category:FR/Documentation/How_Tos/Writer
  5. Category:FR/Documentation/FAQ. Sous-catégorie de FR/Documentation. Super-catégorie des huit suivantes :
    1. Category:FR/Documentation/FAQ/Base
    2. Category:FR/Documentation/FAQ/Calc
    3. Category:FR/Documentation/FAQ/Draw
    4. Category:FR/Documentation/FAQ/Generale
    5. Category:FR/Documentation/FAQ/Impress
    6. Category:FR/Documentation/FAQ/Installation
    7. Category:FR/Documentation/FAQ/Math
    8. Category:FR/Documentation/FAQ/Writer
  6. Autres
    1. Category:FR/Aide
    2. Category:FR/TableauBord, dont cette page fait partie. Sous-catégorie de FR/Documentation.
    3. Category:FR/Archives. Improprement utilisée au moment de sa création...
    4. Category:FR/Corbeille pourrait présenter une méthode préalable au modèle Template:Delete.


Documentation note.png (Le premier point est obsolète...)
  • Ces quinze catégories devraient permettre de classer simplement toute la documentation francophone, et incidemment la rendre facilement visible. Pour chaque page de documentation, deux catégories à apposer, une pour le format (Guide, How-To ou FAQ) et une pour le "module" concerné. Ou alors créer des modèles pour automatiser et simplifier encore la procédure).
  • On pourrait également recréer une autre table des matières, plus conventionnelle, par l'utilisation de catégories "Section" comme présenté en exemple dans le tableau ci-dessus. Mais il faudrait créer nombre de sous-catégories (bien pensées) de Category:FR/Section, et apposer à chaque page Wiki une troisième catégorie.
  • L'apposition des catégories suffirait alors à faire apparaitre la page dans la section souhaitée, sans plus avoir à maintenir manuellement les différentes tables des matières. Les pages redirigées laisseraient toutes apparaitre la nouvelle adresse puisque les listes sont dynamiques, et l'on ne verrait plus dans ce cas en haut de page "Redirigée depuis...", et la barre d'adresses du navigateur n'afficherait plus l'ancien chemin (souvent plus long), otant le doute à l'éditeur débutant... :-D

Renommer une catégorie

Déplacé ici : FR/Wiki/Aide:Categories/Renommer

Modèles

Contenu déplacé. Voir FR/Wiki/Aide:Modeles

Assignation automatique de catégories

Dans l'optique ou nous déciderions d'assigner une série de deux ou trois catégories à toutes les pages existantes pour pouvoir ensuite toutes les répertorier lisiblement et automatiquement, nous pourrions simplifier et rendre plus polyvalent encore ce processus d'associations par le biais de modèles.

Tip.png Utilisons l'acronymie avec les trois lettres F, G, H en début du nom de modèle...

Signifiant respectivement FAQ, Guide et How-to.

(A priori surtout utile pour la FAQ, car dans le cas des guides, on peut peut-être se contenter de catégoriser la première page seulement.)

Il serait possible, par exemple de créer un modèle Template:FR/FWriter qui appliquerait automatiquement les deux catégories Category:FR/Documentation/FAQ et Category:FR/Documentation/Writer à la page...

Par exemple encore, cette page FR/Documentation/Base/SUN_Report_Builder, ainsi que FR/Documentation/Base/Rapports/Fonctions qui lui est reliée, pourraient être étiquetées ("taguées") facilement par la "commande" : {{FR/HBase|Rapport}}. Elles apparaîtraient ainsi dans la section How-Tos pour Base où elles seront classées à la lettre R, et même plus précisément à "Rapport", feront automatiquement partie de la documentation française, etc.


Architecture comparée

C'est peut-être un peu dur (entendez cruel) de vouloir comparer le site anglophone (principal) et le site français (une branche de l'arbre). Cependant certaines choses sont comparables et cela aide à se faire une idée...

Anglophone Francophone
http://wiki.services.openoffice.org/wiki Accueil anglophone, et également l'adresse de "base". Aussi appelée "Main_Page". FR Accueil francophone. Tous les documents en français devraient apparaitre sous cette branche.
Development Se reporter à l'adresse ci-contre, ou compléter cette cellule...
Documentation FR/Documentation
Documentation/FAQ FR/FAQ (tiens, ce n'est pas FR/Documentation/FAQ ? )
Documentation/How_Tos FR/Documentation/How_Tos
Pour les guides, c'est un peu plus compliqué mais toujours à la racine de Documentation. Par exemple, les guides v3 ou les guides v2... A la racine de FR/Documentation. Voir dans cette page la section Guides
Il y a également la page Documentation/Reference qui contient certains manuels existants en FR Par exemple, FR/Documentation/Expressions_Regulieres_dans_Writer

Ou bien FR/Documentation/Calc/Fonctions_listees_par_categories

Documentation/Tutorials Nous pourrions créer FR/Documentation/Tutoriels car effectivement il y a des documents téléchargeables, des liens externes, par exemple le site de christianwtd, les tutoriels du forum, ou d'autres perles qui pourraient bien avoir un petit article, ou au moins une ligne dans une liste qui... montre la documentation ! Tout n'est pas si mouvant et cette page devrait être consistante également...
Other interesting pages for this purpose... Autres pages intéressantes dans l'esprit de celle ci...
Documentation/Dashboard Tableau de bord du projet visible depuis FR/Documentation. :-/
Documentation/Dashboard/Wiki_Editing_Policy
  1. FR/Documentation/TableauBord/Organisation. Cette page doit-être mise, et maintenue à jour.
  2. FR/Documentation/Dashboard/Wiki_Editing_Policy qui n'est utile que considérée comme la traduction "rigoureuse", mais commentée, de la page anglaise, et donc inexacte si on la transpose au modèle français, qui est lui à mettre à jour à l'adresse #1 de cette cellule. Elle est je trouve cependant justifiée pour les utilisateurs bilingues qui pourraient sinon ressentir parfois des contre-sens. Pour preuve en lire l'onglet Discussion ou Localisation du contenu et le comparer à ce présent document, qui explique aussi pourquoi le contraire est vrai.
Wiki/Guidelines A peine comparable : FR/FAQ/Wiki (à mettre à jour)
FR/Documentation/TableauBord/Structure_Wiki_FR conviendrait-elle pour cette présente page ?
De même [[FR/Documentation/TableauBord/Editer_Simplement pour cette ébauche, qui aura besoin d'être épurée, réduite à un strict minimum, tout en restant attractif pour qui veut écrire... maintenant. A moins que l'on transfert en déplacant dans l'onglet Discussion le contenu actuel de FR/Wiki. (Tiens, il faudrait déplacer Bibliographie ?)
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools