跳到主要内容

教程简介

让我们用不到 5 分钟认识 Docusaurus

快速开始

创建一个新站点开始。

或者用 docusaurus.new 立即体验 Docusaurus

你需要准备

  • Node.js 20.0 或以上版本:
    • 安装 Node.js 时,建议勾选所有与依赖相关的复选框。

生成新站点

使用 classic 模板生成新的 Docusaurus 站点。

运行下面的命令后,classic 模板会自动添加到你的项目:

npm init docusaurus@latest my-website classic

你可以在命令提示符、PowerShell、终端或代码编辑器的集成终端中输入此命令。

该命令还会安装运行 Docusaurus 所需的全部依赖。

启动站点

运行开发服务器:

cd my-website
npm run start

cd 命令用于切换当前工作目录。要操作新建的 Docusaurus 站点,你需要先在终端进入该目录。

npm run start 会在本地构建网站并通过开发服务器提供服务,可在 http://localhost:3000/ 查看。

打开 docs/intro.md(本页)并编辑几行:站点会自动重新加载并显示你的更改。