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

- 日理万妓 2022-04-18 04:18 312阅读 0赞

● 本文仅是缩略，笔者已将详细内容发布到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种悬停链接文字配色
● 支持中文搜索

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

原文链接

发表评论

表情：
评论列表 （有 0 条评论，312人围观）

还没有评论，来说两句吧...

相关阅读