5.开发服务器并生成网页

开发服务器

MkDocs包含一个开发服务器,因此可以随时在本地进行浏览、更改。

在 mkdocs.yml 同一路径下,使用以下命令启动开发服务器:

mkdocs serve

现在,可以将浏览器中输入地址 http://localhost:8000, 来预览网页效果。

生成网页

在 mkdocs.yml 同一路径下,使用以下命令依据 mkdocs.yml 配置文件,生成网页:

mkdocs build

成功后,将在项目文件夹下生成一个名为 site 的文件夹,其中包含了所有生成的网页。

site 文件夹下的所有文件拷贝到项目根目录下,与 docs文件夹及其包含的文本,共同组成网页资源

当我们部署网页时,只需要将上述网页资源进行部署即可(忽略 mkdocs.yml 和 site 文件夹)。

评论