La plupart des contributeurs MDN :

  • Modifient des pages existantes
  • Créent de nouvelles pages.

Cet article présente ces tâches.

Modification d'une page existante

C'est très facile de modifier :

  • cliquer sur le bouton « Modifier » en haut à droite de la page.
  • La page se charge avec des options de formatage, ainsi 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 réaliser les autres fonctions de base en écriture et en modification. Consulter le Guide d'édition pour plus d'information sur l'utilisation de l'éditeur intégré de MDN.

Prévisualiser les modifications

Pour voir à quoi ressemblent vos modifications :

  • Cliquez sur le bouton  « Aperçu » (dans la fonction de modification) au-dessus du titre.
  • Cela ouvre une page de prévisualisation comprenant vos révisions, dans une nouvelle fenêtre ou un nouvel onglet.
  • Chaque fois que vous cliquez sur le bouton, cela actualise votre page de prévisualisation avec vos dernières modifications.

Attention ! La prévisualisation d'une page ne sauvegarde pas vos modifications en cours, donc n'oubliez pas de fermer l'onglet ouvert pour revenir aux modifications.

Commentaire de révision

Après avoir prévisualisé vos modifications, vous souhaiterez enregistrer votre révision. Avant votre sauvegarde, recherchez la zone de commentaire en pied de page et déposez un commentaire pour informer les autres contributeurs de la raison de vos modifications. Par exemple, vous avez peut-être ajouté une nouvelle section, ou changé quelques mots pour améliorer la cohérence de la terminologie, réécrit un paragraphe pour clarifier le texte ou retiré de l'information car elle était redondante.

Table des matières

La section "Dans cet article" d'un article est une liste de liens générés automatiquement pour les rubriques de la page. Le texte de ces liens peut être modifié en éditant les titres. Il est aussi possible de supprimer la table des matières ou de réduire le nombre de liens en sélectionnant "Modifier le titre et les propriétés" et changer la valeur dans le menu déroulant.

Étiquettes

Vous pouvez ajouter ou retirer des étiquettes qui décrivent le contenu et la fonction de la page sous la section modification. Voir Règles d'étiquetage pour MDN pour vous informer sur l'utilisation des étiquettes.

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 syntaxe, la grammaire et le contenu) 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.

Lorsque vous téléchargez une image, assurez-vous d'utiliser un outil d'optimisation d'image pour rendre le fichier aussi petit que possible. Cela améliore le temps de chargement de la page et aide les performances de MDN dans l'ensemble. Vous pouvez utiliser votre outil préféré, si vous en avez un. Sinon, nous suggérons TinyPNG, un outil Web pratique

Publier, annuler ou poursuivre l'édition

Lorsque vous avez fini les modifications et êtes satisfait de la prévisualisation, vous pouvez publier votre travail et vos commentaires en cliquant sur le bouton vert « Publier  » à droite sous le titre ou en pied de page. Si vous voulez continuer, cliquez sur « Publier et poursuivre l'édition », ce qui enregistrera vos modifications tout en conservant l'interface ouverte.

Si vous changez d'avis et voulez annuler vos modifications, cliquez sur le bouton rouge « Supprimer » à droite du titre. À noter : la suppression est définitive.

Appuyer sur Entrer dans le champ de commentaire de révision revient à cliquer sur Publier et poursuivre l'édition.

Si vous essayez d'enregistrer votre page et que vos modifications sont refusées comme non valides, alors que le contenu est en fait correct pour MDN, vous pouvez adresser un email à l'équipe d'administrateurs de MDN pour obtenir de l'aide afin de publier votre contenu.

Obtenir des autorisations de création de pages

