站长承接各类型网站制作,包括:企业网站、个人网站、教育网站等

Mkdocs安装

前端 chinarui 102℃ 0评论

MkDocs安装

!!! Note

MkDocs是一个快速,简单和彻底的华丽静态网站生成器,旨在建设项目文件。文档源文件使用Markdown编写,并使用单个YAML配置文件进行配置。

一. 安装Python

Linux平台安装 Python3.6

如果本机安装了python2,尽量不要管他,使用python3运行python脚本就好,因为可能有程序依赖目前的python2环境,

比如yum!!!!!

不要动现有的python2环境!

一、安装python3.6

  1. 安装依赖环境

    yum -y install zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel

  2. 下载Python3

    wget https://www.python.org/ftp/python/3.6.1/Python-3.6.1.tgz

  3. 安装python3

    mkdir -p /usr/local/python3

    tar -zxvf Python-3.6.1.tgz

  4. 进入解压后的目录,编译安装

    cd Python-3.6.1

    ./configure --prefix=/usr/local/Python3

    make

    make install 或者make && make install

  5. 建立python3的软链

    ln -s /usr/local/python3/bin/python3 /usr/bin/python3

  6. 并将/usr/local/python3/bin加入PATH

    vim ~/.bash_profile

    示例:PATH=$PATH:$HOME/bin:/usr/local/python3/bin

    按ESC,输入:wq回车退出

    使修改生效 source ~/.bash_profile

    检查是否可用:

    python3 -V

    显示:Python 3.6.1

    pip3 -V

    显示:pip 9.0.1 from /usr/local/python3/lib/python3.6/site-packages (python 3.6)

  7. 不行的话在创建一下pip3的软链接

    ln -s /usr/local/python3/bin/pip3 /usr/bin/pip3

二、安装pip以及setuptools

!!! Note
毕竟丰富的第三方库是python的优势所在,为了更加方便的安装第三方库,使用pip命令,我们需要进行相应的安装。

  1. 安装pip前需要前置安装setuptools

    wget --no-check-certificate https://pypi.python.org/packages/source/s/setuptools/setuptools-19.6.tar.gz#md5=c607dd118eae682c44ed146367a17e26

    tar -zxvf setuptools-19.6.tar.gz

    cd setuptools-19.6

    python3 setup.py build

    python3 setup.py install

  2. 安装pip

    wget --no-check-certificate https://pypi.python.org/packages/source/p/pip/pip-8.0.2.tar.gz#md5=3a73c4188f8dbad6a1e6f6d44d117eeb

    tar -zxvf pip-8.0.2.tar.gz

    cd pip-8.0.2

    python3 setup.py build

    python3 setup.py install

    如果没有意外的话,pip安装完成

Windows平台安装 Python3.6

  • 打开WEB浏览器访问http://www.python.org/download/
  • 在下载列表中选择Window平台安装包,包格式为:python-XYZ.msi 文件 , XYZ 为你要安装的版本号。
  • 要使用安装程序 python-XYZ.msi, Windows系统必须支持Microsoft Installer 2.0搭配使用。只要保存安装文件到本地计算机,然后运行它,看看你的机器支持MSI。Windows XP和更高版本已经有MSI,很多老机器也可以安装MSI。
  • 下载后,双击下载包,进入Python安装向导,安装非常简单,你只需要使用默认的设置一直点击"下一步"直到安装完成即可。

记得添加至Path

win-install

MAC 平台安装 Python

最近的Macs系统都自带有Python环境,你也可以在链接 http://www.python.org/download/ 上下载最新版安装。


二、安装Mkdocs

使用pip 安装Mkdocs软件包

pip install mkdocs==0.14.0

现在应该mkdocs在系统上安装该命令。运行mkdocs
--version检查一切正常。

mkdocs --version

mkdocs, version 0.14.0

使mkdocs支持中文搜索

  1. 替换支持中文的lunr.min.js文件

    lunr.min.js下载路径: 
    lunr-0.5.7.min.js

    文件路径:/usr/local/python3/lib/python3.6/site-packages/mkdocs/assets/search/mkdocs/js

    替换时请注意文件名字的统一

    mkdocs 0.14.0 版本此文件名为:lunr-0.5.7.min.js

  2. 修改生成索引文件的函数

    找到:/usr/local/python3/lib/python3.6/site-packages/mkdocs/search.py

    修改函数generate_search_index,在json.dumps中添加一个参数:ensure_ascii=False

    search

此时mkdocs已支持中文搜索

转载请注明:喜乐从心,不应由人 » Mkdocs安装

喜欢 (0)

如果您认为这篇文章对您有用,读后觉得收获很大,不妨小额赞助我一下,左微信,右支付宝

发表我的评论
取消评论
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址