如何在github上免费发布个人静态博客

 ●  本文仅是缩略，笔者已将详细内容发布到github上

 ●  可点击本文最后的"阅读更多"进行访问，或者在github上搜"cyent markdown"也可以看到

目录

 ●  本文概述
 ●  mkdocs-material介绍
 ●  安装
 ●  初始化项目
 ●  修改主题
 ●  运行
 ●  发布到GitHub pages
 ●  发布到个人HTTP Server
 ●  mkdocs.yml注意事项
 ●  添加页面
 ●  添加扩展
 ●  markdown语法
 ●  其他功能

 ●  最佳实践

本文概述

mkdocs-material入门，包括安装、运行、发布至github-pages及个人站点

mkdocs-material介绍

符合google material ui规范的静态文档网站生成器，使用markdown进行文档书写

mkdocs

 ●  python编写的markdown解释器、编译器，带有本地cli工具
 ●  自带基于Tornado的小型http服务，用于本地调试
 ●  内置一键式发布至GitHub Pages
 ●  内置mkdocs风格、readthedocs风格的主题，并支持自定义主题
 ●  支持调用python模块实现语法及渲染的扩展

mkdocs-material

 ●  python模块，符合google material ui规范的mkdocs自定义主题
 ●  针对特定语法、功能做了渲染优化
 ●  根据客户端浏览器页面尺寸自动缩放，对PC、移动设备都友好
 ●  丰富的页面配色，多达19种主体配色和16种悬停链接文字配色
 ●  支持中文搜索

 ●  支持统计功能，如百度统计，谷歌统计

原文链接