在Github上搭建免费博客:Jekyll

这个博客是用Jekyll搭建在Github Pages上的。根据阮一峰老师的教程文章,使用Jekyll+Github Page建立博客的好处主要是:

  • 免费,无限流量。
  • 享受git的版本管理功能,不用担心文章遗失。
  • 你只要用自己喜欢的编辑器和Markdown标注写文章就可以了,其他事情一概不用操心,都由github处理。

而缺点在于:

  • 有一定技术门槛,你必须要懂一点git和网页开发。
  • 它生成的是静态网页,添加动态功能必须使用外部服务,比如评论功能就只能用disqus。
  • 它不适合大型网站,因为没有用到数据库,每运行一次都必须遍历全部的文本文件,网站越大,生成时间越长。

综合来看,它不失为搭建中小型Blog或项目主页的最佳选项之一。

技术细节

我最开始是从阮一峰的介绍(搭建一个免费的,无限流量的Blog—-github Pages和Jekyll入门)里了解到还有这种轻便的方式实现可以自己高度控制的博客。后来我在网上冲浪的时候遇到了Verne的博客,非常喜欢他调的蓝白色简洁模板。这样简洁的模板在保持对超文本标注可读性的同时,最大程度的使非内容的排版、美术形式从读者的眼中消失,保证阅读可以专注于内容。

安装这个Jekyll主要是看官方的引导https://jekyllrb.com/docs/installation/#macOS,写的还是非常清晰了。毕竟Jekyll的作者入职了Github。在Mac上安装完之后需要执行 bundle update 更新一下gem的组件。我在安装的时候还读了这篇48 个你需要知道的 Jekyll 使用技巧文章学到了不少实用技巧。

给我自己看的代码备忘

  • 在博客内部超链接另外一篇文章的格式:
    • 链接到我的另外一篇 post
链接到我的另外一篇 [post]( { {  site.baseurl } } { % post_url 2018-03-24-read-plan-for-2018  % } )
JEKYLL_ENV=production bundle exec jekyll serve -w
  • 新建Post,Title可为中文,自动转变成拼音
rake post title="A Title" [date="2012-02-09"] [tags=[tag1,tag2]] [category="category"]
  • 新建页面
rake page name="about.html"
  • 插入图片

Marriage A-la-Mode: The Tête à Tête, William Hogarth, 1743, Oil on Canvas, 69.9 x 90.8 cm, National Gallery, London

荷加斯代表作「时髦婚姻:早餐」 Marriage A-la-Mode: The Tête à Tête, William Hogarth, 1743, Oil on Canvas, 69.9 x 90.8 cm, National Gallery, London

<img src="/images/sep-2018-read-list/breakfast.jpg" alt="Marriage A-la-Mode: The Tête à Tête, William Hogarth, 1743, Oil on Canvas, 69.9 x 90.8 cm, National Gallery, London">
**<center>荷加斯代表作「时髦婚姻:早餐」 Marriage A-la-Mode: The Tête à Tête, William Hogarth, 1743, Oil on Canvas, 69.9 x 90.8 cm, National Gallery, London</center>**

Latex 支持

在行内的Latex:$$\int x = \lamba $$->\(\int x = \Lamba\)

在行间的Latex:

$$\int x = \Lamba $$

->

\[\int x = \lamba\]

本地更新gem包

gem update package_name

注意在本地更新gem所使用的包并不意味着在Github远程编译的时候包是被更新的。

正确的做法应该是在gemfile里面加入对应的行,对特定的包要求特定的最低版本。


2018-03-24 Jekyll

