Difference between revisions of "FR/Documentation/Dashboard/Wiki Editing Policy"

From Apache OpenOffice Wiki
Jump to: navigation, search
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Documentation/Banner}}
+
{{DocBanner}}
{{Documentation/DraftPage}}
+
 
 
{{DISPLAYTITLE:Politique d'édition du wiki}}
 
{{DISPLAYTITLE:Politique d'édition du wiki}}
 
[[en:Documentation/Dashboard/Wiki_Editing_Policy]]
 
[[en:Documentation/Dashboard/Wiki_Editing_Policy]]
Line 127: Line 127:
 
=Création de nouvelles pages=
 
=Création de nouvelles pages=
  
{{Documentation/Caution | Avant de créer une page assurez vous qu'il n'y ait pas déjà une page existante avec un sujet similaire.}}
+
{{Warn | Avant de créer une page assurez vous qu'il n'y ait pas déjà une page existante avec un sujet similaire.}}
  
 
* Si la nouvelle page peut être une sous-page d'une page existante allez simplement sur la page existante et créez un lien vers la nouvelle page. Après publication de la page existante modifiée vous pouvez cliquer sur le lien et commencer à écrire votre nouvelle page.
 
* Si la nouvelle page peut être une sous-page d'une page existante allez simplement sur la page existante et créez un lien vers la nouvelle page. Après publication de la page existante modifiée vous pouvez cliquer sur le lien et commencer à écrire votre nouvelle page.
Line 133: Line 133:
 
* Si vous voulez vraiment créer une nouvelle page pour le projet Documentation, vous pouvez utiliser l'URL du wiki pour en créer une. Vous devez observer l'arborescence du wiki quand vous créez une nouvelle page de cette façon. L'URL d'une page wiki est alors quelque chose comme:<br>  <tt><nowiki> http://wiki.services.openoffice.org/wiki/fr/documentation/</nowiki>''PageName''</tt>  
 
* Si vous voulez vraiment créer une nouvelle page pour le projet Documentation, vous pouvez utiliser l'URL du wiki pour en créer une. Vous devez observer l'arborescence du wiki quand vous créez une nouvelle page de cette façon. L'URL d'une page wiki est alors quelque chose comme:<br>  <tt><nowiki> http://wiki.services.openoffice.org/wiki/fr/documentation/</nowiki>''PageName''</tt>  
  
{{Documentation/Note | L'approche par URL est seulement pratique si vous liez cette page plus tard à d'autres. Autrement cette page restera cachée dans le Wiki.}}
+
{{Note | L'approche par URL est seulement pratique si vous liez cette page plus tard à d'autres. Autrement cette page restera cachée dans le Wiki.}}
  
 
Pour plus d'information sur les nouvelles pages, reportez vous à [http://www.mediawiki.org/wiki/Help:Starting_a_new_page/fr Mediawiki help about new pages]
 
Pour plus d'information sur les nouvelles pages, reportez vous à [http://www.mediawiki.org/wiki/Help:Starting_a_new_page/fr Mediawiki help about new pages]
Line 146: Line 146:
 
# Choisissez un nom de catégorie sensé, et appliquez le en ajoutant <nowiki>[[Category:</nowiki>''Category Name''<nowiki>]]</nowiki> à la fin de la page.
 
# Choisissez un nom de catégorie sensé, et appliquez le en ajoutant <nowiki>[[Category:</nowiki>''Category Name''<nowiki>]]</nowiki> à la fin de la page.
  
{{Documentation/Caution | Ne créez pas de catégories dupliquées pour le même sujet. Chaque catégorie doit être unique. Autrement il deviendra difficile d'utiliser les catégories pour chercher dans le wiki.}}
+
{{Warn | Ne créez pas de catégories dupliquées pour le même sujet. Chaque catégorie doit être unique. Autrement il deviendra difficile d'utiliser les catégories pour chercher dans le wiki.}}
  
 
Reportez vous à [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] si vous voulez en savoir plus sur les catégories Wiki.
 
Reportez vous à [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] si vous voulez en savoir plus sur les catégories Wiki.
Line 186: Line 186:
 
!Template Name!!Usage!!Example
 
!Template Name!!Usage!!Example
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Abstract]]
+
|[[Template:DocBanner]]
|Takes a short abstract of the chapter content of guides. Add to the top of guides.
+
<tt><nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki></tt>
+
|See, for example, [[Documentation/Administration_Guide/Customizing|this Administration Guide Chapter]]
+
|-valign=top
+
|[[Template:Documentation/Banner]]
+
 
|Puts the Documentation Project "Banner" at the top right of the page
 
|Puts the Documentation Project "Banner" at the top right of the page
<tt><nowiki>{{Documentation/Banner}}</nowiki></tt>
+
<tt><nowiki>{{DocBanner}}</nowiki></tt>
 
|[[Image:Docbanner.png]]
 
|[[Image:Docbanner.png]]
 
|-valign=top
 
|-valign=top
Line 200: Line 195:
 
Use this template when you perform larger edits on a file that may even take more than one session to finish.
 
Use this template when you perform larger edits on a file that may even take more than one session to finish.
 
Be sure to add name and date of "locking" by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter:
 
Be sure to add name and date of "locking" by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter:
<tt><nowiki>{{BeingEdited|EN|~~~~}}</nowiki></tt>
+
<tt><nowiki>{{BeingEdited|EN|~~~~|1}}</nowiki></tt>
|{{BeingEdited|EN|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)}}
+
|{{BeingEdited|EN|--[[User:Sancho|А. Е. Харламенков]] ([[User talk:Sancho|talk]]) 06:45, 9 July 2018 (UTC)|1]] 17:54, 7 February 2008 (CET)}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Caution]]
+
|[[Template:Warn]]
 
|Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.
 
|Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.
<tt><nowiki>{{Documentation/Caution|Always switch off power before opening the case.}}</nowiki></tt>
+
<tt><nowiki>{{Warn|Always switch off power before opening the case.}}</nowiki></tt>
|{{Documentation/Caution|Always switch off power before opening the case.}}
+
|{{Warn|Always switch off power before opening the case.}}
|-valign=top
+
|[[Template:Documentation/CheckedAccuracy]]
+
|Marks up pages that have been reviewed for accuracy.
+
Be sure to add name and date of review by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter:
+
<tt><nowiki>{{Documentation/CheckedAccuracy|~~~~}}</nowiki></tt>
+
|{{Documentation/CheckedAccuracy|John Doe 08:16, 22 January 2009 (UTC)}}
+
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/DraftPage]]
+
|[[Template:DraftPage]]
 
