关于markdown:gitlabgithubgitee布署mkdocs主题仓库

gitlab、github、gitee布署mkdocs主题仓库

旧址   布署mkdocs   calligraphy

1、概述

mkdocs作用在git平台创立mkdocs主题仓库，主动将markdown文件生成动态网页。 官网  https://www.mkdocs.org/简介&主题   https://www.jianshu.com/p/c005c45abe85gitlab-mkdocs  https://gitlab.com/pages/mkdocsgithub-mkdocs-theme  https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes

python装置及下载  https://gitlab.com/xuyq123/mynotes/-/blob/master/Python.mdmkdocs装置     pip install mkdocs

2、gitlab布署mkdocs

gitlab mkdocs主题仓库 （推送文件主动布署）创立办法：   1、创立 mkdocs.yml、.gitlab-ci.yml文件。   2、创立docs目录，markdown文件放在此处。   3、推送到仓库。      可fork此仓库 https://gitlab.com/xuyq123/plain-mkdocs    https://xuyq123.gitlab.io/plain-mkdocs   留神：若部署失败，可在 CI/CD --> Jobs查看起因，批改 .gitlab-ci.yml 文件。   本地调试：    装置 python 及 mkdocs     相干命令          pip install mkdocs      装置mkdocs         python -m pip install --upgrade pip     更新Python                  mkdocs new my-project         mkdocs serve         mkdocs build参考：    https://cloud.tencent.com/developer/article/1662592    https://blog.csdn.net/qq_32332433/article/details/106148965        

         主题装置    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple mkdocs-Bootswatch      装置多个主题    pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material   装置material主题    pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-gitbook    装置gitbook主题        pip install mkdocs-cluster       pip install mkdocs-cinder          pip install mkdocs-bootstrap4                主题品种                    The available installed themes are: readthedocs, cluster, lumen, flatly, yeti, material, cosmo, litera, sandstone, darkly, lux, minty, superhero, gitbook, spacelab, cinder, pulse, mkdocs, cerulean, bootstrap, solar, journal, simplex, slate, materia, bootstrap4, ivory, cyborg, united主题总结    mkdocs      默认主题，速度极快。菜单横向。蓝边白底。不够好看。     评级四星。    material    速度个别。菜单竖向，左侧整体文件构造，右侧文件目录。紫边白底。   评级四星。    readthedocs 速度个别。菜单竖向。展现markdown文件目录构造。黑边白底。  评级四星。    sandstone   加载挺快。菜单横向。黑边白底。    评级四星。    litera      加载挺快。菜单横向。天蓝边白底。  评级四星。    lumen       加载挺快。菜单横向。海蓝边白底。  评级四星。    spacelab    加载挺快。菜单横向。深蓝边白底。  评级四星。    cluster        加载挺快。菜单横向。灰边白底。    评级四星。    slate        加载挺快。菜单横向。黑边黑底。    评级四星。    simplex        加载挺快。菜单横向。深红边白底。  评级四星。    united        加载挺快。菜单横向。橙红边白底。  评级四星。    cinder        速度个别，不显示文件夹中的下拉文档。展现markdown文件目录构造。菜单横向。黑边白底。适宜单级目录文件。   评级三星。    bootstrap4  速度相当慢。菜单横向。黑边白底。  评级二星。    gitbook     速度个别。菜单竖向，灰边白底。有版权广告去不掉。   评级二星。    ivory       速度相当慢。菜单竖向，黑边白底。  评级二星。    

3、github布署mkdocs

github mkdocs主题仓库 （mkdocs gh-deploy 一键布署）创立办法：   1、创立 mkdocs.yml、README.md、.gitignore文件。创立docs目录，markdown文件放在此处。   2、本地调试 mkdocs serve   拜访：http://127.0.0.1:8000/  。 推送上述三个文件。   3、一键布署 mkdocs gh-deploy  （主动生成 gh-pages分支，公布GithubPages ）   可fork此仓库 https://github.com/scott180/plain-mkdocs     https://scott180.github.io/plain-mkdocs/前期更新文件，只需执行 mkdocs gh-deploy 。   本地调试：    装置 python 及 mkdocs     相干命令          mkdocs serve         mkdocs gh-deploy     参考：    https://www.cnblogs.com/paulwhw/p/12725523.html    

4、gitee布署mkdocs

gitee mkdocs主题仓库 （GiteePages服务布署目录）创立办法：   1、创立 mkdocs.yml。创立docs目录，markdown文件放在此处。   2、本地调试 mkdocs serve   拜访：http://127.0.0.1:8000/  。   3、mkdocs build  生成动态文件，于 site 文件夹中。   4、推送 mkdocs.yml 、docs、site到仓库。   5、开启GiteePages服务，抉择对应分支。   可参考此仓库 https://gitee.com/xy180/plain-mkdocs     http://xy180.gitee.io/plain-mkdocs/1/site   本地调试：    装置 python 及 mkdocs     相干命令          mkdocs serve         mkdocs build         参考：    https://www.cnblogs.com/yywBlogW/p/11362889.html

5、示例