博客与个人写作2016github.com
Openblog:用 GitHub Issues 写博客
Show HN: Openblog – Blogging with GitHub Issues
导读
这是一个把 GitHub Issues 当作博客发布系统的开源小工具:每篇博文就是一个 issue,读者在 issue 下留言就相当于文末评论区。对写作者的价值在于,它把“写作—发布—讨论”压缩到同一个界面里,几乎零成本、零配置,特别适合用极低摩擦的方式维持持续写作和读者反馈。
可以直接用的写作要点
- 01
把草稿直接写在 issue 里,省掉打开编辑器、建文件、部署这一串步骤,摩擦越小越容易保持更新频率。
- 02
让评论留在原文正下方,读者的讨论会变成文章的一部分,反过来给你下一篇的选题和论据。
- 03
把内容(issue 文本)和呈现(静态站点生成)分开,换主题、换平台时文字不会跟着一起报废。
- 04
用 issue 的标签、开放/关闭状态来管理选题库和已发布文章,写作流程本身就是可检索的。
HN 评论精选
这套方案的实际约束:内容存在 issue 里,迁移和分享会比存在文件里更麻烦。
我的博客(pwmckenna.net)就是同样的思路。但我遇到的问题是:别人 fork 仓库后并不会把 issue 一起带过去,所以分享起来比我原先想的麻烦——你得为代码和 issue 各建一个仓库。源码在这里:github.com/pwmckenna/til
pwmckenna查看英文原文
My blog (http://pwmckenna.net) is built on the same idea. The issue I ran into is that forks don't have their own issues, so its a bit harder to share than I originally thought (you need a seperate repo for the code, and for the issues). Here's the source: https://github.com/pwmckenna/til
读者希望讨论和正文并排出现,而不是分成两个页面。
这主意太棒了。能不能把评论也直接内联显示在正文里?
prezjordan查看英文原文
Wow what a great idea. Would it be possible to list comments inline as well?
更常见的折中方案:正文照旧用静态文件写,只把评论区交给 Issues。
我想弄清楚它相比用 GitHub Pages 托管普通博客到底好在哪?后者的文章至少在仓库里能直接看到。如果只是为了给 GH Pages 博客加评论,我自己写过一种做法:用普通的 Jekyll 站点托管在 GH Pages 上,再从 Issues 拉取评论。链接:seanlane.net/2016/Hosting_comments_within_issues_on_Github_Pages/
seanlane查看英文原文
So I'm trying to understand the benefits behind this as opposed to using a normal blog hosted with Github Pages? Then the posts would be visible in the repo. If it is for having comments within a Github Pages blog, I found a solution that I wrote about myself about using a normal Jekyll hosted on GH Pages that pulls comments from Issues: http://seanlane.net/2016/Hosting_comments_within_issues_on_Github_Pages/
GitHub 的附属功能(issue、wiki)都能被改造成写作与发布工具。
我从没想过把 issue 用在这个地方。我之前写过一个用 wiki 的 Jekyll 插件 Jekyll-Gollum(github.com/rubyworks/jekyll-gollum),不过很久没维护了,现在大概需要有人接手修一修。
transfire查看英文原文
Never considered using the issues for this. I did create a Jekyll plugin for using the wiki: Jekyll-Gollum (https://github.com/rubyworks/jekyll-gollum) Haven't messed with it in a while though, probably needs some love by now.
同类还值得读
我坚持每天写一条 TIL,已经写了一年
Show HN: I've been writing daily TILs for a year
这篇展示作者一年每天写 TIL(Today I Learned)并整理到 GitHub 仓库的做法。
博客与个人写作2016 · 819 分 · 150 评4 条写作要点编辑精选如何写出开发者愿意读的博客文章
How to write blog posts that developers read
这篇(正文与评论未提供,仅从标题判断)讨论面向开发者写技术博客的方法:怎样让忙碌的工程读者愿意点开、读下去并读到结尾。
博客与个人写作2025 · 603 分 · 154 评4 条写作要点编辑精选博客写作风格指南
A blogging style guide
这是程序员兼博主 Robert Heaton 的博客写作风格指南,用几十条简短规则讲如何让技术文章更清晰、更好读。
博客与个人写作2018 · 495 分 · 188 评4 条写作要点编辑精选十年职业博客写作,我学到了什么
Ten years of professional blogging – what I’ve learned
这是作者回顾十年专业博客写作经验的总结,评论补充了写作作为深度学习、聚焦主题、保护写作习惯和选择发布平台等实践。
博客与个人写作2017 · 362 分 · 126 评4 条写作要点编辑精选十年博客写作教给我的事
What I learned in ten years of blogging
这是一篇博客作者十年写作经验总结,核心观点是写作的价值在于持续积累而非单篇爆款。
博客与个人写作2018 · 356 分 · 162 评4 条写作要点编辑精选