From Fedora Project Wiki

Revision as of 21:07, 16 February 2010 by Mrtom (talk | contribs) (moved Fr FR/WikiEdition to Archive:Fr FR/WikiEdition)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Old page
This page has been marked as "old", and likely contains content that is irrelevant or incorrect. If you can, please update this page. This page will be deleted if action is not taken.

{| style="width: 100%; text-align: center"

|- |style="color: white; background: #3074c2; font-weight: bold; font-size: larger" | Modifier le Wiki du Projet Fedora |- |style="color: black; background-color: #eeeff1" | Le wiki du Projet Fedora possède une faible barrière d'entrée pour les éditeurs. Cependant, il existe un petit niveau d'apprentissage pour l'utilisation du wiki et nous avons une série de directives que tous les éditeurs doivent suivre. Cette page fournit ces directives et quelques astuces. |- | File:WikiGraphics Fedora Design.png |}

Obtenir l'accès de modification

Afin d'éviter l'usage malicieux du wiki du Projet Fedora, nous avons légèrement restreint l'accès de modification. Pour obtenir l'accès de modification du wiki, vous devez suivre ces étapes simples:

  1. Familiarisez-vous avec les informations de cette page et de celles qui y sont liées. Des lignes de conduites basiques qui devraient être suivies à travers le wiki sont couvertes ici. Le non respect de ces règles conduit à du travail non nécessaire pour les autres volontaires et peut résulter en la révocation des privilèges d'édition.
  2. Créer un compte

La première étape d'accès du wiki est de visiter la page PréférencesUtilisateur et de créer un compte. Le nom d'utilisateur pour votre compte doit être votre nom réel au format Wiki (c'est à dire, PrénomNom, JacquesRousseau). Ce format est nécessaire pour les liens wiki.

L'utilisation de votre nom réel et du format approprié est importante !
Nous exigeons les noms réels pour des raisons d'identification et de comptabilité. L'usage du format approprié est requis pour activer les liens propres du wiki et supporter certaines particularités utilisées.
  1. Compléter l'Accord de Licence au Contributeur sous le Système de Compte Fedora Signer le CLA donne au Projet Fedora la capacité de licencier vos contributions sur le wiki sous le Open Publication License 1.0 (en anglais) sans option. Cela assure que vos contribution demeureront libres pour l'usage, la modification et la redistribution par la communauté comme la distribution Fedora Core. Consultez la section Legal pour plus d'informations. Suivez les instructions de la page GuideCLA .
  2. Contacter quelqu'un appartenant au groupe d'édition

Toute personne listée sur la page du groupe d'édition peut vous ajouter sur l'EditGroup. C'est un groupe qui possède l'accès en écriture sur le wiki. Si vous avez parlé à un contributeur, demandez-lui s'il peut vous ajouter au groupe. Il est préférable d'être déjà connu lorsque vous demandez l'accès en édition, mais cela n'est pas requis. Si vous n'avez personne à contacter, vous pouvez également jeter un oeil sur le canal #fedora-websites sur freenode . Si rien de cela ne fonctionne, ajoutez-vous sur la page EditGroupQueue et attendez qu'un membre du groupe d'édition vous ajoute.

Contribuer aux Sites web Fedora
Si vous êtes intéressé par la maintenance générale du site web ou si vous souhaitez être membre de l'équipe des Sites Web Fedora, consultez la page Sites Web.
Travailler sur la documentation Fedora
Les informations sur l'écriture des documentations sur Fedora en utilisant le wiki sont disponibles sur Écrire de la Documentation Wiki.


Directives

Il existe des points à suivre lorsque vous effectuez des changements au wiki. Vous en trouverez ci-dessous quelques exemples. En général, soyez courtois et logiques. Défier ces directives et causer des problèmes sont les moyens simple de voir vos privilèges d'édition révoqués. Si vous avez des questions, veuillez visiter le canal #fedora-websites sur freenode .

Se Présenter

Avant de modifier une page, présentez-vous aimablement en ajoutant vos informations sur votre page wiki. Après l'enregistrement de votre nom sur le wiki, vous avez automatiquement une page personnelle située à http://fedoraproject.org/wiki/<NomWiki>, oú <NomWiki> est remplacé par votre nom de compte wiki.

Pour des exemples, consultez CategoryHomepage.

Assurez-vous de mentionner votre courriel. Les webmasters ou les membres de la communauté pourront avoir besoin de vous contacter concernant les pages que vos aurez modifiées. Il existe plusieurs façons de protéger votre courriel des intrus:

Vous devez comparer les avantages et les inconvénients de chaque méthode et choisir celle correspondant le mieux à vos préférences.

Toujours vous abonner aux pages que vous créez ou modifiez

Il est très important que vous suiviez les changements des pages que vous créez ou modifiez, vous pourrez ainsi rester coordonné avec les autres intervenants du wiki. Les éditeurs du wiki ajoutent habituellement des notes aux pages concernant les modifications, ce qui permet de surveiller les changements.

Vous trouverez le lien S'abonner dans la sidebar lors de la connexion.

Éviter les modifications des pages non-nécessaires discutant des issues légales

Ces pages sont rédigées avec soin, et les mots choisis avec parcimonie. Lors de changements, il est préférable de demander une évaluation avant de les appliquer. Vous pouvez contacter le "Fedora Advisory Board" (voir la page ["Board"] ) pour obtenir de l'assistance.

Ne pas fournir de détails sur les sujets interdits

N'ajoutez pas d'informations qui violent les lois. Rappelez-vous que le Projet Fedora est une entité aux États-Unis gouvernée par ses lois. Évitez de lier ou d'ajouter des informations sur des logiciels qui ne sont pas libres ni open source ou légalement encombrés. Si vous pensez être face à une exception, portez la à l'attention à l'équipe Sites Web pour en discuter. Consultez la page Sujets Interdits pour des exemples d'articles à éviter.

Prudence lors de l'édition de guides ou pages clés

Les guides importants comme Packaging Guidelines sont généralement gérés par un petit groupe spécifique. Il vaut mieux travailler avec eux lorsque vous sentez que les changements sont nécessaires.

Les pages importantes, comme FedoraPrincipal ou Téléchargement , sont les premières choses que voient les visiteurs. Des modifications sur de telles pages devraient généralement être laissées à l'appréciation de contributeurs expérimentés. Si vous pensez que quelque chose sur une telle page devrait être modifié, rapportez le à l'équipe Sites Web pour qu'il en soit discuté.

Ne modifiez pas les pages juste pour les modifier

Les modifications inutiles doivent être évitées. Altérer une page pour simplement avoir votre nom dans le log est inacceptable. Il y a beaucoup de pages (la plupart en fait) qui contiennent de vraies erreurs qui peuvent être corrigées. Au lieu de faire des modifications pointilleuses, comme supprimer ou ajouter un espace ou modifier les liens de fedoraproject.org vers www.fedoraproject.org (le premier étant conseillé), essayez de trouver les erreurs de frappe, de grammaire ou de ponctuation qui pourraient être corrigées. De plus, lorsque vous corrigez une erreur minime, marquez la modification comme étant une "Modification mineure" en utilisant la case à cocher appropriée lors de la sauvegarde.

Éviter de renommer les pages ou de déplacer les contenus sans coordination

Les pages wiki sont généralement référencées et liées à des emplacements variés. Il est important de vous coordonner avec les groupes appropriés avant de déplacer les contenus ou de renommer les pages existantes. Si vous souhaitez discuter du déplacement d'un objet particulier, adressez-vous à l'équipe Sites Web .

Suivre les idéologies considérées importantes par Fedora

Par exemple, essayez de rester neutre et amical surtout pour les utilisateurs non-techniques nouveaux au monde de Linux et Fedora. Les utilisateurs peuvent utiliser GNOME, KDE, le terminal ou d'autres environnements de bureau. Gardez cela en tête lors de l'écriture des instructions. Assurez-vous que la dévotion de Fedora à la technologie des logiciels libres soit proprement représenté.

Signer vos pièces jointes

Lorsque vous attachez un fichier à une page wiki, vous devez créer une signature détachée avec votre clé GPG. Certains formats de fichier, comme les paquets RPM, supportent les clés GPG ; dans ce cas vous n'avez pas besoin de créer une signature détachée -- une signature dans le fichier sera suffisante. Une signature détachée peut être attachée à la page contenant la pièce jointe originelle ou être incluse à la page-même.

Les signatures GPG permettent aux autres utilisateurs de vérifier l'authenticité de votre fichier téléchargé en s'assurant qu'il n'a été ni modifié ni corrompu. Ils ne violent aucunement votre vie privée, ils permettent aux autres d'avoir confiance en l'origine de vos fichiers.

Les images et les documents simples laissés sans signature sont sûrs, mais il n'y aucun mal à en ajouter une afin de vérifier que vous en êtes l'auteur.

Si vous n'avez pas de clé GPG ou si vous voulez en savoir plus, consultez la page Cryptographie .

Réviser vos changements en quête d'erreurs

Peu importe que vous soyez un rédacteur émérite, ou que votre utilisation de la langue Française ne soit pas correcte, invitez quelqu'un à vous relire. Les documents bien écrits sont très importants pour l'image de Fedora. Même les meilleurs écrivains sont sujets aux erreurs de frappe ou autres. Prenez un moment pour réviser vos changements afin de détecter les erreurs minimes.

Fedora est une communauté

Lors de la rédaction de contenu, pour le wiki ou ailleurs, rappelez-vous que Fedora est une communauté. Nous fonctionnons comme un groupe unifié se dirigeant vers un but commun. Nous n'avons pas besoin de distinguer un groupe ou une classe d'un autre. Par exemple, il n'est pas besoin de distinguer les contributeurs travaillant pour Red Hat et ceux qui n'en font fait pas partie. Tous les contributeurs font partie de la même communauté. Il existe quelques cas où la classification est nécessaire, mais ils peuvent être évités d'une façon ou d'une autre.

Si vous n'êtes pas sûr du sujet, demandez

Les autres membres de la communauté seront heureux de vous assister. Le canal #fedora-websites (en) sur freenode est la meilleure place pour discuter du wiki et des autres sites web de Fedora.

Modifier avec MoinMoin

L' aide en ligne peut être une ressource de valeur lorsque vous apprenez à modifier des pages wiki. En révisant ces pages d'aide, vous apprendrez de nouvelles astuces. Vous devriez les consulter au moins une fois, ces pages seront toujours disponibles comme référence. Vous pouvez poser des questions concernant la modification sur le canal #fedora-websites(en) sur freenode.net .

Astuces

Ce sont les principes de base dont vous aurez besoin pour la modification du wiki.

Les pages écrites pour le Projet Documentation ont des exigences additionnelles.
Pour plus d'information sur la rédaction de documents brouillons, référez-vous à Écrire un document Wiki .

Apprendre par un exemple

L'un des meilleurs moyens d'apprendre à modifier un wiki est de consulter le code des pages existantes. Cela est facile à faire :

  1. Trouvez une page dont vous souhaitez voir la source,
  2. Sur la barre de navigation, trouvez la liste déroulante 'Autres Actions:' et déroulez-là,
  3. Choisissez l'option 'Voir le code source'.

Le wiki affichera la forme textuelle de cette page. Ceci est particulièrement valable à l'apprentissage de certaines astuces utilisées par les éditeurs avancés du wiki. Ces astuces sont valables parce qu'elles vous permettent d'effectuer des actions intéressantes, puissantes et uniques auxquelles vous n'auriez jamais pensé. Vous pouvez les essayer sur des pages comme FedoraPrincipal .

Lier

Lier est peut-être la chose la plus simple et la plus difficile dans MoinMoin. La forme simple de liaison implique les noms wiki. Les noms wiki sont deux ou plusieurs mots combinés écrits avec une majuscule. Lors de la création du NomWiki, il n'y aucun besoin de marqueurs spéciaux, le lien sera créé automatiquement.

Afin d'éviter qu'un lien soit créé lorsque vous n'en voulez pas, vous devez recourir à quelques astuces audacieuses. Le moyen le plus simple est de placer deux accents graves entre les MotsWiki comme ceci: MotsWiki qui "brise" sûrement la routine du wiki sur l'automatisme de liaison des mots. Si vous avez besoin de lier à une sous-page qui n'est pas un nom wiki, vous pouvez utiliser une syntaxe comme Une Sous-Page du Projet ou simplement ["Nomdepage"] .

Évitez de placer les liens aux autres sites à l'intérieur du paragraphe. Expliquez plutôt le site web dans votre texte et écrivez l'adresse URL du lien sur une ligne séparée. Cela rend l'adresse URL lisible lorsque la page est imprimée ou convertie à un autre format. Par exemple:

Visitez le site web de documentation de la version récente avant de commencer.

[http://fedora.redhat.com/docs/] 

Pour plus de détails, voir AideDeLaCréationDeLiens .

Listes

Les listes à points et numériques sont simples et utiles. Consultez AideDesListes pour leur utilisation.

Tables

Les tables peuvent être compliquées parce qu'elles peuvent ne pas agir comme vous prévoyez. Les tables larges sont pénibles parce qu'elles se répandent au delà des bordures lorsqu'elles sont vues dans une petite fenêtre de navigateur. Le meilleur conseil est d'utiliser les tables uniquement si nécessaires. Lors de gestion d'un grand nombre de petites informations, elles économisent l'espace. Testez-les minutieusement si vous les utilisez. Rappelez-vous que certains utilisateurs peuvent disposer d'une plus petite résolution que vous. Pour plus d'informations, consulter AideDesTables (en).

Notes, Astuces et Boîtes de texte

Ils sont collectivement connus comme admonitions. Pour faire un paragraphe en admonition, entrez les || au début et à la fin du paragraphe, mettez le titre en gras tout en commençant avec une icône appropriée et incluez les informations au deuxième paragraphe:

{{Admon/tip | Ceci est un exemple d'astuce. | Voici l'information sur cette astuce avec plus d'informations qui fournissent une idée sur le titre informatif du paragraphe initial.}}

| Ce titre résume l'astuce. | Voici plus d'information sur cet astuce.}}

Séparez le premier du deuxième paragraphe par un espace, pour vous assurer que la boîte s'aligne correctement.

Voici les types standards d'admonitions :

  • L'icône de note
  • L'icône d'astuce
  • L'icône d'attention
  • L'icône d'importance
  • L'icône d'avertissement

Référez-vous au guide de documentation Fedora pour les description des types d'admonition :

http://fedora.redhat.com/participate/documentation-guide/s1-xml-admon.html (en)

Marquer les Termes techniques

Utilisez les accents graves pour marquer les noms des applications, des fichiers, des répertoires, des logiciels, des comptes utilisateurs et d'autres mots ayant des significations techniques. Ces mots marqués seront affichés en police à chasse fixe.

Utilisez deux apostrophes pour marquer le nom des objets du menu et d'autres éléments de l'interface graphiques. Ces mots marqués seront affichés en italique.

Termes Marques Formatés en Exemple
Noms des applications graphiques caractères gras gras Firefox
Fichiers, répertoires accent grave police à chasse fixe /usr/bin/firefox
Paquetages accent grave police à chasse fixe firefox-1.2.3
Compte utilisateurs accent grave police à chasse fixe NomUtilisateur
Autres mots ayant une signification technique accent grave police à chasse fixe com.redhat.someJava.classname
Menus graphiques et objets double apostrophe italique Applications > Internet > Navigateur Firefox
Autres GUIs ou Éléments Web d'interface utilisateur double apostrophe italique ... cliquez sur bouton Soumettre ...
Commande en ligne et démons 3 accolades police à chasse fixe grep httpd pour trouver les PIDs des processus exécutables de httpd .
Contenu en ligne des fichiers de configuration... accent grave police à chasse fixe ... Ensuite, changez les paramètres DefaultIcon dans /etc/httpd/conf/httpd.conf en ...
Premier terme, terme de glossaire double apostrophe italique ... Firefox est un exemple d'interface graphique ou GUI.
Touches [Touche] [crochets gras] Appuyez sur la touche [Entrée] ...

Par exemple:

Le paquetage  <code>thunderbird</code> installe l'application de courriel '''Mozilla Thunderbird'''. Pour démarrer '''Thunderbird''', choisissez: ''Applications > Internet > Courriel Thunderbird''.

Ce qui produit:

Le paquetage thunderbird installe l'application de courriel Mozilla Thunderbird. Pour démarrer Thunderbird, choisissez: Applications > Internet > Courriel Thunderbird.

Écrire des exemples de commandes

Les exemples de commandes sont une ou plusieurs commandes séparées du corps de l'explication. Encadrez les exemples avec trois accolades :

{{{
su -c 'yum install awesome-application'
}}}

Entrez le mot de passe <code>root</code>.

Ce qui produit :

su -c 'yum install awesome-application'

Entrez le mot de passe root.

Les utilisateurs ne doivent pas utiliser le compte root
De nombreuses commandes exigent les privilèges root. Les lecteurs ne doivent pas se connecter à leur système comme root et vous devez spécifier soit su -c, soit su - lors de l'explication de telles commandes.

Créer de nouvelles pages dans le Wiki

Le Wiki du Projet Fedora est énorme donc il y a un besoin de maintenir une hiérarchie propre et une organisation. Le meilleur moyen de les apprendre est de réviser les Sous Pages et HelpOnCategories (en), puis revoir les dispositions existantes du wiki.

Les noms redondants (comme/Foo/FooBar/FooBarGrue) doivent être évités. Rappelez-vous qu'inclure 'Fedora' dans le nom de page est redondant. Les projets majeurs de Fedora n'ont pas besoin d'avoir 'Projet' dans leur nom de page. Par exemple, le Projet Sites Web de Fedora a sa page nommée 'SitesWeb' non 'ProjetSitesWebFedora'.

Dans la plupart des cas, les pages doivent être groupées comme sous-pages au projet ou programme dont elles font parties. Les catégories sont généralement créées pour les projets et les programmes différents ; elles doivent être utilisées avec parcimonie. Les pages que vous créez doivent faire partie d'une catégorie et beaucoup devraient aussi posséder un signet approprié. Si vous pensez créer une nouvelle catégorie ou un nouveau signet, veuillez demander un conseil à l'équipe SitesWeb .

Si vous avez des questions, adressez-vous à l'équipe SitesWeb .

Pages importantes

Les pages-clés comme FedoraPrincipal doivent être judicieusement modifiées. Les changements de ces pages doivent être généralement discutés dans les listes de diffusions ou sous un IRC avant d'appliquer. Les pages spéciales comme ModificationsRécentes ne doivent pas être modifiées. Certaines parties de wiki peuvent avoir des permissions différentes. Par exemple, ProjetDocs a une section de création de nouvelles documentations quelque peu restreinte. Pour obtenir l'accès de modification, vous devez compléter des étapes additionnelles. Vous pourrez généralement trouver des instructions sur ces pages.

MoinMoin a plusieurs pages internes importantes pour ses propres opérations. Ces pages sont généralement marquées dans les sources et ne doivent pas être modifiées. Les modifications sur ces pages sont détruites par les mises à jours du logiciel MoinMoin.

Obtenir de l'aide

Si vous avez des questions sur les modifications du wiki du Projet Fedora ou si vous avez besoin d'aide, adressez-vous à l'équipe de SitesWeb . Ils ont un canal IRC et une liste de diffusion tous deux efficaces pour obtenir les réponses dont vous avez besoin.

Si vous désirez effectuer beaucoup de modifications sur le wiki, rejoignez l'équipe SitesWeb .