mkdocs中使用material主题

首先安装python3.5,配置好环境变量

注意:我python3.5用的是python.exe,默认对应pip,2.7用的是python2.exe,使用pip2安装操作,
安装mkdocs,因为我有两个python环境,所以带上我的python版本运行,以下操作都是两个版本的,选择其一即可

pip install mkdocs //python3
pip2 install mkdocs //python2

附带python2的环境,安装有问题时尝试 pip2 install mkdocs==1.0.4 这样安装指定版本
python2 的环境包

其次安装material

pip install mkdocs mkdocs-material //python3
pip2 install mkdocs mkdocs-material //python2

若下载慢,可更换安装源为豆瓣

pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material

新建项目

python -m new my-project // python3

python2 -m new my-project // python2

会生成my-project目录,进入该目录里,可以看到默认放置了一些文件,包括mkdocs.yml,这是主配置文件

使用主题

mkdocs.yml里添加:

theme:
name: material

运行

进入my-project目录里,执行,

python -m mkdocs serve // python3

python2 -m mkdocs serve // python2
主要是看你配置的python运行代码是什么,比如上边我设置python2运行的就是用的python2.exe。

通过浏览器访问本地ip的8000端口(比如http://127.0.0.1:8000/) 查看效果

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值