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 :
- Si elle est en anglais : sur notre dépôt content content
- Si elle est en français ou dans une autre langue : sur notre dépôt translated-content translated-content
.
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:5042 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.