最近文章

  • FIRE第一课:每一块钱都比上一块钱更贵 在这一篇文章里,我将介绍诸如“每个人都能在12年里退休”这样的令人惊异的反直觉结论,探讨为何财务自由是可能的,以及为何 消费主义是21世纪最大的陷阱之一 我们应该积极追求财务自由。本文与后续系列文章共同组成【FIRE课堂】系列,为读者介绍人生迷宫的一个出口。
  • 《数字极简主义》——信息狂筵与注意力救赎 Digital Minimalism 对当代人过度的数字生活进行了反思和系统提炼。作者认为技术本来是为生活服务的,而现在这种自动化的数位性却降低了生活的快乐,消磨了有意义的活动,甚至主宰了我们的文化属性。在本书中作者也给出了一系列的对数字生活进行整理和减负的原则和实操建议。这本书传达的核心信息其实在其副标题 Choosing a Focused Life in a Noisy World。作者在本书中所倡导的并不是反对一切数字工具,而是建议人们能够更加理智地利用这些数字工具。正如消费极简主义并不是抗拒资本主义社会,而是倡导只清醒地进行必要的消费,数字极简主义也只是鼓励读者翻身做数字技术的主人,重新拿回自己的人生的控制权。
  • ★★★★☆ 郭建龙:「中央帝国的哲学密码」 「中央帝国的哲学密码」一书用平实的语言介绍了从中国历史上占统治地位的政治哲学从战国时期到清朝的演变历史。力图解答为何中国人千年来在政治与人的框架中反复挣扎震荡,在精神世界的层面上鲜有普世价值意义上的进步。
  • OSX Mojave根据BSSID选择指定Wifi路由 在公共场合使用Mac的时候偶尔会遇到所处的地方有多个同名的Wifi路由器,出于各种原因你可能只想连接其中一个。在OSX Mojave下可以通过airport-bssid这个工具让系统连接到指定的路由器上。
  • 本地转换中英文扫描版PDF为可搜索文件 我终于找到了一个可以本地把扫描版的中文PDF变成可搜索的PDF的命令行工作流程。具体方式为安装支持中文包的ocrmypdf这一开源软件。
  • ★★★★★ 武志红:「巨婴国」——中国国民性的心理动力学 集体主义的真相是,个体的心理发展水平太低,导致大多数人的里子是破碎的,必须千人一面,用共生的方式,追求和他人的融合,以此将个体镶嵌进一个集体性自我中。 —— 武志红
  • Review for Top 3 Halite 2 Bots In this post, I aim to give a brief review on the useful strategies and tricks for the top 3 bots in last year’s Halite 2 competition.
  • ★★★☆☆ 阮一峰:「未来世界的幸存者」 2016年3月,谷歌公司的围棋程序 AlphaGo 战胜了世界冠军李世石。 这让我猛然意识到,世界正处在一个前所未有的大变局: 机器人、自动化、人工智能正在变得比人类更强大。 在可预见的将来,技术最终将淘汰人类。 技术变革导致了人类社会的重构。绝大部分的人没机会参与这个进程,只能被动接受其他人安排自己的命运,而且没有改变命运的机会。
  • ★★★★★ 盖达尔:「帝国的消亡」——当代俄罗斯的教训 我们无力承担一个帝国!——而且也没有必要,我们应该将其抛弃,因为它使我们不堪重负、民穷财尽、加速毁灭。 ——亚· 索尔仁尼琴《我们应当如何构建俄罗斯》
  • 中国历史与科技世界的未来:2018年9月读书短评 我计划不定期更新一下我在读的书的列表和简短评论。对于有意思的书可能除了评论之外会单写一篇文章记录一下我的摘抄或者读后感。希望我能每3到6个月更新一次这个读书计划与短评系列。本篇是2018年9月的第二期。 
  • 翻越中文「局域网」:我从哪里看新闻? 时不时会有人问我是从哪里看的新闻或时事,我常常因为从头解释一遍嫌太麻烦而搪塞带过。所以我想专门在博客里写一篇心得,分享一下我用来保持对世界关注的一些信息源和工具,希望对读者有所益处。
  • 中日社会与经济:2018年3月读书短评 我计划不定期更新一下我在读的书的列表和简短评论。对于有意思的书可能除了评论之外会单写一篇文章记录一下我的摘抄或者读后感。希望我能每3到6个月更新一次这个读书计划与短评系列。本篇是2018年3月首发的第一期。
  • 在Github上搭建免费博客:Jekyll 这个博客是用Jekyll搭建在Github Pages上的。根据阮一峰老师的教程文章,使用Jekyll+Github Page建立博客的好处主要是:
  • ★★★☆☆ 「程序员修炼之道」——从小工到专家 本书作者 Andrew Hunt 和 David Thomas 从多个角度探讨了什么是好的编程习惯和如何搭建一支高效的编程团队。这本书值得再重读,我感觉这一次读有很多内容并不适用于我现在的工作环境,比如如何保持高效的团队协作。我同意一个说法是,这本书需要等到一定时候才需要去看或者说才可以看得懂。以下是我摘抄的部分: