惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Hacker News: Ask HN
Hacker News: Ask HN
IT之家
IT之家
S
SegmentFault 最新的问题
T
Tailwind CSS Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园 - 司徒正美
J
Java Code Geeks
博客园 - 聂微东
雷峰网
雷峰网
阮一峰的网络日志
阮一峰的网络日志
The Cloudflare Blog
博客园_首页
大猫的无限游戏
大猫的无限游戏
博客园 - 三生石上(FineUI控件)
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
博客园 - 【当耐特】
腾讯CDC
Apple Machine Learning Research
Apple Machine Learning Research
酷 壳 – CoolShell
酷 壳 – CoolShell
V
V2EX
宝玉的分享
宝玉的分享
小众软件
小众软件
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Hugging Face - Blog
Hugging Face - Blog
月光博客
月光博客
NISL@THU
NISL@THU
T
The Exploit Database - CXSecurity.com
C
CXSECURITY Database RSS Feed - CXSecurity.com
WordPress大学
WordPress大学
有赞技术团队
有赞技术团队
Blog — PlanetScale
Blog — PlanetScale
aimingoo的专栏
aimingoo的专栏
L
LINUX DO - 热门话题
cs.CL updates on arXiv.org
cs.CL updates on arXiv.org
F
Fortinet All Blogs
博客园 - Franky
L
Lohrmann on Cybersecurity
S
Secure Thoughts
量子位
V
Vulnerabilities – Threatpost
Last Week in AI
Last Week in AI
博客园 - 叶小钗
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
L
LINUX DO - 最新话题
I
InfoQ
C
CERT Recently Published Vulnerability Notes
Security Archives - TechRepublic
Security Archives - TechRepublic
P
Proofpoint News Feed
G
GRAHAM CLULEY
Cisco Talos Blog
Cisco Talos Blog

ZDDHUB

PixelsMeasure 开发第二年总结 PixelsMeasure 开发一年总结 Swift/SwiftUI 踩坑记 为什么说 GPT 利好程序员 ChatGPT 编程实现 Web 数字水印 Web 数字水印探究 Micro Frontends for Mobile URL 加载系统(URL Loading System) Protocol Buffers GraphQL 从 0 到 1 开发一款 IOS 应用 - Swift MV* 软件设计架构 学习一个新技巧需要多久? 不停机数据库迁移 Rspec 如何 mock update 方法更新自己? Rails 使用 mysql2 出现的段错误 使用 Docker-compose 部署 Rails 应用到生产环境 Cocoa troubleshooting 独孤九剑 Dit (0x05) - 终端篇 Miscellaneous 前端手记 TodoMVC 之 Redux 篇 前端手记 TodoMVC 之 Server 篇 前端手记 TodoMVC 之 React 篇 前端手记 TodoMVC 之 CSS 篇 独孤九剑 Dit (0x04) - 测试篇 独孤九剑 Dit (0x03) - 缓存篇 英语小抄 LLDB debug Golang Make mistakes 大牛俱乐部上线啦 独孤九剑 Dit (0x02) - 数据结构篇 独孤九剑 Dit (0x01) - 总决 独孤九剑 Dit (0x00) - 我为什么要做 Dit 零值强制类型转换的使用 终端颜色输出重定向 Go语法简略 - 正则表达式 Makefile Go语法简略 - Duck框架探索 Go语法简略 - 依赖注入 Go语法简略 - web应用框架 Go语法简略 - 反射 Go语法简略 - 面向对象 Go语法简略 - goroutine Go语法简略 - 方法和接口 Go语法简略 - 基础篇 大牛 轻松科研 未来这几年 为 Android Studio 创建图标 Shell Git Vim 金庸答百问 论拖延症 Flex, A fast scanner generator 有理想的人 从虚拟到现实 常用视频转接口 Recognizer configuration on CentOS 整个世界清静了 《Python源码剖析》读书笔记
Gem-based Jekyll theme 开发小记
zddhub · 2017-06-10 · via ZDDHUB

