一般习惯写小工具项目时写完文档就想弄一个页面出来,用 GitBook 感觉太重, GitHub 自带的又不支持多页(额好像是)。所以写了个小工具,部署后可以动态把 Markdown 文件渲染成网页。
好处就是只需要增加一个 html 入口文件,开启 GitHub 的 Pages 功能(选择 docs 作为源码目录)写完文档直接推送到仓库上就得到了一份文档网站 😄
目前提供 vue 和 buble 风格两套主题,还提供了命令行工具方便本地预览,欢迎尝试~
1
neoz 2016-11-26 19:51:59 +08:00 via iPhone
不错诶,赞!一会仔细看下
|
2
Kilerd 2016-11-26 20:12:18 +08:00 via Android
这套主题很好看!
|
3
airyland 2016-11-26 20:31:11 +08:00 via iPhone
赞
|
4
gimp 2016-11-26 22:16:03 +08:00
很棒,收藏了
|
5
wq2016 2016-11-26 22:30:32 +08:00
支持!
|
6
DarsyCheuk 2016-11-26 22:47:40 +08:00 via iPhone
mark
|
7
huangfuyingjian 2016-11-26 23:09:59 +08:00
很漂亮的主题,滋瓷一个,已 Star :)
|
8
mingyun 2016-11-26 23:52:35 +08:00
不使用 username.github.io 使用其他 repo 的 gh-pages 分支可以吗
|
10
levie 2016-11-27 11:55:24 +08:00
赞赞赞!
不知道能否设置左边的导航栏到 4 级(即 ####)就不要展开了? 因为想写成 FAQ 形式的,如果都展开的话就太占空间了。 |
14
levie 2016-11-27 12:45:45 +08:00
另外,我这样写的时候:
## [ABC](/abc) 解析有问题(左边导航栏以及正文内容都是) 这样写是希望每个页面都有相同的导航栏,出现在正文内容的可以我通过 css 屏蔽掉。 |
15
qingv OP @levie
目录最大层级功能已加, heading 渲染问题也修复了,已发布 0.3.1 。有 bug 或 feature 可以到 issue 里提 😄 |
17
guyskk 2016-11-27 19:20:04 +08:00 via Android
手机 chrome 上代码块无法水平滚动
|
18
yuanchao 2016-11-28 13:57:13 +08:00
mark
|
19
levie 2016-12-01 11:34:33 +08:00
|
22
kamal 2016-12-23 00:44:30 +08:00
感谢分享,不用编译部署真方便。
|