HN 写作课

工程师们二十年里聊过的写作。

工程师、作家、编辑和创业者在 Hacker News 上聊了二十年“怎么写”:怎么写得清楚、怎么讲好一个故事、技术文档怎么写、小说和出版是怎么回事。这里把其中关于写作与讲故事的帖子挑出来,配上中文导读、可以直接用的写作要点和评论翻译。

从必读开始
  • 2,600+篇关于写作的 HN 讨论

Writing tips

写作锦囊

正在抽一条写作要点…

Essential

必读 30 篇

在讨论库里看全部精选

编辑精选里 HN 讨论最热的 30 篇,每篇都有中文导读和写作要点。

  1. 正在载入…

Archive

讨论库

按发帖年份分布,点柱子筛选。

排序

    About

    这些讨论是怎么挑出来的

    1. 01

      从全量里捞

      读取 Hacker News 自 2006 年以来的全部帖子,用关键词先捞出 40 分以上、可能和写作有关的约 1.1 万篇。

    2. 02

      只留真正讲写作的

      由 AI 逐条判断是否和写作、讲故事、文风、出版有实质关系,剔除“写代码”“编辑器”这类字面撞车,并分进十个类别。

    3. 03

      提炼可用的要点

      为值得读的帖子写中文导读,提炼 2-4 条可以直接用到自己写作里的要点,并精选翻译 HN 高赞评论。内容由 AI 生成,可能有误。

    博客与个人写作2019tom.preston-werner.com编辑精选

    像黑客一样写博客(2008)

    Blogging Like a Hacker (2008)

    阅读原文 HN 讨论
    94HN 得分
    38条评论
    4条写作要点

    导读

    这是 Tom Preston-Werner 2008 年宣布 Jekyll 诞生的文章:他主张把写作放进 Git 仓库、用纯文本和静态站点取代需要持续维护的动态博客,把复杂度压到最低。对写作者而言,它讨论的不是技术,而是「工具应该如何为写作让路」——降低发布摩擦、让形式服务于内容。

    关键词 博客写作静态站点写作工具降低摩擦

    可以直接用的写作要点

    1. 01

      把稿子存成纯文本并纳入版本控制,你才敢放心试错、随时回退到旧想法。

    2. 02

      刻意压低工具复杂度:凡是需要长期维护的东西,都会悄悄偷走你的写作时间。

    3. 03

      把发布流程缩短到一条命令甚至一次提交,摩擦越小,越容易保持写作节奏。

    4. 04

      内容与外观分离,改版式时不必碰文字,写的时候也不被排版分心。

    HN 评论精选

    Jekyll 的设计目标就是让写作者在熟悉的编辑器里自由试验、极简发布,这正契合许多技术型博主的真实需求。

    这位作者指出,这篇文章正是 Preston-Werner 向世界介绍 Ruby 静态站点生成器 Jekyll 的起点。他引述原文说明动机:所有文字都存在 Git 仓库里,可以在自己惯用的编辑器和命令行里随意试验各种想法;发文章只需一个部署脚本或提交钩子;复杂度要压到最低,所以宁可要静态站点,也不要需要持续维护的动态站点;博客还要易于定制,因为设计出身的人总会不停调整外观布局。他说这跟自己以及其他「黑客型」博主的愿望完全一致,也正因如此 Jekyll 才如此合用。

    Eiriksmal查看英文原文

    Fascinating. For those who click to read the comments before the actual article, this is Mr. Preston-Werner's introduction of Jekyll, the Ruby static site generator, to the world. He lays out his reasons for creating the tech: >>>First, all my writing would be stored in a Git repository. This would ensure that I could try out different ideas and explore a variety of posts all from the comfort of my preferred editor and the command line. I’d be able to publish a post via a simple deploy script or post-commit hook. Complexity would be kept to an absolute minimum, so a static site would be preferable to a dynamic site that required ongoing maintenance. My blog would need to be easily customizable; coming from a graphic design background means I’ll always be tweaking the site’s appearance and layout. Which are the exact same wishes I had with my own blog, and I assume many other "hacker" types have for theirs, as well. I don't remember why I settled on Pelican (Python) over Jekyll (Ruby), but either tool is a fantastic choice for blogs... and I now understand that's because Jekyll was literally created to support those goals!

    选一套现成、干净的工作流,把精力从折腾站点转回到写作本身。

    Jekyll 的好处是可以找一个好看的现成主题直接 fork,改改 config.yml 里的名字、地址等信息就能发布;文章放进 posts 文件夹、以 Markdown 文件上传即可,干净利落。站点可以托管在 GitHub Pages 上,再把自有域名指向他们的 DNS。这样人就被解放出来专心写作,需要时还能享受 Markdown 的便利。他反问:一个简单博客为什么非要连数据库、到处发请求、装一堆不安全的插件?给我简单就好。

    GEBBL查看英文原文

    The nice thing about Jekyll is that you can just find a nice looking theme and then fork it, edit the config.yml file with your specifics, such as name/address/etc and then publish. Posts go under the posts folder, uploaded as md files. It's very nice and clean. You can host a site on github pages and point your .com to their DNS servers. It frees you up to focus on writing, and you have the benefit of markdown there if you need it. Makes you wonder why a simple blog site needs to be interacting with a DB and making mad calls all over the place, with loads of insecure plugins and all the rest of it. Just give me simplicity :)

    技术圈常忽略前人成果,写作时也应交代灵感来源与先例,别把借鉴写成原创。

    他常说 IT 整体上是个没有历史的领域。他好奇:如果 Tom 当年知道 Blosxom,还会不会做 Jekyll?Blosxom 的最后一次发布,恰好是 Jekyll 首次发布的同一个月。这篇博文读起来像是他独自想出了 Jekyll 的点子和代码,但作为 Ruby 圈的人,他更可能是把已有的概念和代码移植到了自己的项目里。

    bhaak查看英文原文

    I often remark that IT in general is a history-less space. I wonder if Tom would have developed Jekyll if he knew about Blosxom? Blosxom had its last release in the same month when Jekyll had its first. The blog post seems to imply that he came up with the idea and code for Jekyll all by himself. But also as he's a Ruby guy, it's likely he would have ported over the code and concepts to his own project.

    同类还值得读

    1. 我坚持每天写一条 TIL,已经写了一年

      Show HN: I've been writing daily TILs for a year

      这篇展示作者一年每天写 TIL(Today I Learned)并整理到 GitHub 仓库的做法。

      博客与个人写作2016 · 819 分 · 150 评4 条写作要点编辑精选
    2. 如何写出开发者愿意读的博客文章

      How to write blog posts that developers read

      这篇(正文与评论未提供,仅从标题判断)讨论面向开发者写技术博客的方法:怎样让忙碌的工程读者愿意点开、读下去并读到结尾。

      博客与个人写作2025 · 603 分 · 154 评4 条写作要点编辑精选
    3. 博客写作风格指南

      A blogging style guide

      这是程序员兼博主 Robert Heaton 的博客写作风格指南,用几十条简短规则讲如何让技术文章更清晰、更好读。

      博客与个人写作2018 · 495 分 · 188 评4 条写作要点编辑精选
    4. 十年职业博客写作,我学到了什么

      Ten years of professional blogging – what I’ve learned

      这是作者回顾十年专业博客写作经验的总结,评论补充了写作作为深度学习、聚焦主题、保护写作习惯和选择发布平台等实践。

      博客与个人写作2017 · 362 分 · 126 评4 条写作要点编辑精选
    5. 十年博客写作教给我的事

      What I learned in ten years of blogging

      这是一篇博客作者十年写作经验总结,核心观点是写作的价值在于持续积累而非单篇爆款。

      博客与个人写作2018 · 356 分 · 162 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

    微信公众号「向阳乔木推荐看」

    微信公众号「向阳乔木推荐看」二维码

    微信扫一扫;在微信里打开本页时,长按二维码识别。