nodejs.org

Site Web Node.js créé à l'aide de Next.js avec TypeScript, modules CSS/Tailwind et MDXv3

C'est quoi ce dépôt ?

Nodejs.org de la Fondation OpenJS est le site Web officiel du runtime JavaScript Node.js®. Ce dépôt est le code source du site Web. Il est construit à l'aide de Next.js, un React Framework.

npm ci
npm run dev

# listening at localhost:3000 

Contribuer

Ce projet adopte le code de conduite Node.js.

Toute personne souhaitant contribuer au site Web est la bienvenue ! Veuillez lire les directives de contribution et consulter la conception Figma pour mieux comprendre la structure de ce référentiel.

Important

Veuillez lire nos directives de traduction avant de contribuer à la traduction et à la localisation du site Web.

Note

Nous vous recommandons de lire tous les liens pertinents ci-dessous avant de modifier le code ; Y compris les modifications de dépendance, les modifications de contenu et les modifications de code.

Déploiement

Le site Web est automatiquement déployé sur Vercel via son intégration de l'application GitHub lorsque de nouvelles poussées se produisent sur la branche main .

Les détails concernant le déploiement ne sont accessibles qu'aux responsables de l'équipe du site Web en raison de certaines limitations.

L'intégration actuelle appartient à la Fondation OpenJS et est gérée par l'équipe du site Web.

Déploiement hérité

La configuration complète se trouve sur https://github.com/nodejs/build/tree/master/ansible/www-standalone moins les secrets et les certificats.

Le webhook est configuré sur GitHub pour ce projet et communique avec un petit serveur Node sur l'hôte, qui effectue le travail. Voir le package github-webhook pour cela.

Documents binaires et API Node.js

Ce référentiel ne contient pas la base de code ou l'infrastructure associée qui dessert https://nodejs.org/api/ , https://nodejs.org/docs/ ou https://nodejs.org/dist/ .

Ceux-ci sont conservés dans différents référentiels et nous invitons les utilisateurs à ouvrir des tickets dans leurs référentiels respectifs , pour les rapports de bogues, les demandes de fonctionnalités ou toute question liée à ces points de terminaison.

• release-cloudflare-worker : La base de code chargée de servir les binaires de distribution Node.js, les documents API et tout autre actif à partir des liens mentionnés ci-dessus.
  • Nous utilisons les compartiments Cloudflare R2 pour stocker nos actifs et les Cloudflare Workers pour diffuser ces actifs sur le Web.
• node/doc/api : Le code source de nos documents API, il contient tous les fichiers Markdown de documentation de l'API Node.js
  • node/doc contient les modèles HTML, les styles CSS et le code JavaScript qui s'exécutent côté client de nos pages générées par API Docs.
  • node/tools/doc contient les outils qui valident, lint, construisent et compilent nos documents API. Également responsable de générer ce que vous voyez lorsque vous accédez à https://nodejs.org/api/ .

Liens pertinents

Code de conduite

Directives de contribution

Guide du collaborateur

Conception Figma

Contenu vs Code

Épinglage de dépendance

Directives de traduction

Page d'état de l'infrastructure Web Node.js.

Merci

• Merci à tous les contributeurs et collaborateurs qui rendent ce projet possible.
• Merci à Chromatic d'avoir fourni la plate-forme de tests visuels qui nous aide à examiner les modifications de l'interface utilisateur et à détecter les régressions visuelles.
• Merci à Vercel d'avoir fourni l'infrastructure qui sert et alimente le site Web Node.js
• Merci à Cloudflare d'avoir fourni l'infrastructure qui dessert le site Web de Node.js, le CDN de Node.js et bien plus encore.
  • Un merci très chaleureux à Cloudflare car nous ne serions pas en mesure de servir notre communauté sans leur immense soutien.
• Merci à Sentry d'avoir fourni une licence open source pour ses outils de rapport d'erreurs, de surveillance et de diagnostic.
• Merci à Crowdin d'avoir fourni une plateforme qui nous permet de localiser le site Web Node.js et de collaborer avec des traducteurs.
• Merci à Orama d'avoir fourni une plate-forme de recherche qui indexe notre vaste contenu et fournit des résultats ultra-rapides à nos utilisateurs.