establish blog and document website

github page创建个人博客

  1. github创建仓库

    参照https://pages.github.com/

  2. jekyll

    https://jekyllrb.com/docs/

    需要注意的是, 在已有仓库里初始化jekyll, cd到仓库路径下, 运行

    $ jekyll new . --force

    在本地运行bundle exec jekyll server

    在浏览器访问localhost:4000就可以看到效果了

  3. jekyll theme

    上一步看到的是默认模板, 可以采用网上的模板来美化我们的博客

    我采用的是https://github.com/willard-yuan/willard-yuan.github.io

    按照步骤做就可以了

Docsify部署markdown文档

Docsify部署markdown文档

优化

  1. C++ code color
    在index.html里引用js: 
    <script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-c.js"></script>
<script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-cpp.js"></script>

    markdown文件里写C++代码时加上cpp标签

Material for MkDocs部署markdown文档

Material for MkDocs部署markdown文档