|Marks up pages that are in a draft state
 
|Marks up pages that are in a draft state
<tt><nowiki>{{Documentation/DraftPage}}</nowiki></tt>
+
<tt><nowiki>{{DraftPage|EN}}</nowiki></tt>
|{{Documentation/DraftPage}}
+
|{{DraftPage|EN}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/FromForum]]
+
|[[Template:FromForum]]
|<tt><nowiki>{{Documentation/FromForum}}</nowiki></tt>
+
|<tt><nowiki>{{FromForum|FR}}</nowiki></tt>
|{{Documentation/FromForum}}
+
|{{FromForum|FR}}
  
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/hbar]]
+
|[[Template:Bar]]
 
|Used to draw horizontal bars for simplistic bar charts
 
|Used to draw horizontal bars for simplistic bar charts
<tt><nowiki>{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki><br>
+
<tt><nowiki>{{Bar|100|10|#3333FF}}</nowiki><br>
<nowiki>{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki><br>
+
<nowiki>{{Bar|57|10|#33FF33}}</nowiki><br>
<nowiki>{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki></tt>
+
<nowiki>{{Bar|112|10|#FF3333}}</nowiki></tt>
 
|
 
|
{{Documentation/hbar|width=100|bg=#3333FF}}
+
{{Bar|100|10|#3333FF}}
{{Documentation/hbar|width=57|bg=#33FF33}}
+
{{Bar|57|10|#33FF33}}
{{Documentation/hbar|width=112|bg=#FF3333}}
+
{{Bar|112|10|#FF3333}}
  
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/HelpNeeded]]
+
|[[Template:HelpNeeded]]
|<tt><nowiki>{{Documentation/HelpNeeded|Check the spelling}}</nowiki></tt>
+
|<tt><nowiki>{{HelpNeeded|FR|Check the spelling}}</nowiki></tt>
|{{Documentation/HelpNeeded|Check the spelling}}
+
|{{HelpNeeded|FR|Check the spelling|1}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Imported]]
+
|[[Template:Imported]]
|<tt><nowiki>{{Documentation/Imported|author=Author Name|contributors=Contributor Names}}</nowiki></tt>
+
|<tt><nowiki>{{Imported|EN|Author Name|Contributor Names}}</nowiki></tt>
|{{Documentation/Imported|author=Author Name|contributors=Contributor Names}}
+
|{{Imported|EN|Author Name|Contributor Names}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Linux]]
+
|[[Template:Lin]]
|<tt><nowiki>{{Documentation/Linux|Linux related content}}</nowiki></tt>
+
|<tt><nowiki>{{Lin|Linux related content}}</nowiki></tt>
|{{Documentation/Linux|Linux related content}}
+
|{{Lin|Linux related content}}
 
|-valign=top
 
|-valign=top
 
|[[Template:Documentation/MasterTOC]]
 
|[[Template:Documentation/MasterTOC]]
Line 251: Line 240:
 
|
 
|
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/NeedsRework]]
+
|[[Template:NeedsRework]]
|<tt><nowiki>{{Documentation/NeedsRework}}</nowiki></tt>
+
|<tt><nowiki>{{NeedsRework|EN}}</nowiki></tt>
|{{Documentation/NeedsRework}}
+
|{{NeedsRework|EN|1}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Note]]
+
|[[Template:Note]]
|<tt><nowiki>{{Documentation/Note|Notable stuff}}</nowiki></tt>
+
|<tt><nowiki>{{Note|Notable stuff}}</nowiki></tt>
|{{Documentation/Note|Notable stuff}}
+
|{{Note|Notable stuff}}
 
|-valign=top
 
|-valign=top
 
|[[Template:OOoLogo]]
 
|[[Template:OOoLogo]]
Line 264: Line 253:
 
|{{OOoLogo}}
 
|{{OOoLogo}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Outdated]]
+
|[[Template:Old]]
|<tt><nowiki>{{Documentation/Outdated}}</nowiki></tt>
+
|<tt><nowiki>{{Old|EN}}</nowiki></tt>
|{{Documentation/Outdated}}
+
|{{Old|EN}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/PDF]]
+
|[[Template:PDF]]
|<tt><nowiki>{{Documentation/PDF}}</nowiki></tt>
+
|<tt><nowiki>{{PDF}}</nowiki></tt>
|{{Documentation/PDF}}
+
|{{PDF}}
 
|-valign=top
 
|-valign=top
 
|[[Template:OOo]]
 
|[[Template:OOo]]
Line 277: Line 266:
 
|{{OOo}}
 
|{{OOo}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/SeeAlso]]
+
|[[Template:SeeAlso]]
|<tt><nowiki>{{Documentation/SeeAlso|
+
|<tt><nowiki>{{SeeAlso|EN|
 
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
}}</nowiki></tt>
 
}}</nowiki></tt>
|{{Documentation/SeeAlso|
+
|{{SeeAlso|EN|
 
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
}}
 
}}
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Tip]]
+
|[[Template:Tip]]
 
|Takes sections containing tips, i.e. useful non-crucial information.
 
|Takes sections containing tips, i.e. useful non-crucial information.
<tt><nowiki>{{Documentation/Tip|Right-click opens the context menu}}</nowiki></tt>
+
<tt><nowiki>{{Tip|Right-click opens the context menu}}</nowiki></tt>
|{{Documentation/Tip|Right-click opens the context menu}}
+
|{{Tip|Right-click opens the context menu}}
 
|-valign=top
 
|-valign=top
 
|Template:Documentation/*TOC
 
|Template:Documentation/*TOC
Line 294: Line 283:
 
|See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 
|See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 
|-valign=top
 
|-valign=top
|[[Template:Documentation/Windows]]
+
|[[Template:Win]]
|<tt><nowiki>{{Documentation/Windows|Windows related content}}</nowiki></tt>
+
|<tt><nowiki>{{Win|Windows related content}}</nowiki></tt>
|{{Documentation/Windows|Windows related content}}
+
|{{Win|Windows related content}}
 
|}
 
|}
  
Line 344: Line 333:
 
Le contenu qui n'est plus à jour est habituellement marqué par une des étiquettes suivantes:
 
Le contenu qui n'est plus à jour est habituellement marqué par une des étiquettes suivantes:
  
{{Documentation/Outdated}}
+
{{Old|EN|1}}
{{Documentation/NeedsRework}}
+
{{NeedsRework|EN|1}}
Vous pouvez trouver une collection de pages avec cette dernière étiquette en cliquant sur [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] dans la page principale du Wiki.
+
Vous pouvez trouver une collection de pages avec cette dernière étiquette en cliquant sur [[:Category:NeedsRework | Pages that Need Help! ]] dans la page principale du Wiki.
  
 
Quand vous avez sélectionné une page à éditer
 
Quand vous avez sélectionné une page à éditer
Line 370: Line 359:
 
Les articles ayant besoin d'améliorations dans le style et le langage devraient être reconnus par les étiquettes suivantes:
 
Les articles ayant besoin d'améliorations dans le style et le langage devraient être reconnus par les étiquettes suivantes:
  
{{Documentation/HelpNeeded|Check the spelling}}
+
{{HelpNeeded|FR|Check the spelling|1}}
{{Documentation/NeedsRework}}
+
{{NeedsRework|EN|1}}
Vous pouvez trouver une collection d'articles avec cette dernière étiquette si vous cliquez sur le lien [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] depuis la page principale du Wiki.
+
Vous pouvez trouver une collection d'articles avec cette dernière étiquette si vous cliquez sur le lien [[:Category:NeedsRework | Pages that Need Help! ]] depuis la page principale du Wiki.
  
 
Pour améliorer un tel article, connectez vous, cliquez sur l'onglet d'édition et faites les corrections nécessaires. Puis retirez les étiquettes et cliquez sur '''Publier'''.
 
Pour améliorer un tel article, connectez vous, cliquez sur l'onglet d'édition et faites les corrections nécessaires. Puis retirez les étiquettes et cliquez sur '''Publier'''.
Line 463: Line 452:
 
# Cliquez sur le lien de votre How To et commencez à écrire en respectant les règles du [[Documentation/Dashboard/Help_Style_Guide | style guide]]. Si vous n'êtes pas sur de la façon d'implémenter le guide de styles, reportez vous à cet How To Writer [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].
 
# Cliquez sur le lien de votre How To et commencez à écrire en respectant les règles du [[Documentation/Dashboard/Help_Style_Guide | style guide]]. Si vous n'êtes pas sur de la façon d'implémenter le guide de styles, reportez vous à cet How To Writer [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].
  
{{Documentation/Note|Apposez toujours le lien de licence à la fin de votre article: Insérez seulement <tt><nowiki>{{PDL1}}</nowiki></tt>. }}
+
{{Note|Apposez toujours le lien de licence à la fin de votre article: Insérez seulement <tt><nowiki>{{PDL1}}</nowiki></tt>. }}
  
 
Vous pouvez également créer des How Tos en écrivant une nouvelle page comme <tt>FR/Documentation/How Tos/''Nom de la Page''</tt> avec une ou plusieurs catégories spécifiques. La page How To nouvellement créée sera alors assignée à la section How To correspondante. Les catégories disponibles pour cela sont les suivantes:
 
Vous pouvez également créer des How Tos en écrivant une nouvelle page comme <tt>FR/Documentation/How Tos/''Nom de la Page''</tt> avec une ou plusieurs catégories spécifiques. La page How To nouvellement créée sera alors assignée à la section How To correspondante. Les catégories disponibles pour cela sont les suivantes:
Line 505: Line 494:
 
* '''Ne traduisez pas''' les noms de pages Wiki. Utilisez le modèle <tt><nowiki>{{DISPLAYTITLE:Titre de la page}}</nowiki></tt> pour localiser le nom de la page.
 
* '''Ne traduisez pas''' les noms de pages Wiki. Utilisez le modèle <tt><nowiki>{{DISPLAYTITLE:Titre de la page}}</nowiki></tt> pour localiser le nom de la page.
 
* Utilisez une nomenclature des sous-pages indiquant clairement le langage de la page. Par exemple, la version chinoise du guide du développeur utilise la structure de sous-page <tt>Zh/Documentation/DevGuide</tt>. La version suédoise devrait utiliser <tt>SV/Documentation/DevGuide/</tt>, et ainsi de suite.
 
* Utilisez une nomenclature des sous-pages indiquant clairement le langage de la page. Par exemple, la version chinoise du guide du développeur utilise la structure de sous-page <tt>Zh/Documentation/DevGuide</tt>. La version suédoise devrait utiliser <tt>SV/Documentation/DevGuide/</tt>, et ainsi de suite.
{{Documentation/Note|Si possible, essayez de toujours utiliser all-caps pour le code de caractères ISO.
+
{{Note|Si possible, essayez de toujours utiliser all-caps pour le code de caractères ISO.
  
 
(If possible, try to always use all-caps for the ISO language code.)}}
 
(If possible, try to always use all-caps for the ISO language code.)}}

Revision as of 11:34, 7 August 2018

doc OOo

Ce qui suit est la version française de cette page.

Cet article est là pour vous aider à contribuer activement à la partie Documentation du wiki. Nous vous encourageons fortement à annoncer les nouvelles pages ou les changements majeurs sur la liste de documentation. Cliquez ici pour vous inscrire (aucun message nécessaire, c'est un robot), et ensuite ici pour poster.

Vous pouvez également voir ici l'ensemble des listes.

Prérequis pour l'Édition

Vous devez être enregistré et connecté avant de pouvoir éditer le wiki. L'enregistrement est simple.

  1. Cliquez sur Connexion / Créer un compte dans le coin en haut à droite de cette page et complétez les champs requis.
    Nous recommandons l'emploi du même nom d'utilisateur que pour le site Apache OpenOffice.
  2. Puis vous aurez à valider votre adresse email en cliquant sur le lien que vous aurez reçu.

Pour les connexions ultérieures vous partirez du même point, entrerez votre nom d'utilisateur et votre mot de passe, et cliquerez sur le bouton Log in

L'étape suivante est de vous présenter à la communauté. Il n'y a aucun dommage possible et c'est une bonne façon d'aborder confortablement le wiki.

  1. Quand vous êtes connecté, votre nom d'utilisateur apparaît en haut de la page, en rouge, jusqu'à ce que vous créiez votre page utilisateur. Pour ceci, cliquez sur votre nom d'utilisateur.
  2. Sur votre page, ajoutez les sections données ci-dessous, c'est votre profil sur le Wiki Apache OpenOffice;
    • A propos de vous (About yourself)
    • Apache OpenOffice et vous (OpenOffice and you)
    • Vos contributions (Your contributions)
    • Travaux en cours (Work in progress)
    • Des projets futurs? (Any future plans?)
    • Références (optionnel) - Reference (optional)
    • Contact

Ceci est donc grossièrement un modèle de création de profil. Vous n'êtes pas obligé de le suivre et pouvez tout à fait avoir des sections de votre choix. Cette liste est là pour constituer un modèle pour tous les nouveaux utilisateurs.

Ajout de commentaires

Les commentaires importants doivent être annoncés sur la liste de diffusion doc@fr.openoffice.org pour être certain qu'ils seront remarqués.

Pour ajouter un commentaire à une page:

  1. Cliquez sur l'onglet Discussion en haut de la page.
    • Si vous démarrez un nouveau sujet cliquez sur le signe + à droite de l'onglet edit en haut, remplissez la ligne de titre du sujet et inscrivez votre commentaire dans la boite principale. (in the main text box.)
    • Si vous voulez ajouter un commentaire à une discussion existante insérez le après le commentaire existant et indentez le en apposant un caractère deux points (:) au début de chaque paragraphe.
  2. Signez de votre nom d'utilisateur avec quatre caractères tildes (~~~~). Vous pouvez le faire automatiquement avec le bouton "Votre signature avec la date" ( button_sig.png ) dans la barre d'outils.
  3. Cliquez sur Publier. (Click Save Page.)

Pour en apprendre plus sur les commentaires reportez vous à la page Mediawiki help about talk pages

Structure de la section FR/Documentation du wiki

La section documentation n'est qu'une part de ce vaste wiki. Le projet doc.oo.o tente de présenter l'information dans cette section d'une manière facilement accessible et d'avoir une structure permettant une navigation aisée à la fois pour l'utilisateur et le contributeur.

Toutes les pages de documentation sont des sous-pages de la page de documentation principale. Une sous-structure ou sous-page présente des sections contenant d'autres sous-pages... Ayez en une vue hiérarchique, tout comme un système de fichiers (votre disque dur). Chaque sous-page est automatiquement reliée à la page principale.

NDT: J'ai adapté un tableau ici puisque le modèle de référence est native lang - anglais. En effet, il est bon de respecter l'architecture existante, dans le cas d'une traduction par exemple, ceci afin de faciliter les liens interwikis. (Voir l'onglet Discussion de cette page.)

L'arborescence actuelle du wiki ressemble à ceci: The current wiki page tree looks like this:
wiki.services.openoffice.org/wiki wiki.services.openoffice.org/wiki/Documentation
   +--- ...à compléter...
   +---FR/Documentation/Administration_Guide
   +---FR/FAQ
   +---FR/Documentation/How_Tos
   +---
   +---
   +---
   +---
   +---FR/Documentation/BASIC_Guide
   +---(Extensions_development_basic_fr)
   +---
   +---Dashboard
   +---Administration Guide
   +---FAQ
   +---How Tos
   +---OOoAuthors User Manual
   +---Tutorials
   +---Samples, Templates and Clipart
   +---Setup Guide
   +---BASIC Guide
   +---DevGuide
   +---Reference


Architecture du wiki anglophone:
Subpage Description
Documentation/Dashboard High-level tracking of documentation sub-projects and content deliverables
Documentation/Administration Guide Guide that describes how to administer an OpenOffice.org network installation
Documentation/FAQ Collection of FAQs.
Documentation/How Tos Link collection of How Tos
Documentation/OOoAuthors User Manual Collection of User Guides from OOoAuthors
Documentation/Tutorials Tutorial collections from different contributors
Documentation/Samples, Templates and Clipart Sub-project page in order to provide usable templates for business and personal use (draft)
Documentation/Setup Guide Sub-project page in order to provide a guide through the setup process of OpenOffice.org (draft)
Documentation/BASIC Guide Guide that provides an introduction to programming with OpenOffice.org BASIC
Documentation/DevGuide Guide that describes how to program with OpenOffice.org using the component technology UNO (Universal Network Objects) with OpenOffice.org.
Documentation/Reference Collection of reference material. References on this page should show up under Reference Lists at the Documentation main page.

Création de nouvelles pages

Documentation caution.png Avant de créer une page assurez vous qu'il n'y ait pas déjà une page existante avec un sujet similaire.
  • Si la nouvelle page peut être une sous-page d'une page existante allez simplement sur la page existante et créez un lien vers la nouvelle page. Après publication de la page existante modifiée vous pouvez cliquer sur le lien et commencer à écrire votre nouvelle page.
  • Si vous voulez vraiment créer une nouvelle page pour le projet Documentation, vous pouvez utiliser l'URL du wiki pour en créer une. Vous devez observer l'arborescence du wiki quand vous créez une nouvelle page de cette façon. L'URL d'une page wiki est alors quelque chose comme:
    http://wiki.services.openoffice.org/wiki/fr/documentation/PageName
Documentation note.png L'approche par URL est seulement pratique si vous liez cette page plus tard à d'autres. Autrement cette page restera cachée dans le Wiki.

Pour plus d'information sur les nouvelles pages, reportez vous à Mediawiki help about new pages

Utilisation des catégories

Les catégories assignées à une page sont généralement listées en bas de celle-ci. Cliquez sur une catégorie, et vous verrez une page relatant toutes les pages ayant été classées dans cette catégorie. De cette façon, une étiquette (tag) de catégorie dans une page vous donne l'opportunité de voir le contenu en rapport. Plus la page est grosse et plus nombreuses pourront être les étiquettes de catégories insérées.

Pour ajouter une étiquette de catégorie à une page

  1. Cliquez sur Pages spéciales dans la boîte à outils à gauche.
  2. Cliquez sur Catégories dans la liste de liens de la page spéciale.
  3. Choisissez un nom de catégorie sensé, et appliquez le en ajoutant [[Category:Category Name]] à la fin de la page.
Documentation caution.png Ne créez pas de catégories dupliquées pour le même sujet. Chaque catégorie doit être unique. Autrement il deviendra difficile d'utiliser les catégories pour chercher dans le wiki.

Reportez vous à MediaWiki Help:Categories si vous voulez en savoir plus sur les catégories Wiki.

Un exemple simple d'utilisation des catégories dans les livres Wiki:

  1. Créez une catégorie nommée d'après le chapitre en cours.
  2. Ajoutez la nouvelle étiquette de catégorie à toutes les pages de ce chapitre.
  3. Ajoutez l'étiquette de catégorie du livre à la page de cette nouvelle catégorie.

Le lecteur peut alors voir la catégorie du livre. La catégorie du livre montre tous les chapitres du livre. Si le lecteur clique sur une catégorie de chapitre, il peut voir toutes les pages de ce chapitre (en ordre alphabétique).

N'ajoutez pas une catégorie et sa sous-catégorie à une même page wiki. Pour plus d'informations voyez la section MediaWiki Help:Category sur Category considerations.

Vous pouvez utiliser des modèles pour ajouter une catégorie commune à un grand groupe de pages, mais ce n'est pas recommandé. On peut penser gagner du temps, mais "ajouter ou supprimer une étiquette de catégorie dans le modèle ne met pas à jour la liste des catégories des pages qui utilisent ce modèle, jusqu'à ce qu'on édite la page qui utilise ce modèle." Pour plus d'information, voyez la section MediaWiki Help:Category sur Using templates to populate categories.


Modèles

Consultez la page Templates help si vous n'êtes pas familier avec les modèles de mediawiki.

Ajouter un nouveau modèle de documentation

  • Si vous créez un nouveau modèle pour utilisation dans le wiki Documentation, nommez le comme une sous-page de FR/Documentation.
    • Incorrect: MonModèle
    • Correct: FR/Documentation/MonModèle
  • Ajoutez une description sur le but et l'utilisation du modèle dans le modèle lui-même en utilisant l'élément comme décrit à MediaWiki help: Template.
  • Ajoutez le modèle à la liste des modèles ci-dessous.

Liste des modèles de documentation existants en anglais

This is a list of Documentation templates and their usage

Template Name Usage Example
Template:DocBanner Puts the Documentation Project "Banner" at the top right of the page

{{DocBanner}}

Docbanner.png
Template:BeingEdited Marks a page as currently being edited to avoid conflicting changes.

Use this template when you perform larger edits on a file that may even take more than one session to finish. Be sure to add name and date of "locking" by adding a ~~~~ as parameter: {{BeingEdited|EN|~~~~|1}}

Documentation beingedited.png This page is currently being edited --А. Е. Харламенков (talk) 06:45, 9 July 2018 (UTC)

 

Template:Warn Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.

{{Warn|Always switch off power before opening the case.}}

Documentation caution.png Always switch off power before opening the case.
Template:DraftPage Marks up pages that are in a draft state

{{DraftPage|EN}}

Editing.png This page is in a DRAFT stage.

Template:FromForum {{FromForum|FR}}
Le contenu de cet article provient du Forum des utilisateurs OpenOffice.

Template:Bar Used to draw horizontal bars for simplistic bar charts

{{Bar|100|10|#3333FF}}
{{Bar|57|10|#33FF33}}
{{Bar|112|10|#FF3333}}

Template:HelpNeeded {{HelpNeeded|FR|Check the spelling}}

Documentation needshelp.png Cet article a besoin d'aide


Check the spelling

 

Template:Imported {{Imported|EN|Author Name|Contributor Names}}
This article was imported from another document. Original author: Author Name - Previous contributors: Contributor Names
Template:Lin {{Lin|Linux related content}}
Documentation linux.png Linux related content
Template:Documentation/MasterTOC This is the master template that is used to create tables of content. For usage click the template name.
Template:NeedsRework {{NeedsRework|EN}}

Edit-find-replace.png This article should be checked for accuracy and conformity to style.

Template:Note {{Note|Notable stuff}}
Documentation note.png Notable stuff
Template:OOoLogo Displays an OpenOfiice.org logo

{{OOoLogo}}

Ooo.png
Template:Old {{Old|EN}}
Book-old.png    This article is outdated.    
Template:PDF {{PDF}} Pdf.png
Template:OOo A variable for displaying the string OpenOffice.org.

{{OOo}}

Apache OpenOffice
Template:SeeAlso {{SeeAlso|EN| * [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]] }}
See Also


Template:Tip Takes sections containing tips, i.e. useful non-crucial information.

{{Tip|Right-click opens the context menu}}

Tip.png Right-click opens the context menu
Template:Documentation/*TOC Several tables of content based on Template:Documentation/MasterTOC used in guides. See, for example, the Basic Guide TOC
Template:Win {{Win|Windows related content}}
Documentation windows.png Windows related content

Liste des modèles de documentation existants en français

Voir le contenu de ce chapitre.

Contenu graphique

Les grandes lignes directrices pour les images sont:

  • Utilisez un titre unique et descriptif. le nom du fichier doit être construit d'une manière qui montre son utilisation, par exemple:
Doc_mig_icon_data.png = Image de Documentation, utilisé dans le guide de migration, dépeignant l'icone de database.
  • Si possible, ne mettez pas à l'échelle les images que vous téléchargez. Vous pouvez utiliser la fonctionnalité MediaWiki image thumbnail pour mettre l'image à l'échelle.
  • Éditez l'image si nécessaire pour vous assurer que la partie importante est claire et visible.
  • Gardez à l'esprit que d'autres personnes peuvent vouloir traduire la page où vous placez une image. Essayez de ne pas inclure de superpositions ou autre texte supplémentaire à l'image.
  • JPG est généralement meilleur pour les photos, SVG, pour les icônes, les logos etc., et PNG pour les captures d'écran. N'essayez pas d'utiliser BMP ou TIFF.

Avant que vous puissiez insérer votre image fin prête dans une page Wiki, vous devez la télécharger sur le serveur.

  1. Dans la barre latérale, section Boîte à outils, cliquez sur Importer un fichier. La page de description d'image apparait.
  2. Utilisez la page de description d'image pour décrire l'image et ses statuts de copyright (s'il y en a).
Pour placer l'image sur la page vous pouvez utiliser la fonctionnalité MediaWiki Image thumbnail qui "contient" vos illustrations dans une boîte image. Cette boîte image contient également un point pour une légende. La syntaxe est
File:image.png
Image caption
, où:
  • thumb = Réduit l'image et la contient dans une boîte image.
  • position = Position sur la page. "Rien" place l'image à gauche dans le cadre de la page sans habillage du texte. ""left" et "right" placent l'image à gauche ou à droite de la page avec un plein habillage du texte.
  • size = Taille maximum en pixels pour l'image. Si l'image est plus grande que cette valeur alors elle est réduite. Si l'image est plus petite elle ne subit aucun changements.

Si vous ne déclarez pas position et size, l'image est réduite à un petit timbre poste, et par défaut du coté droite de la page avec un plein habillage du texte.

Voici un exemple utilisant [[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]

Un exemple de légende pour cette image
  • Comment gérer les images et la numérotation des tables? (How to handle image and table numbering?)

Liaisons

Bien que la fenêtre d'édition offre une assistance dans l'écriture de liens internes et externes vous pouvez regarder la page MediaWiki help page about links pour une meilleure compréhension du fonctionnement des liens wikis.

Il y a une autre page d'aide MediaWiki si vous avez besoin d'examples.

Lors de la création de liens veuillez considérer les directives de using links dans notre guide de style.

Travaux généraux d'édition

L'édition n'est passible qu'une fois connecté. Vous pouvez commencer par éditer la page entière après avoir cliqué sur l'onglet Modifier en haut de page. Mais généralement c'est plus pratique d'éditer des section individuelles d'une page en cliquant sur le lien Modifier à droite. Si vous effectuez des changements, veuillez considérer les règles du style guide pour assurer un style d'écriture consistant. Cliquez sur le bouton Prévisualiser pour vérifier les changements avant de finalement Publier / sauvegarder cette page.

Réparer du contenu inapproprié, inexact ou qui n'est plus à jour

Le contenu qui n'est plus à jour est habituellement marqué par une des étiquettes suivantes:


Book-old.png    This article is outdated.    
 


Edit-find-replace.png This article should be checked for accuracy and conformity to style.

Vous pouvez trouver une collection de pages avec cette dernière étiquette en cliquant sur Pages that Need Help! dans la page principale du Wiki.

Quand vous avez sélectionné une page à éditer

  1. Testez si les procédures décrites sont toujours valides pour la version courante de Apache OpenOffice.
  2. Connectez vous et faites les corrections nécessaires.

Ce procédé est plus aisé si vous ouvrez deux onglets dans votre navigateur, un pour lire les procédures et un pour l'édition.

Quand vous avez fini, enlevez la ou les étiquettes ci dessus, marquez la page avec l'étiquette "Vérifiée pour l'exactitude technique" (comme décrit dans la section Modèles ci-dessus), et cliquez sur Publier.

Réparer des erreurs mineures et typographiques

Si vous détectez des erreurs mineures comme des erreurs typographiques par exemple, connectez vous et éditez l'article. Avant de cliquer sur le bouton Publier vous devez cocher la case Modification mineure juste au dessus.

Réparer les graphiques et copies d'écran

Pour éditer un graphique sur le Wiki, Clic de droite sur le graphique et choisissez Enregistrer l'image sous.... Quand vous avez édité le graphique sur votre ordinateur, revenez à la page Wiki, cliquez sur le graphique, et dans la page de la description de l'image choisissez Importer un nouvelle version de ce fichier.

Si vous avez créé une nouvelle version d'une copie d'écran, cliquez directement sur la copie d'écran correspondante sur le wiki et ensuite choisissez Importer un nouvelle version de ce fichier dans la page de la description de l'image.

Réparer le style et la langue

Les articles ayant besoin d'améliorations dans le style et le langage devraient être reconnus par les étiquettes suivantes:


Documentation needshelp.png Cet article a besoin d'aide


Check the spelling

 


Edit-find-replace.png This article should be checked for accuracy and conformity to style.

Vous pouvez trouver une collection d'articles avec cette dernière étiquette si vous cliquez sur le lien Pages that Need Help! depuis la page principale du Wiki.

Pour améliorer un tel article, connectez vous, cliquez sur l'onglet d'édition et faites les corrections nécessaires. Puis retirez les étiquettes et cliquez sur Publier.

Liens vers des pages localisées

Validation du contenu

Réparer le Spam / Supprimer des pages

Si vous détectez du spam envoyez un mail à dev@website.openoffice.org.

Il y a aussi une list with Wiki Sysops (personnes qui peuvent supprimer des pages). Si vous voulez détruire certaines pages, vous pouvez demander à quelqu'un de cette liste, ou mieux, ajouter la syntaxe Wiki {{delete}} n'importe ou sur la page que vous voulez supprimer. Ceci ajoutera la page à la catégorie "Candidates for speedy deletion" ("Candidats pour suppression rapide"), et la page sera effacée par quelqu'un ayant des privilèges Sysop, ou par un robot de maintenance WikiBot.

Travailler sur les FAQs

Toutes les questions et réponses sont affichées ensemble sur une simple page Wiki.

Si vous voulez insérer une nouvelle entrée dans la FAQ, c'est donc une paire question / réponse correspondante:

  1. Sélectionnez une section de la FAQ sur la page principale du Wiki Documentation. Pour Writer et Calc vous avez à sélectionner une autre sous-page jusqu'à ce que vous atteigniez la section finale de la FAQ.
  2. Faites défiler vers le bas jusqu'à la zone de liste Insérer nouvelle FAQ.
  3. Remplacez le texte dans la liste après le dernier slash '/' avec votre question.
  4. Cliquez sur Ajouter nouvelle FAQ
    Une nouvelle page Wiki est créée et préchargée avec un modèle pour une paire Question / Réponse:
  5. {{{DISPLAYTITLE: (INSERT FAQ TITLE)}}
     
    <section begin=question/>
    <INSEREZ LA QUESTION>
    <section end=question/>
     
    <section begin=answer/>
    <INSEREZ LA REPONSE>
    <section end=answer/>
     
    [[Category:Documentation/FAQ/<INSERT FAQ SECTION>]]
  6. Remplacez (INSERT FAQ TITLE) avec le titre de la FAQ à afficher sur la page. Ce peut être une version courte de la question ou la question elle-même.
  7. Remplacez <INSERT QUESTION> par la question actuelle.
  8. Remplacez <INSERT ANSWER> par la réponse actuelle.
  9. Remplacez <INSERT FAQ SECTION> par le nom de la section en cours dans la FAQ. Cette assignation de catégorie détermine où les pages Wiki apparaîtront. Veuillez utiliser les noms de section suivants:
  10. FAQ section section name in category
    General General
    Installation Installation
    Word Processing Writer
    Automatic Functions Writer/AutomaticFunctions
    Document Management Writer/DocumentManagement
    Formatting Pages and Docs Writer/FormattingPagesAndDocuments
    Formatting Text Writer/FormattingText
    Graphics, Frames & Objects Writer/GraphicsFramesObjects
    Indexes, Tables of Contents Writer/IndexToc
    Printing and Mail Merge Writer/Printing
    Spreadsheets Calc
    Drawings Draw
    Presentations Impress
    Formula Editor Formula
    Database Databases
    Macros Macros
  11. Cliquez sur Publier.

Travailler sur les How Tos

Si vous voulez créer un nouvel How To

  1. Allez à la section How Tos et ouvrez la fenêtre d'édition (onglet Modifier).
  2. Identifiez la sous-section adéquate et entrez le titre de votre How To comme un lien.
  3. Cliquez sur Publier pour rendre le lien visible.
  4. Cliquez sur le lien de votre How To et commencez à écrire en respectant les règles du style guide. Si vous n'êtes pas sur de la façon d'implémenter le guide de styles, reportez vous à cet How To Writer Getting a Picture Into the Gallery.
Documentation note.png Apposez toujours le lien de licence à la fin de votre article: Insérez seulement {{PDL1}}.

Vous pouvez également créer des How Tos en écrivant une nouvelle page comme FR/Documentation/How Tos/Nom de la Page avec une ou plusieurs catégories spécifiques. La page How To nouvellement créée sera alors assignée à la section How To correspondante. Les catégories disponibles pour cela sont les suivantes:

  • [[Category:FR/Documentation/How Tos/Installation]]
  • [[Category:FR/Documentation/How Tos/Writer]]
  • [[Category:FR/Documentation/How Tos/Impress]]
  • [[Category:FR/Documentation/How Tos/Calc]]
  • [[Category:FR/Documentation/How Tos/Database]]

Si vous voulez revoir des How Tos existants, cherchez l'étiquette "Cet article a besoin d'être vérifié sur la pertinence et le style."

  • Testez si les procédures décrites sont toujours valides pour la version actuelle de Apache OpenOffice,
  • Vérifiez que les règles du guide de style sont appliquées,
  • Vérifiez la grammaire et les fautes d'orthographe,

Et faites les corrections nécessaires dans la fenêtre d'édition.

Quand vous avez fini, marquez la page avec l'étiquette "Vérifié pour l'exactitude technique" comme décrit dans la section Modèles ci-dessus, et cliquez sur Publier.

N'oubliez pas de prévenir doc@fr.openoffice.org de votre travail sur les How Tos.

Travailler sur les guides

Actuellement, les guides suivants sont disponibles sur le Wiki: Currently, there are the following guides on the wiki:
Liste à compléter...

Si vous voulez travailler sur les guides d'utilisateur pour Apache OpenOffice veuillez contacter le groupe des auteurs, OOoAuthors group.

De l'aide est disponible à propos de Contributing to the Developer's Guide qui peut également être pratique pour le guide d'administration et le guide du programmeur Basic.

Localisation du contenu

Ci-dessous quelques directives relatives aux traductions:

  • Suivre la même structure que la page anglaise.
  • Ne traduisez pas les noms de pages Wiki. Utilisez le modèle {{DISPLAYTITLE:Titre de la page}} pour localiser le nom de la page.
  • Utilisez une nomenclature des sous-pages indiquant clairement le langage de la page. Par exemple, la version chinoise du guide du développeur utilise la structure de sous-page Zh/Documentation/DevGuide. La version suédoise devrait utiliser SV/Documentation/DevGuide/, et ainsi de suite.
Documentation note.png Si possible, essayez de toujours utiliser all-caps pour le code de caractères ISO.

(If possible, try to always use all-caps for the ISO language code.)

  • Liez les différents langages entre eux par l'utilisation de la syntaxe des liens interwikis [[ISO_Lang_code:Page_Title]]. (Plus facile à réaliser avec les modèles Wiki, quand une nouvelle localisation est ajoutée)
Content on this page is licensed under the Public Documentation License (PDL).
Views
Personal tools
Navigation
Tools
In other languages