MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Important : Cette traduction est obsolète et doit être mise à jour par rapport à l'article anglais.

Les deux tâches les plus courantes sur MDN et qu'un beau jour tout contributeur est amené à réaliser sont la création et la modification d'un document. Cet article couvre les aspects les plus basiques de chacune de ces tâches.

Modification d'une page existante

C'est très facile de modifier une page :

  • Il suffit de cliquer sur le bouton « Modifier » en haut à droite de la page.
  • La page se recharge avec des options de formatage de sorte que vous pouvez ensuite ajouter ou supprimer de l'information directement sur la page.
  • Vous pouvez ajouter des paragraphes, supprimer du texte, ajouter des en-têtes et bien plus encore. Consulter le guide de Editor UI elements du Guide du rédacteur pour plus d'information sur l'utilisation de l'éditeur intégré de MDN.

Prévisualiser les modifications

Afin de voir les modifications :

  • Cliquez sur le bouton  « Aperçu des modifications » (dans la fonction de modification) au-dessus du titre.
  • Une page de prévisualisation comprenant vos révisions s'ouvre dans un nouvel onglet ou une nouvelle fenêtre.
  • Chaque fois que vous cliquez sur le bouton, la page de prévisualisation est rafraîchie pour faire apparaître les dernières modifications.

Attention ! La prévisualisation d'une page ne sauvegarde pas vos modifications en cours, donc pensez à laisser ouvert votre onglet de modification.

Commentaire de révision

Après avoir prévisualisé vos modifications, vous devrez enregistrer votre révision. Le champ de commentaire de révision se situe sous la section d'édition. Avant de sauvegarder, laissez un commentaire afin d'informer les autres contributeurs de la raison de vos modifications.

Par exemple, vous pourriez avoir ajouté une nouvelle section, ou modifié quelques mots pour unifier la terminologie, réécrit un paragraphe ou retiré de l'information car elle faisait doublon.

Étiquettes

Vous pouvez ajouter ou retirer des étiquettes qui décrivent le contenu de la page. Le champ pour les modifier est situé au-dessus du commentaire de révision. Voir Règles d'étiquetage pour MDN pour vous informer des usages des étiquettes sur MDN.

Besoin d'une vérification ?

