|
摘要:本文介绍如何使用Mkdocs工具制作软件项目文档
是一个快速、简单和非常华丽的静态网站生成器,类似于、、等静态网页生成器,能够非常方面地构建静态网站,如博客、项目网站等。+
MkDocs拥有许多漂亮的主题,如主题、(这个主题在很多软件文档中有用到)、还有一些第三方的主题都能够集成在MkDocs中使用
易于个性化,通过配置文件mkdocs.yml
的修改,用户可以方便地根据自己的喜好修改为自己喜欢的样式,不需要懂前端的知识(如html、css等)
方便部署,其通过内置的dev-server,快速在云端部署网站的更新内容
部署环境多样,用户可以在很多平台上部署网站,如(推荐)、亚马逊 S3,用户可以通过Read the 免费host他们的网站,该网站由公益基金资助,提供文档托管的免费服务
网站的创建与部署非常简单,首先需要python环境,使用命令
pip install mkdocs
安装软件包,在建站目录下运行
mkdocs new my-project
cd my-project
生成如下文件夹
随后运行
$ mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
[I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000
[I 160402 15:50:43 handlers:58] Start watching changes
[I 160402 15:50:43 handlers:60] Start detecting changes
发布离线网站,在线预览
在 doc
文件夹中写入文档(markdown)即可
Archiver|手机版|科学网 ( 京ICP备07017567号-12 )
GMT+8, 2024-10-19 23:03
Powered by ScienceNet.cn
Copyright © 2007- 中国科学报社