nikola+gitpage搭建博客

本来博客是在CSDN上的http://blog.csdn.net/digimon,但最近CSDN在我这一直无法登录,已经在Evernote上积压了好几篇博客,搞烦了,决定自己搭个博客。
由于目前是没有收入来源的屌丝,没钱去买个域名、弄个VPS,只能想免费的招了。WordPress这货屏蔽GAE的UA,导致没法申请博客,最后想到了gitpage。虽然gitpage也有随时被墙的风险,但是我的博客主要记录技术内容,作为程序猿翻个伟大的防火墙还是没问题的吧;-)

gitpage只支持静态页面,网上搜了一下,生成静态页面的工具还真不少,好像专门为此设计的一样,套餐呐有木有。
Python的就有不少: What's the best available static blog/website generator in Python?
还有更多别的语言支持的工具: 32 Static Website Generators For Your Site, Blog Or Wiki

最终选择了nikola,也是因为Quora上那篇文章的推荐。
nikola官网:http://nikola.ralsina.com.ar/

详细安装和配置的教程就不赘述了,可以参考这两篇文章:
+ The Nikola Handbook(官网教程)
+ 用 nikola 写静态博客

下面说一下安装和配置nikola时要注意的问题。
1. 官网上的安装指导中,如果你是Ubuntu用户的话,Mako一定要用pip安装或自己去下,Ubuntu官方源上的版本太旧,运行会出问题。
2. 喜欢用markdown的童鞋除了更改nikola生成的站点根目录下的从conf.py之外,新建博文的时候要注意加上-f markdown参数:nikola new_post -f markdown
3. 喜欢用markdown的童鞋还得注意一下(==!),官方0.5.4有个bug。在/usr/local/lib/python2.7/dist-packages/nikola/plugins/compile_markdown/__init__.py文件中,在73~81行的字符串前加个字母u。

    with codecs.open(path, "wb+", "utf8") as fd:
        if onefile:
            fd.write('<!-- \n')
            fd.write('.. title: {0}\n'.format(title))
            fd.write('.. slug: {0}\n'.format(slug))
            fd.write('.. date: {0}\n'.format(date))
            fd.write('.. tags: {0}\n'.format(tags))
            fd.write('.. link: \n')
            fd.write('.. description: \n')
            fd.write('-->\n\n')
        fd.write("\nWrite your post here.")

改成

    with codecs.open(path, "wb+", "utf8") as fd:
        if onefile:
            fd.write(u'<!-- \n')
            fd.write(u'.. title: {0}\n'.format(title))
            fd.write(u'.. slug: {0}\n'.format(slug))
            fd.write(u'.. date: {0}\n'.format(date))
            fd.write(u'.. tags: {0}\n'.format(tags))
            fd.write(u'.. link: \n')
            fd.write(u'.. description: \n')
            fd.write(u'-->\n\n')
        fd.write(u"\nWrite your post here.")

因为不加u就是str对象,写入的是utf-8编码的文件,当title等参数里出现非英文字母的时候会出先解码异常。(马上提交个pull request去)
4. 要快速部署到gitpage,在站点conf.py里添加:

DEPLOY_COMMANDS = [
'git --git-dir=output/.git --work-tree=output add -A ',
'git --git-dir=output/.git --work-tree=output commit -m "latest auto deploy build"',
'git --git-dir=output/.git --work-tree=output push origin master'
]

Comments

Comments powered by Disqus