Si un expert ou un contributeur expérimenté doit vérifier vos modifications, vous pouvez demander une vérification technique (pour le code, les APIs ou les technologies), une vérification éditoriale (pour la qualité d'expression, la grammaire et les coquilles) ou une vérification de macro (pour le code KumaScript) en vous assurant que la case appropriée est cochée avant de sauvegarder.

Attacher des fichiers

Si vous souhaitez attacher un fichier à une page existante pour inclure une illustration ou apporter un éclaircissement, vous pouvez l'ajouter en vous rendant en bas de la page.

When uploading an image, please be sure to use an image optimization tool to make the file as small to download as possible. This improves page load time and helps MDN's performance overall. You may use your preferred tool, if you have one. Otherwise, we suggest TinyPNG, a handy Web tool.

Publier, annuler ou poursuivre l'édition

Lorsque vous avez fini les modifications et êtes satisfaits de la prévisualisation, vous pouvez enregistrer votre travail et vos commentaires en cliquant sur le bouton vert « Enregistrer les modifications » à droite du titre ou en haut de la page. Si vous voulez continuer, cliquez sur « Enregistrer et continuer », ce qui enregistrera vos modifications tout en conservant l'interface de modification ouverte.

Si vous changez d'avis et voulez annuler vos modifications, cliquez sur le bouton rouge « Annuler les modifications » à droite du titre. Les annulations de modification sont définitives.

Appuyer sur Entrer dans le champ de commentaire de révision revient àcliquer sur Enregistrer et continuer.

En tentant de sauvegarder votre page, vos modifications peuvent être refusées et considérées comme non valides alors que le contenu est en fait correct pour MDN. Dans ce cas, vous pouvez adresser un email à l'équipe d'administrateurs de MDN pour obtenir de l'aide pour publier votre contenu.

Obtenir des autorisations de création de pages

Pour des raisons de sécurité, les nouveaux comptes ne peuvent avoir la possibilité de créer de nouvelles pages. Dans le cas d'un essai, une page vous informant de la manière de procéder apparaîtra. Deux cas se présentent :

  • Demander que la page soit créée pour vous. A cette fin, vous remplirez un fichier de rapport d'erreur avec le sujet suivant "Create page: <page title>". Assurez-vous de remplir le champ URL avec l'emplacement précis sur MDN de l'endroit où vous voulez placer la page, si vous le connaissez déjà. Il est important de préciser dans le texte de commentaire la raison pour laquelle vous voulez créer la page.
  • Solliciter une autorisation de création de page. Dans le cas où une autorisation de création de page vous est accordée, vous aurez la possibilité d'ajouter de nouvelles pages en suivant les instructions suivantes. Afin d'accéder à cette autorisation, il vous faudra en faire la demande par email à l'équipe d'administrateurs de MDN en précisant le sujet. N'oubliez pas d'indiquer votre nom d'utilisateur, la raison de votre demande de création de page (par exemple, vous documentez une nouvelle API qui requiert de nouvelles pages, ou vous souhaitez ajouter de nouveaux termes à un glossaire). Deux conditions néanmoins s'imposent : avoir déjà contribué de manière utile et depuis un certain temps (l'un et l'autre étant considérés ensemble, il n'y a pas de période de temps déterminée).

Créer une nouvelle page

Dès que vous avez obtenu l'autorisation, vous pouvez créer de nouvelles pages.

Si vous ne savez pas où intégrer un nouvel article, pas de problème ! Mettez-le où vous voulez. Nous le retrouverons et le déplacerons à l'endroit le plus pertinent, ou nous le fusionnerons dans un texte existant si c'est plus judicieux. Vous n'aurez pas non plus à vous préoccuper qu'il soit parfait. Nos gnomes serviables et mordus se feront un plaisir de rendre votre contenu net et séduisant.

Il existe plusieurs manières de créer une nouvelle page :

  • lien vers une "page manquante"
  • nouvelle page sans lien
  • page secondaire d'une page actuelle
  • copie d'une page actuelle
  • lien à partir d'une page actuelle

Lien vers une "page manquante"

Comme pour la plupart des wikis, il est possible sur MDN de créer un lien vers une page qui n'existe pas encore. Par exemple, un auteur pourrait créer une liste de tous les membres d'une API avant de créer les pages pour ces membres. Sur MDN, les liens vers ces pages inexistantes sont habituellement affichées en rouge.

Pour créer une page à partir d'un lien vers une "page manquante" :

  1. Vérifiez que vous êtes connecté à MDN et que vous avez l'autorisation de créer des pages. (Si vous êtes déconnecté, vous obtiendrez un message d'erreur "404 (page not found)" en cliquant sur le lien vers une page manquante.)
  2. Cliquez sur le lien vers la "page manquante". Autorisé à créer une page, le guide du rédacteur s'ouvre, vous permettant de créer la page manquante.
  3. Rédigez votre page et enregistrez-la.

Nouvelle page sans lien

Pour créer une nouvelle page sans lien avec une autre page, entrez un nom de page unique dans le champ URL de votre navigateur. Par exemple, si vous entrez :

https://developer.mozilla.org/en-US/docs/FooBar

MDN crée une nouvelle page intitulée "FooBar". L'éditeur s'ouvre et vous permet d'intégrer du contenu à la nouvelle page. Vous pouvez vous reporter à la section Modifier une page existante de ce même article pour savoir comment utiliser le mode éditeur.

  1. Vérifiez que vous êtes connecté et que vous avez l'autorisation de créer des pages.
  2. Entrez ceci dans le champ URL de votre navigateur.
https://developer.mozilla.org/en-US/docs/new

MDN crée une nouvelle page avec un emplacement pour le titre, et ouvre l'éditeur qui vous permet d'intégrer du contenu à la nouvelle page. Vous pouvez vous reporter à la section Modifier une page existante de ce même article pour savoir comment utiliser le mode éditeur.

Page secondaire d'une page actuelle

En utilisant l'option « Nouvelle sous-page », vous créez une page qui sera une page « fille » de la page actuelle dans la hiérarchie.

Copie d'une page actuelle

En utilisant l'option « Cloner cette page », vous copiez le contenu de la page courante et créez une nouvelle page ayant le même parent que votre page servant de modèle.

Lien à partir d'une page actuelle

 

Enfin, en suivant un lien vers une page qui n'existe pas encore, vous serez invité à la traduire ou à la créer.

Lien vers les différents types de pages.

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : ysabelm, SphinxKnight, diedy70, pi_free, Delapouite, tregagnon, FredB
 Dernière mise à jour par : ysabelm,