Github pages 和 Jekyll 搭配,让一大批静态博客火了起来,方便了不少人,用 markdown 写文章也非常优雅。

美中不足的是,Jekyll 把 theme 和博文混在了一起。把博客内容和 theme 分开,让内容写作者只关注内容本身,我觉得这才是一种最好的体验。我最理想的写作平台是只写 markdown 外加一个 assets(用来保存文章中的素材)。Jekyll 引入的 Gem-based theme 几乎完美的解决了这一问题。

Jekyll 在 3.2.0 版本引入了 Gem-based theme。 把网站的样式封装成 gem 包,整个静态博客离理想只差一个 Gemfile。看到这个,加上我对前博客臃肿的样式,缓慢的速度已经容忍到了极限,顿时觉得干劲十足,那就行动吧。

名字

首先它得有个名字,叫什么呢?对我来说起名字就像公鸡下蛋,憋的再久,也下不出来。三步成诗、七步成文,这是需要才气的。钱老先生说怀才就像怀孕,时间久了才能看得出来。我已经快熬到了老先生写《围城》的年纪,也没发现自己有什么才气。既然不能 being talented,那就退而求其次, being gravid 吧。

Being talented just like being gravid , must be known with a long time past.

所以,一个用形容词做名字的 Jekyll theme 诞生了:gravid

样式

博客应该长什么样子?首先应该便于阅读,其次应该足够简单。小鱼同学typo.css 一直是我认为的最完美的中文排版样式,gravid 的样式,就全照搬他的博客了。

烦恼

开发出奇的顺利,并且 push 了生平第一个 gem,暗喜。本地运行完美,添加之前的博客,push 到 Github pages 上,静待成功喜悦。几秒后收到一份邮件:

You are attempting to use a Jekyll theme, "gravid", which is not supported by GitHub Pages. Please visit https://pages.github.com/themes/ for a list of supported themes. If you are using the "theme" configuration variable for something other than a Jekyll theme, we recommend you rename this variable throughout your site. For more information, see https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/.

脑后一凉,仔细一看,Github pages 只支持有限的几个 theme: [Architect, Cayman, Dinky, Hacker, Leap day, Merlot, Midnight, Minima, Minimal, Modernist, Slate, Tactile, Time machine],有黑幕呀。

求助 Github

如何才能加入到这个 supported list 里呢?找 Github 试试看吧。向 Github support 请教了一把,一个小时不到就收到了回复(北京时间上午11:46),我万万没想到这么及时。顿时对 Github 肃然起敬,好感多了不少。

Github reply

结果在意料之中,回复非常得体,又非常专业,切中要害,连一句废话都没有。即成功了拒绝了我的妄想,又贴心的提供了两个备选方案。顿时对 Github 的程序员肃然起敬,好感多了不少。

折中的方案

我从一开始就反感混合 theme 和博文做法,又偏执的认为代码仓库只应该托管代码,而不应该托管中间产物。所以对 Github 给出的两个方案,我只能会心一笑,采用 git submodule 来曲线救国了。详细的做法在这里

中间遇到了一个坑,Jekyll 限定 _includes 和它的子文件不能是链接文件,解决方案在这里

为了方便使用,封装了一个命令,每次写完文章,或者更新完 theme 之后,执行 ./publish_blog 就可以把文章发表在 Github pages 上啦!

总结

这次更新了一个新的 Github theme,并且尝试了一下 gem,感觉程序员的世界会越来越美好!

Gem-based 已经实现了博文和 theme 的分离,我想,除了是亲生的几个 theme,可能也是出于安全和资源两方面考虑,Github 暂时不支持自定义的 Gem-based theme。

把博客和 theme 通过 submodule 的方法加到 Github pages 中,能专注的更新 blog 或者 theme,解决了一部分问题。但提交博文后需要手动(或者自动)在 Github pages 上 push 一次。

期待 Github pages 早点支持自定义 theme!

这已经是我第三次更新个人博客了,下一次会在什么时候呢?

如果你喜欢这篇文章,欢迎赞赏作者以示鼓励