基于 gitcafe-pages 服务的 markdoc 私人维基发布

基于 gitcafe-pages 服务的 markdoc 私人维基发布
- 背景
- 分析
  - 俺的方案
- e.g
  - .nojekyll
- 效果
- 进一步的
- 是也乎

背景

又看到一篇大张旗鼓的忽悠人去 SAE 架 Wordpress 的教程...
再对比:
配合体会:

~ 来自: articles/programming_language_learning_curves.md at master · Dobiasd/articles

感觉有必要说点什么,于是有了这篇高速入门

分析

其实:
- SAE 是个非常可用的国产 PaaS 平台, 几乎免费
- Wordpress 是世界最好的 blog 系统之一
- #PHP是最好的语言
- 还有 MySQL ,世界上可能是第一个大规模赢利的开源数据库产品
但是,加起来,好象就哪里有不对了
我们可能只是想要有一个快速发布自个儿想法/思考/心得的空间
- 能用 Markdown
- 能用自个儿的域名
- 能任意迁移/发布到任何空间
- 能自动备份
- 能轻松的,不用什么帐号,就可以自然的增补/反馈/建议
- 能在本地也查阅
- ...
当然,可能最直接的一个非功能性要求就是:
- 不用学习太多技术知识点!
所以, LAMP 架构思路的 SAE+PHP+Wordpress+MySQL ,明显复杂到飞溅了
世界是懒人的,早已有很多工具,可以只用一组脚本就达成以上所有心愿的了
参考官方文档:Wiki Pages 相关帮助 · GitCafe/Help - GitCafe
- 当然,这是针对 gitcafe-pages 服务的说明
- 但是,要看到本质!
  - gitcafe-pages 本质上是一个可绑定域名的静态网站发布空间!
  - 只不过内置了 Jekyll 兼容的静态编译服务
  - 但是! 没规定一定要使用 Ruby 系的静态网站工具哪!

俺的方案

使用自个儿喜欢的静态网站工具
- 将编译出来的 .html 网络,单独纳入到合法的 gitcafe-pages 发布分支中
- 通过 fabric 来批量化本地的编译/准备/发布行为
- 将 Jekyll 在服务端作的事儿,在本地作了
- 从而达到相同的效果 ;-) 但是,更加任性!
当然俺是 Pythoneer 仅仅在本地安装有 Python 环境,不用数据库不用 web 服务器
- 仅仅依赖 Python
- 就可以达成以上所有目标 ;-)

e.g

使用 Markdoc
文章仓库: zhgdg/wiki - master
- 发布仓库: zhgdg/wiki - gitcafe-pages
- 配置好域名
本地目录设定:

/path/2/wiki
├── .git/
├── .gitignore
├── .html -> ../七牛同步目录/wiki/
├── .python-version # pyenv 声明戳, 可以任意的切换各种 Python 环境来玩
├── _static/        # markdoc 资源目录
├── _templates/     # markdoc 模板目录
├── fabfile.py      # fab 自动化脚本
├── markdoc.yaml    # 配置,相比Jekyll 的上百项, markdoc 10行以内就足够好用了
└── wiki/           # .md 分目录收纳的文章

技巧就在 .html 是个软链接, 指向另外一个仓库
- 其实就是当前仓库的 gitcafe-pages 分支克隆
Fabric 是一个快速配置管理脚本工具,可以在本地或是远程用脚本描述一系列自动化操作,通过一个标签反复调用

$ fab ?
...
Available commands:
    build
    p2cafe
    pub7niu
    reserve
    serve

可以看到, fabfile.py 定义的操作有这么些,其中:
- pub7niu 就是,编译,然后跳到对应目录将成果同步到七牛云存储
- p2cafe 自然就是,编译,跳到对应目录,使用 git 将成果发布到 gitcafe 空间
以上,俺平常的写作流程就变成:
- 到 wiki 对应目录中,创建一个 .md 文本,用喜爱的编辑器,爽快的书写
- fab p2cafe 完成发布
- fab reverve ,启动本地网站,然后在 http://localhost:8008/ 看看效果
- git ci -am "注释" + git pu 将原稿也用 gitcfe 备份上
实际上,习惯后,基本就前两步,定期进行第四步就好.
- 如果是 fab pub7niu 则是发布到七牛云存储
- 就这么任性!
朋友们,可以:
- 在嵌入了 Disqus 评论功能的网页上反馈
- 也可以直接 fork->clone->pull rwquest 俺的文章仓库来反馈
就这么任性!

.nojekyll

今天,通过不断的戳 gitcafe 的工程师,才知道一个隐藏技巧:

如果不是用 Jekyll 兼容的静态网站工具
那么
- 嘦在最终发布仓库根目录中
- 部署一个空白文件
- 名为 .nojekyll
gitcafe-pages 服务,就知道已经是静态网站, 不再试图找 Jekyll 工程配置来编译了.

效果

进一步的

有小朋友说了:

骗纸! 
俺不会 Python 怎么办?! 
而且,
俺是大 Windows 
    木有什么 `软链接` !

内什么...整体上涉及的工具只有:
- Python ~ 推荐安装 ActivePython 有完备的 M$ 版本
- Git ~ 更加有
相比官方推荐的工具组合:
- ruby ~ 好象 M$ 版本很错觉...
- jekyll
- git
再相比更加高端的 LAMP 组合,在 M$ 上要折腾:
- Apache
- PHP
- MySQL
- Wordpress
- ...
怎么看都最简洁了哪...
更进一步的, 请 google 或是留言吼俺来增补...

是也乎

当然,相同的策略也一样适用在 github-pages 服务空间呢...

以上...

码不停提马上无虫 ;-)

|_|0|_|
|_|_|0|
|0|0|0|

加入珠海GDG

注册 G+
关注 GDG Zhuhai
成为 GDG Zhuha开发者

通过珠海GDG 可以:

    第一时间获知谷歌最新的技术,
    可以学到如何去谷歌平台上赚钱的思路和方法,
    可以认识很多有可能将来一起走上自己创业道路的人,
    可以学会把你的创新带向国际市场,
    参加那里的活动有经常和国际上的开发者们进行交流的机会...

PS:

若无意外,题图都是从原文提取或是通过 Google 图片搜索出来的, 版权属左, 不负责任 ;-)

PPS:

珠海GDG wechat/Blog 都是欢迎投稿的,只要追认内容吻合以下条件:

0. 有趣 ~ 至少是自个儿有兴趣的领域吧...
1. 有料 ~ 至少有点儿原创的东西吧..
2. 有种 ~ 至少不能是成功学吧!

有好物的,及时向大妈们吼: [email protected]

微信栏目

当前应该是:

    G术图书 (gb:推荐好书,书无中外)
    D码点评 (dd:麻辣评点,善意满盈)
    G说公论 (gt:时评杂文,新旧不拘)
    珠的自白(dm:大妈自述,每周一篇)
    海选文章(hd:得要相信,大妈法眼)

总之! 珠海的组委大妈们,决定开始坚持发文,方方面面细细同大家分享/交流

总之! 请大家告诉大家, 珠海生活中的技术社区 已经认真回归微信,都来订阅吧!

订阅方法

搜索微信号 GDG-ZhuHai
或查找公众号: GDG珠海
或扫描:

GDG珠海社区资源:

邮件列表: [email protected] (可发空邮件到 [email protected] 即完成订阅)
微博: @GDG珠海
微信: GDG珠海
G+ 主页: GDG ZhuHai
G+ 社群: ZhuHai GDG

Author:

/mail / gittip / github