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 生成,可能有误。

    博客与个人写作2022blosxom.com

    Blosxom:博客的禅意

    Blosxom: The Zen of Blogging

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

    导读

    这期讨论围绕 Blosxom 展开:它是 WordPress 之前流行过的 Perl 博客工具,本质上把纯文本文件按目录结构转成 HTML。对写作者来说,这场怀旧讨论其实在谈一件务实的事:用什么形式存放和发布文字,才能让写作本身最省力、让内容活得最久。

    关键词 静态站点生成纯文本写作博客维护链接失效

    可以直接用的写作要点

    1. 01

      把稿子存成纯文本,按目录和文件名组织,工具会过时,文本不会。

    2. 02

      把发布流程压到最简(不依赖数据库和后台),省下的精力全部留给写作本身。

    3. 03

      一个博客能撑十几年,靠的是低维护成本,而不是花哨的技术。

    4. 04

      定期检查旧文里的链接,失效链接会让读者对你整篇内容的可信度打折扣。

    HN 评论精选

    Blosxom 本质是把纯文本按目录结构转成 HTML 的静态生成器,简单、无数据库、易扩展。

    很多人不知道,Blosxom 用今天的话说就是一个 Perl 写的静态站点生成器。和 Jekyll 一样,它只是把纯文本文件转成 HTML,并保持与磁盘源文件相同的目录结构。它扩展性很强,有处理 bbCode、MediaWiki 标记、按 ASIN 嵌入亚马逊链接的插件。在 WordPress 吞掉博客世界之前它相当流行,不需要数据库,甚至不需要 CGI 支持。

    giantrobot查看英文原文

    For those unaware Bloxsom was/is what would today be described as a static site generator written in Perl. Like Jekyll et al it just takes plain text files and turns them into HTML in the same layout as the source files on disk. It is very extensible and had plugins to handle things like bbCode and MediaWiki markup to embedding Amazon links from an ASIN. Before WordPress ate the blogging world it had some popularity, it didn't need a database or even CGI support.

    足够简单的工具能支撑一个博客运转十几年,简单即长寿。

    爱死 Blosxom 了!我那个老掉牙的博客至今还在用它。Rael Dornfest 最初的 Perl 脚本后来分别由 Frank Hecker 和 Rob Reed 加了注释。(有趣的旁注:据 Rob 说,Blosxom「在我决定回学校读计算机硕士的过程中起了一份作用」。)

    miles查看英文原文

    Love Blosxom! Still using it to power my senescent blog[0]. Rael Dornfest's original Perl script was later annotated separately by Frank Hecker[1] and Rob Reed[2]. (Neat side note: according to Rob, Blosxom "played a part in my decision to go back to school to get a masters in computer science".) [0] https://tinyapps.org/blog [1] https://web.archive.org/web/20100712013556/http://www.hecker.org/blosxom/blosxom2-footnotes-folded [2] https://tinyapps.org/blog/201003250700_rob_reed_ode.html

    工具会死,旧文章和旧链接会随平台一起烂掉,内容要放在能带走的形式里。

    大学时我用的是 PHPosxom,它「受」Blosxom 启发,但大概是动态生成页面而非静态生成(当然用 PHP 而不是 Perl,共享主机上更方便)。这个项目现在早死透了。这是我当年用它搭的旧主页,原本是合法的 XHTML 1.0,直到学院计算机协会开始往我网站里注入分析脚本。

    skyfaller查看英文原文

    Back in college I used PHPosxom, which was "inspired" by Blosxom but I guess dynamically created pages instead of statically generating them (and of course used PHP instead of Perl, useful if PHP was more accessible/functional on your shared hosting). https://sourceforge.net/projects/phposxom/ Of course the project is super dead now. Here's my old homepage using PHPosxom, which would be valid XHTML 1.0 if the Swarthmore College Computing Society hadn't started injecting analytics into my web site: https://www.sccs.swarthmore.edu/users/06/nelson/

    半死的链接会立刻削弱读者对你内容的信任,发布之后仍要维护。

    页面上一半的链接都打不开,实在让人没什么信心:邮件列表打不开,news 坏了,donate 坏了,Overview→Install 是 404,只有 Install 本身能打开。

    TheLoafOfBread查看英文原文

    Does not really inspire confidence when half of links on the page does not work. * mailing list - Does not work * news - Broken * donate - Broken * Overveiew -> Install -> 404; however Install works.

    同类还值得读

    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

    关注向阳乔木

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

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

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