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

    语言与文风2018themillions.com编辑精选

    论分号与写作的规则

    On Semicolons and the Rules of Writing

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

    导读

    这篇讨论分号的用法与写作规则,作者主张分号应节制使用、用得其所才更有分量。对写作者的价值在于:它提醒我们标点不是装饰,而是控制句子节奏和层次意义的工具,尤其值得学习如何在复杂列举中用好分号。

    关键词 分号标点写作规则技术写作

    可以直接用的写作要点

    1. 01

      分号要少用,用得越少,每一次出现承载的分量和意义就越明确。

    2. 02

      在含有内部标点的长列举中,用分号分隔各项能显著降低理解难度,技术写作尤其如此。

    3. 03

      把标点当作思维节奏的标记:分号适合连接关系紧密但需要停顿的两个分句。

    4. 04

      遇到规则之争时先问它解决什么表达问题,而不是机械遵守或机械反对。

    HN 评论精选

    复杂列举中分号能清楚划分层级,去掉反而增加理解成本。

    分号在带内部标点的列举中特别有用,尤其是技术写作。我最近在文档里写了这样一句:默认情况下 Gutenberg 会查找三个模板:index.html,用于站点首页;section.html,用于所有 section(在 content 目录下创建目录所生成的任何 HTML 页面);以及 page.html,用于所有页面(在 content 目录下创建 .md 文件所生成的任何 HTML 页面)。如果把这句话里的分号去掉,理解起来会困难得多,至少在我看来是这样。

    codesections查看英文原文

    Semicolons can also be extremely helpful for lists with internal punctuation, especially in technical writing. I recently wrote the following sentence in some documentation: By default, Gutenberg will look for three templates: index.html, which is applied to the site homepage; section.html, which is applied to all sections (any HTML page generated by creating a directory within your content directory); and page.html, which is applied to all pages (any HTML page generated by creating a .md file within your content directory). Omitting semicolons from that sentence would have made it much harder to understand, at least in my view.

    节制使用让分号更有表现力,名称本身也暗示了它的连接功能。

    我很认同作者对分号的看法:最好少用,正因为用得少,它才承载更精确的分量和意义。另外这个标点的命名有点奇怪,它带着冒号那种因果意味,我一直觉得法语名“point-virgule”(句点—逗号)更贴切。

    lloeki查看英文原文

    I quite entertained the same point of view of the author about semicolons. The best use of them is when they're used sparingly, hence carrying more precise weight and meaning. Now there is something quite peculiar about that punctuation mark's naming, which has some dissonant trait of causality (what colons are used for), and always found the French name "point-virgule" (period-comma) much more apt.

    分号可以忠实呈现跳跃、碎片化的思维节奏。

    我倾向于过度使用分号;它们帮我传达自己那种断裂式的思维方式。

    Jaruzel查看英文原文

    I tend to over use semicolons; they help convey my fractured way of thinking.

    好文笔本身就能激发读者的写作欲望。

    我很喜欢这位作者的写作风格。读到一段写得好的内容让人耳目一新,老实说会让我想去写点什么。自从我从小学虚构读物转向成人小说以来,还没这种感觉。

    hazz99查看英文原文

    I love the writing style of this author. Experiencing a well-written bit of content is refreshing, and honestly makes me want to go write something. I haven't felt like this since I moved from primary school fiction to adult novels.

    同类还值得读

    1. 像说话一样写作

      Write like you talk

      这篇短文主张写作应像说话一样自然、清晰,避免装腔作势的书面腔。

      语言与文风2015 · 647 分 · 272 评4 条写作要点编辑精选
    2. 法律语言难懂源于写作不佳,而非专业概念

      Poor writing, not specialized concepts, drives difficulty with legal language

      这是一项认知科学研究:法律文本难懂,主要不是因为充斥专业术语,而是因为写作者把句子写得又长又绕、修饰语层层嵌套、回指距离过远。

      语言与文风2022 · 559 分 · 322 评5 条写作要点编辑精选
    3. 写得简单

      Write Simply

      保罗·格拉汉姆在这篇短文里主张:好文章应该写得简单——用日常词汇、短句、直白的结构,不为显得聪明而堆砌复杂表达。

      语言与文风2021 · 484 分 · 330 评4 条写作要点编辑精选
    4. Tortured phrases:科学写作中出现的一种可疑文风

      Tortured phrases: A dubious writing style emerging in science

      《自然》新闻报道了一种在科学论文中蔓延的怪现象:原本标准的术语被同义替换软件改写成了古怪说法,比如把 "cloud computing" 写成 "haze figuring"。

      语言与文风2021 · 329 分 · 256 评4 条写作要点编辑精选
    5. 乔治·奥威尔 1940 年对《我的奋斗》的书评

      George Orwell's review of Mein Kampf (1940)

      这是奥威尔1940年对《我的奋斗》的书评。

      语言与文风2014 · 305 分 · 240 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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