content README

The project's README from github.com/mdn/content. As one markdown file: README.md.

Welcome to MDN Web Docs

github-profile

MDN Web Docs is an open-source, collaborative project that documents web technologies including CSS, HTML, JavaScript, and Web APIs. Alongside detailed reference documentation, we provide extensive learning resources for students and beginners getting started with web development.

MDN's mission

MDN's mission is to provide a blueprint for a better internet and empower a new generation of developers and content creators to build it.

The strength of MDN Web Docs lies in its vast community of active readers and contributors. Since 2005, approximately 45,000 contributors have created the documentation we know and love. Together, contributors have created over 45,000 documents that make up an up-to-date, comprehensive, and free resource for web developers worldwide.

In addition to English-language articles, over 35 volunteers lead translation and localization efforts for Chinese, French, Japanese, Korean, Portuguese, Russian, and Spanish.

Build the site

To set up the site locally, you need to have Node.js installed, which comes bundled with npm. You can check if these are installed by running the following commands:

node -v
npm -v

After you have installed Node.js, you can install the dependencies using npm install and start the local preview:

npm i
npm start

Once started, a live preview is available at http://localhost:5042/.

Contribute to MDN Web Docs

You can contribute to MDN Web Docs and be a part of our community through content contributions, engineering, or translation work. The MDN Web Docs project welcomes contributions from everyone who shares our goals and wants to contribute constructively and respectfully within our community.

To find out how to get started, see the CONTRIBUTING.md document in this repository. By participating in and contributing to our projects and discussions, you acknowledge that you have read and agree to our Code of Conduct, which means adhering to Mozilla's Community Participation Guidelines.

Get in touch

You can communicate with the MDN Web Docs team and community using the communication channels.

content (mdn/content)

Searching Database…

11.1K ·GitHub
Что это такое?Это официальный исходный репозиторий MDN Web Docs, в котором более 14 000 страниц справочной документации и обучающих материалов по HTML, CSS, JavaScript, HTTP и Web API.
Это исходный код сайта или только файлы с содержимым?Это репозиторий только с содержимым: набор документов в формате Markdown. Сам сайт собирается отдельными инструментами (Rari/Fred), на которые ссылаются скрипты сборки.
Как собрать документацию и посмотреть её локально?Установите Node.js (он включает npm), выполните npm install, чтобы загрузить зависимости, и запустите локальный предпросмотр. После запуска он будет доступен в браузере.
Что нужно установить, чтобы собрать сайт?Нужен установленный Node.js версии 24 или выше. В комплекте с ним поставляется npm.
Можно просто изменить файл и сразу увидеть результат?Да, после запуска команды локального предпросмотра сайт обновляется сразу же, как только вы редактируете файлы с содержимым.
Для кого предназначена эта документация?Она рассчитана как на профессиональных веб-разработчиков, которым нужна справочная документация, так и на студентов и начинающих, только приступающих к веб-разработке.
Есть ли содержимое на языках, отличных от английского?Да, над переводом и локализацией для китайского, французского, японского, корейского, португальского, русского и испанского языков работают более 35 волонтёров.
Что, помимо HTML, CSS и JS, описывает MDN?MDN также описывает HTTP и Web API, наряду со справочными материалами по CSS, HTML и JavaScript.
Creator
mdn
Size
500.3 MB
Stars
11.1K
Updated
CommitOct 16
Age
6y
Commits · 90 Days