nodejs.org

Веб-сайт Node.js, созданный с использованием Next.js с TypeScript, модулями CSS/Tailwind и MDXv3.

Что это за репо?

Nodejs.org, созданный OpenJS Foundation, является официальным сайтом среды выполнения JavaScript Node.js®. Этот репозиторий является исходным кодом веб-сайта. Он построен с использованием Next.js, React Framework.

npm ci
npm run dev

# listening at localhost:3000 

Содействие

В этом проекте принят Кодекс поведения Node.js.

Приглашаем всех желающих внести свой вклад в развитие сайта! Пожалуйста, прочитайте Руководство по участию и ознакомьтесь с дизайном Figma, чтобы лучше понять структуру этого репозитория.

Важный

Пожалуйста, прочтите наши Рекомендации по переводу, прежде чем участвовать в переводе и локализации веб-сайта.

Примечание

Мы рекомендуем прочитать все соответствующие ссылки ниже, прежде чем вносить изменения в код; Включая изменения зависимостей, изменения контента и изменения кода.

Развертывание

Веб-сайт автоматически развертывается в Vercel посредством интеграции приложения GitHub, когда в main ветке происходят новые отправки.

Подробная информация о развертывании доступна только сопровождающим команды веб-сайта из-за определенных ограничений.

Текущая интеграция принадлежит OpenJS Foundation и управляется командой веб-сайта.

Устаревшее развертывание

Полная настройка находится в https://github.com/nodejs/build/tree/master/ansible/www-standalone, за исключением секретов и сертификатов.

Для этого проекта вебхук настроен на GitHub и взаимодействует с небольшим сервером Node на хосте, который и выполняет всю работу. Для этого обратитесь к пакету github-webhook.

Бинарные файлы Node.js и документация по API

Этот репозиторий не содержит кодовой базы или связанной с ней инфраструктуры, которая обслуживает https://nodejs.org/api/ , https://nodejs.org/docs/ или https://nodejs.org/dist/ .

Они хранятся в разных репозиториях, и мы призываем пользователей открывать проблемы в своих соответствующих репозиториях , чтобы получать отчеты об ошибках, запросы функций или любые другие вопросы, связанные с этими конечными точками.

• release-cloudflare-worker : база кода, отвечающая за обслуживание двоичных файлов дистрибутива Node.js, документации API и любых других ресурсов по ссылкам, упомянутым выше.
  • Мы используем бакеты Cloudflare R2 для хранения наших активов и работники Cloudflare для предоставления этих активов в Интернет.
• node/doc/api : исходный код нашей документации API, он содержит все файлы Markdown документации Node.js API.
  • node/doc содержит шаблоны HTML, стили CSS и код JavaScript, который запускается на стороне клиента страниц, созданных нашими документами API.
  • node/tools/doc содержит инструменты, которые проверяют, анализируют, создают и компилируют нашу документацию по API. Также отвечает за создание того, что вы видите при доступе к https://nodejs.org/api/ .

Соответствующие ссылки

Нормы поведения

Рекомендации по внесению взносов

Руководство для соавторов

Фигма Дизайн

Контент против кода

Закрепление зависимостей

Рекомендации по переводу

Страница состояния веб-инфраструктуры Node.js.

Спасибо

• Спасибо всем участникам и сотрудникам, которые сделали этот проект возможным.
• Спасибо Chromatic за предоставление платформы визуального тестирования, которая помогает нам просматривать изменения пользовательского интерфейса и выявлять визуальные регрессии.
• Благодарим Vercel за предоставление инфраструктуры, которая обслуживает и поддерживает веб-сайт Node.js.
• Спасибо Cloudflare за предоставление инфраструктуры, которая обслуживает веб-сайт Node.js, CDN Node.js и многое другое.
  • Очень теплое спасибо Cloudflare, поскольку мы не смогли бы служить нашему сообществу без их огромной поддержки.
• Благодарим Sentry за предоставление лицензии с открытым исходным кодом для инструментов отчетов об ошибках, мониторинга и диагностики.
• Спасибо Crowdin за предоставление платформы, которая позволяет нам локализовать веб-сайт Node.js и сотрудничать с переводчиками.
• Спасибо компании Orama за предоставление поисковой платформы, которая индексирует наш обширный контент и обеспечивает молниеносные результаты для наших пользователей.