如何优雅地写博客

@Archer 2016-10-11

最近突然感觉自己不务正业地入了很多坑,蓝鹅记性太差总忘记做了什么为什么我要做这个woc这个我又是怎么写出来的,于是立下flag定个小目标开始写博客做总结,于是又多了一个坑(摔!)



那么现在开始正题——如何优雅地写博客?

这里我使用的是GitHub Pages + Pelican

GitHub Pages是个卵?官方文档如是说:

GitHub Pages is a static site hosting service. GitHub Pages is designed to host your personal, organization, or project pages directly from a GitHub repository.

为什么选择GitHub Pages?免费,轻量,可定制,逼格高,便于交友

Pelican又是个卵?是鹈鹕啊。Pelican是用Python写的静态页面生成器。

为什么使用Pelican?Because it takes great advantage of Python. 扔一份Features



以下才是正题。

在GitHub上配置site

  • (首先,注册一个Account。)
  • 蓝后,新建一个仓库,注意:
    • 仓库名为<username>.github.io
    • 仓库为public
    • 页面发布在master分支
  • 再蓝后,没了。(也许你需要安装一个git。)

配置Pelican

  • 首先,pip install pelican(也许你喜欢先mkvirtualenv pelican && workon pelican(那么你还需要pip install virtualenvwrapper(对了在这之前你应该安装有python和pip(也许你首先需要有一台PC?))))
  • 蓝后,因为我要用markdown写文,所以还需要pip install markdown
  • 蓝后,pelican-quickstart。回答完一系列简单的问题,目录下就会自动生成配置文件。我把fabfile.py和publishconf.py删了,根据需要重写了makefile的内容。pelicanconf.py中保存了主要配置,可以根据需要修改,参考这里
  • 蓝后你需要一个主题,包括用Jinja写成的HTML模板和css,pelican-themes -i <theme>并在pelicanconf.py中修改对应的值以安装主题。

发布博客

以上配置完成后就可以开始写文了,把.md文件保存在content文件夹下,make html会在output文件夹下生成网页文件(如果需要覆盖旧文件可以make regenerate),make serve可以在localhost预览。把output文件夹下的内容push到GitHub上,访问<username>.github.io就能看到发布的博客了。



(好像,写完了?)希望我下次看这篇文章的时候还能记得我在写什么。以下留坑待填。



2016-10-12更新:

  • markdown的~~删除线在html中无法显示,所以用<del>标签。
  • markdown开头记得写metadata。
  • 鼠标悬停在avatar上时无限旋转是怎么实现的:animation配合@keyframes食用,css代码如下:
#avatar:hover { animation: rotate 2s linear infinite; }
@keyframes rotate { from { transform: rotate(0); } to { transform: rotate(360deg); } }
  • 不太懂响应式设计所以页面在手机上看好丑但是不想填这个坑了所以将就着看吧。

2016-10-20更新:

2016-11-24更新:

  • 今天突然发现在某些时候侧边栏的标签球会转得飞快,简直要上天的样子,各种debug之后发现鼠标定位忘记考虑页面滚动的影响了(以前po的文又少又短都不会出现这个问题[捂脸])。楼上那篇文已同步更新。

分类 misc 标签 优雅 GitHub Pelican