Créer et modifier des pages

Cet article est destiné à présenter aux personnes souhaitant contribuer à MDN le processus de modification de pages existantes et de création de nouvelles pages.

Note : Le contenu de MDN s'organise au sein de deux dépôts Git : mdn/content avec le contenu en anglais et mdn/translated-content avec le contenu traduit (y compris en français). C'est le dépôt mdn/content qui constitue la référence. Si vous souhaitez créer une page en français, celle-ci devra au préalable avoir été créée en anglais.

Modifier une page existante

Pour modifier une page, vous devez trouver la page source :

.

La façon la plus rapide de la trouver est d'aller sur la page que vous souhaitez modifier, puis de vous rendre en bas de cette page et enfin de cliquer sur le lien « Source on GitHub ».

Une fois que vous avez trouvé la source à modifier, rendez-vous sur notre fichier README et parcourez notre guide sur la contribution (en anglais). Vous pouvez également consulter ce billet en français pour savoir comment contribuer.

Prévisualiser vos modifications

SI vous modifiez la page en local, vous pouvez voir à quoi ressembleront vos modifications en allant sur le dossier du dépôt nommé content, en exécutant la commande CLI yarn start, puis en vous rendant à l'URL localhost:5000 dans votre navigateur, et enfin en retrouvant la page sur laquelle vous travaillez. Pour la trouver plus facilement, utilisez la boîte de recherche. La page que vous prévisualisez sera rafraîchie automatiquement au fur et à mesure que vous modifiez son code source.

Ajouter des pièces jointes

Pour ajouter un fichier en pièce jointe à votre article, vous avez simplement besoin de l'inclure dans le même répertoire du fichier index.html de votre article, puis de l'ajouter dans votre page, typiquement à l'aide d'un élément <a>.

Créer une nouvelle page

Pour créer une nouvelle page, consultez les instructions fournies sur la documentation concernant l'ajout de nouveaux documents (en anglais).

Attention : Pour créer une page en français (ou dans une autre langue), celle-ci devra préalablement exister/avoir été créée en anglais.

Voir aussi