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
Content
这是什么？这是 MDN Web Docs 的官方源代码仓库，包含 14,000 多页参考文档和学习资源，涵盖 HTML、CSS、JavaScript、HTTP 和 Web API。
这是网站的代码库，还是只有内容文件？这是一个只包含内容的仓库，全部是 Markdown 格式的文档文件；网站的实际渲染由构建脚本中提到的独立工具（Rari/Fred）完成。
如何在本地构建并预览文档？安装 Node.js（其中已包含 npm），运行 npm install 安装依赖，然后启动本地预览；启动后即可在浏览器中访问。
构建网站需要先安装什么？需要安装 Node.js（版本 24 或更高），它自带 npm。
我可以直接改个文件，然后马上看到变化吗？可以。运行本地预览命令后，编辑内容文件时网站会实时更新。
这份文档主要面向谁？既面向需要参考文档的专业 Web 开发者，也面向刚入门 Web 开发的学生和初学者。
这些内容有英文以外的语言版本吗？有。超过 35 位志愿者负责中文、法语、日语、韩语、葡萄牙语、俄语和西班牙语的翻译与本地化工作。
除了 HTML、CSS 和 JS，MDN 还涵盖哪些主题？除了 CSS、HTML 和 JavaScript 的参考资料，MDN 还记录 HTTP 和 Web API。
What are similar projects?react.dev, solved-by-flexbox, curriculum, fe-interview, react-redux-links, Web, awesome-angular, zh-google-styleguide
Which topics is it in?translation, node, i18n, http, reference, css, documentation, html, learning, markdown, web-development, tutorial
Creator
mdn
Size
500.3 MB
Stars
11.1K
Updated
CommitOct 16
Age
6y
Commits · 90 Days