Revision as of 09:22, 8 December 2007

Template:Documentation/Banner

Cette page est en cours d'édition

Flepennu Decembre 2007 (CEST)

Cet article a pour but de vous aider a contribuer a la section Documentation/FR de ce wiki.

Structure du Wiki Documentation

Hiérarchie

La section Documentation est une partie du Wiki. Le projet doc.oo.o cherche a présenter les informations dans cette section d'une facon accessible et a une structure qui permet la navigation pour les utilisateurs et les contributeurs.

Toutes les pages documentation ne sont pas des sous-pages de la page Documentation principale, certaines renvoient vers des sous pages, d'autres vers des liens de la documentation anglaise.

L'arborescence de la page documentation/FR du wiki presente pour l'instant :

wiki.services.openoffice.org/wiki/Documentation/FR/
   |
   +---Foire Aux Questions (FAQ)
   +---Manuels de l'utilisateur (OOoAuthors) (en)
   +---How-to
   +---Chercher/Télécharger
   +---Guides pour l'administration de OpenOffice.org
   +---Guide (en anglais) de programmation BASIC

Utilisation des Categories

Allez voir ici si vous n'etes pas familier des Categories Wiki.

Quelles exemples simples pour utiliser des Categories dans un Wiki :

1. Creer une Categorie du nom du chapitre courant.
2. Ajouter toutes les pages de ce chapitre dans une Categorie du nom de ce chapître.
3. Ajouter le nom de cette Categorie dans le wiki.

Le lecteur peut ainsi voir la Categorie du livre. Le livre Categorie indique tous les chapitres du livre. Si le lecteur clique sur un chapitre Categorie, il verra toutes les pages dans ce chapitre (par ordre alphabétique).

Il ne faut pas ajouter une Categorie et une sous-categorie à la même page du wiki. Pour plus d'informations, consultez la section MediaWiki Help:Category disponible Category considerations.

Il est possible, mais pas recommandé, d'utiliser des Gabarits pour ajouter une Categorie commune à un ensemble important de pages. Cela donnerait l'impression de gagner du temps, mais l'ajout ou la suppression d'un tag de categorie dans le Gabarit n'ajoute, ni supprime les listages à ou de la page Categorie des pages qui utilisent ce Gabarit, jusqu'à ce qu'on édite une page qui utilise ce dernier. Pour d'autres informations, voir la section MediaWiki Help:Category Disponble ici.

Utilisation des gabarits (Templates)

allez voir ici si vous n'êtes pas familier des gabarits (mediawiki templates).

Si vous créer des nouveaux gabarits , nommez les commes des sous-pages de documentation/FR :

• Mauvais: montemplate
• Bon: Documentation/FR/montemplate

Gabarits existants (Templates)

Nom	Usage	Exemple
Template:Documentation/Abstract
Template:Documentation/Banner
Template:Documentation/FR/EnCours		Cette page est en cours d'édition
Template:Documentation/FR/Attention		Ne faite jamais ce qui est écrit ici.
Template:Documentation/FR/PertinenceVerifiee		Cet article a été vérifié sur sa pertinence technique par Jean Dupond
Template:Documentation/FR/PremierJet		Cette page est un premier jet !
Template:Documentation/hbar		Template:Documentation/hbar
Template:Documentation/FR/AideDemandee		Template:Documentation/FR/AideDemandee
Template:Documentation/Hook
Template:Documentation/Imported
Template:Documentation/LastEdited		Only works after update of mw engine to > 1.8
Template:Documentation/Linux		Template:Documentation/Linux
Template:Documentation/MasterTOC
Template:Documentation/FR/EnAttente		Cet article a besoin d'être vérifié sur ses aspects techniques, de pertinence et/ou de styles.
Template:Documentation/FR/Note		Template:Documentation/FR/Note
Template:Documentation/OOo		Template:Documentation/OOo
Template:Documentation/FR/PlusValable		Cet article n'est plus valable.
Template:Documentation/PDF		Template:Documentation/PDF
Template:Documentation/PRODUCTNAME		Template:Documentation/PRODUCTNAME
Template:Documentation/FR/Astuce		Essayez cette astuce.
Template:Documentation/*TOC
Template:Documentation/Windows		Template:Documentation/Windows

Contenu Graphique

Pour les images , voici quelques principes généraux :

1. Utilisez la page des descriptions des images pour préciser le statut légal de l'image et de son usage.
2. Utilisez une description et un titre unique.
3. Si possible n'adaptez pas le format et la taille de l'image avant de l'envoyer sur le serveur, utilisez la vignette MediaWiki pour faire figurer l'image.
4. Editez l'image si necessaire pour etre sur de ne faire apparaitre que ce qui est important d'une facon claire et visible.
5. Gardez à l'esprit que d'autres personnes pourraient traduire la page où vous mettez une image. Essayez de ne pas inclure des bulles d'affichage ou d'autre texte supplémentaire sur l'image.
6. Le format JPG est général le mieux adapté pour les photos, SVG, pour des icones, logos etc, et PNG pour des captures d'écran. Dans la mesure du possible, n'utilisez pas du BMP.

Il est possible d'utiliser la fonction MediaWiki Image thumb pour "emballer" vos illustrations dans un cadre à image. Ce cadre à image comprend un emplacement pour la légende de l'image. La syntaxe est la suivante [[Image:image.png|thumb|position|size|Image caption]], où:

• thumb = mettre en vignette l'image et l'inclure dans un cadre à image
• position = la position sur la page. "none" met l'image sur la gauche du cadre sans entrelacement du texte. "left" et "right" met l'image respectivement à gauche ou à droite sur la page avec entrelacement complet du texte.
• size = la largeur maximale en pixels pour l'image. Si l'image est plus grande que cette valeur, elle est réduite à l'échelle. Si l'image est plus petite que cette valeur, elle demeure inchangée.

Si vous ne déclarez ni position ni taille, l'image est transformée en petite vignette, et se met par défaut sur la droite de la page avec un entrelacement complet du texte.

Un exemple d'utilisation [[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]

An example image caption

Linking