5.开发服务器并生成网页
开发服务器
MkDocs包含一个开发服务器,因此可以随时在本地进行浏览、更改。
在 mkdocs.yml 同一路径下,使用以下命令启动开发服务器:
mkdocs serve
现在,可以将浏览器中输入地址 http://localhost:8000, 来预览网页效果。
生成网页
在 mkdocs.yml 同一路径下,使用以下命令依据 mkdocs.yml 配置文件,生成网页:
mkdocs build
成功后,将在项目文件夹下生成一个名为 site 的文件夹,其中包含了所有生成的网页。
将 site 文件夹下的所有文件拷贝到项目根目录下,与 docs文件夹及其包含的文本,共同组成网页资源。
当我们部署网页时,只需要将上述网页资源进行部署即可(忽略 mkdocs.yml 和 site 文件夹)。