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:
- 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.
- 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.
.png){kind=small}
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.
- 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 .
- 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.
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.
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.
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 :
- Trouvez une page dont vous souhaitez voir la source,
- Sur la barre de navigation, trouvez la liste déroulante 'Autres Actions:' et déroulez-là,
- 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: Mots 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 Wiki 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 | |
police à chasse fixe |
/usr/bin/firefox
|
| Paquetages | |
police à chasse fixe |
firefox-1.2.3
|
| Compte utilisateurs | |
police à chasse fixe |
NomUtilisateur
|
| Autres mots ayant une signification technique | |
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 | |
police à chasse fixe |
grep httpd pour trouver les PIDs des processus exécutables de httpd .
|
| Contenu en ligne des fichiers de configuration... | |
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.
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 .