Pour des raisons de sécurité, les nouveaux comptes ne peuvent  créer de nouvelles pages. Si vous essayez, vous verrez une page vous informant de la manière de procéder. Deux options :

  • 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 où vous voulez placer la page, si vous le savez. Vous devez préciser dans le texte de commentaire la raison pour laquelle vous voulez créer la page.
  • Demander les droits de création de page. Si vous demandez les droits de création de page et qu'ils vous sont accordés, vous aurez la possibilité d'ajouter de nouvelles pages vous-mêmes, en suivant les instructions suivantes. Pour demander ces droits, 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 droits de création de page (par exemple, vous documentez une nouvelle API qui requiert de nombreuses nouvelles pages, ou vous souhaitez ajouter de nouveaux termes au glossaire). Vous devrez avoir déjà contribué utilement au contenu du site et être contributeur depuis un certain temps (l'un et l'autre étant considérés ensemble, il n'y a pas de délai préfixé).

Créer une nouvelle page

Dès que vous avez obtenu les droits de création de page, vous pouvez créer de nouvelles pages.

Si vous ne savez pas où intégrer un nouvel article, ne vous inquiétez pas ! Mettez-le n'importe où, nous le trouverons 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 existante
  • clone d'une page existante
  • lien à partir d'une page existante

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 les droits de création de pages. (Si vous êtes déconnecté, vous obtiendrez un message d'erreur "404 (page not found)").
  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" et ouvre l'éditeur avec lequel vous pouvez ajouter le contenu de la nouvelle page. Vous pouvez vous reporter à la section Modification d'une page existante de ce même article pour savoir comment utiliser le mode éditeur.

Pour créer une nouvelle page sans lien avec une autre page :

  1. Vérifiez que vous êtes connecté et avez les droits de création de 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 Modification d'une page existante de ce même article pour savoir comment utiliser le mode éditeur.

Page secondaire d'une page existante

Pour créer une page que vous voulez en-dessous, dans la hiérarchie, d'une page existante :
 

  1.  Sur la page "parent", cliquez sur le menu Avancé (l'icône de l'engrenage dans la barre d'outils), puis cliquez sur Nouvelle sous-page. Une vue éditeur s'ouvre pour créer un nouveau document.
  2. Tapez un titre pour le document dans le champ Titre.    
  3. Changez le champ Slug si nécessaire (par exemple, si le titre est très long et que vous souhaitez une URL plus courte). Ce champ est automatiquement rempli par l'éditeur, en remplaçant les espaces du titre par les caractères de soulignement. Dans ce cas,  vous ne pouvez modifier que la dernière partie de l'URL du document.    
  4. Dans le champ TOC, sélectionnez les niveaux de titre que vous souhaitez afficher automatiquement dans la table des matières de la page ou «Pas de table des matières» si la page n'en a pas besoin.    
  5.  Écrivez le contenu de la page dans l'éditeur et enregistrez vos modifications. Reportez-vous à Modification d'une page existante de ce même article pour savoir comment utiliser le mode éditeur.

Clone d'une page existante

S'il existe une page comportant les formats que vous souhaitez pour votre nouvelle page, vous pouvez "cloner" cette page et en changer le contenu.

  1. Sur la page d'origine, cliquez sur le menu Avancé (l'icône de l'engrenage dans la barre d'outils), puis cliquez sur Cloner cette page. Une vue éditeur s'ouvre pour créer un nouveau document.
  2. Changez le titre de la page approprié au nouveau contenu. Le champ Slug est mis à jour automatiquement lorsque vous modifiez le champ Titre.     
  3. Si nécessaire, modifiez une partie du chemin du champ Slug, pour placer le nouveau document dans une partie différente de la hiérarchie des documents. (Dans la plupart des cas, cela n'est pas nécessaire, car la page clonée a un contenu similaire à l'original, et doit donc être située dans un endroit similaire.)     
  4. Dans le champ TOC, sélectionnez les niveaux de titre que vous souhaitez afficher automatiquement dans la table des matières de la page ou «Pas de table des matières» si la page n'en a pas besoin.    
  5. Écrivez le contenu de la page dans l'éditeur et enregistrez vos modifications. Reportez-vous à Modification d'une page existante de ce même article pour savoir comment utiliser le mode éditeur.

Lien à partir d'une page existante

Cette méthode est une sorte d'hybride. Vous pouvez créer un lien sur une autre page, puis cliquer sur le lien que vous venez d'ajouter pour créer la nouvelle page.

  1. Entrez le nom de la nouvelle page n'importe où (ce qui fait sens) dans le texte d'une page existante.
  2. Sélectionnez le nom et cliquer sur le l'icône lien () dans le menu de l'éditeur. La boîte de dialogue "mise à jour du lien" s'ouvre avec le texte en surbrillance dans le champ "lien vers".
  3. "/en-US/docs/"  est inséré par défaut au début du champ URL. Entrez le nom de la page après "/en-US/docs/" . (Le nom de la page ne doit pas être identique au texte du lien).
  4. Cliquez sur OK pour créer et insérer le lien.

Si la page n'existe pas encore, le lien est affiché en rouge. Si la page existe déjà, le lien est affiché en bleu. Si vous souhaitez créer une nouvelle page, mais le titre de la page souhaité est déjà pris, vérifiez d'abord s'il est plus logique d'aider à modifier et à améliorer la page qui existe déjà. Sinon, pensez à un titre différent pour votre nouvelle page et créez ce lien. Reportez-vous au guide de dénomination de la page pour les instructions.

Pour ajouter le contenu de votre nouvelle page, cliquez sur le lien rouge que vous venez de créer (après avoir sauvegardé et fermé l'éditeur). La nouvelle page s'ouvre en mode éditeur, et vous pouvez commencer à écrire. Reportez-vous à la section Modification d'une page existante de cemême article pour savoir comment utiliser le mode éditeur.

Actualiser la page

Le support de MDN pour les macros KumaScript et la transcription de contenu d'une page à l'autre peut parfois être gêné légèrement par la nécessité de mettre en cache les pages générées pour des raisons de performance. Les pages sont construites à partir de leur source, et mises en cache pour les demandes futures. Dès lors, toutes les macros (modèles) ou les transcriptions (à l'aide de la macro Page) sur cette page ne reflèteront pas les modifications apportées à la macro ou le contenu transféré.

  • Pour mettre à jour une page manuellement, vous pouvez forcer un rafraîchissement dans votre navigateur. MDN détecte cela et déclenche une reconstitution de page, extrayant la mise à jour de la macro et le contenu de la page.
  • Vous pouvez également configurer les pages pour être reconstruites périodiquement automatiquement. Cela ne devrait pas être nécessaire à moins que vous ne vous attendiez à ce que la page nécessite une mise à jour fréquente. Voir la régénération de la page pour plus de détails

Voir aussi

Étiquettes et contributeurs liés au document

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