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

    写作方法2022languagetool.org

    Language Tool:开源的Grammarly替代品

    Language Tool – Open-source Grammarly alternative

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

    导读

    这篇帖子介绍开源语法检查工具 Language Tool,评论区则从实际使用角度讨论它的能力与局限。对写作者来说,有价值的地方在于:如何用规则工具捕捉自己反复犯的错误,以及为什么语法检查器不能替代对语境的判断。

    关键词 语法检查写作工具自我校对开源工具

    可以直接用的写作要点

    1. 01

      建一份自己的“错误规则库”:每次发现自己写错的地方就加一条检查规则,几年下来就能自动拦住大部分个人高频错误。

    2. 02

      规则式检查只能当第一道过滤,介词、格、语气这类依赖语境的问题它经常判断不了,最终还得靠自己通读和判断。

    3. 03

      把语法检查嵌进日常写作流程(博客草稿、提交信息、代码注释),比写完再专门校对更容易坚持。

    4. 04

      不要指望工具替你改好文章,它能做的是把你的注意力从低级错误上省下来,留给结构和表达。

    HN 评论精选

    把每次犯的错变成一条自定义规则,长期积累成个人专属的检查清单。

    我是 Language Tool 的重度用户,很满意。它很好用的一个功能是可以自己加规则,官方还提供了规则编辑器。基本上,每次你在自己的文章里发现一个错误,就加一条规则,保证下次能被抓住。几年下来,你的规则集能覆盖你写作错误的很大一部分,而且这个过程还挺有意思。

    isaacfrond查看英文原文

    I'm a heavy user of LT. Very happy with it. A really nice feature of LT is that you can add your own rules. A rule editor is provided here: https://community.languagetool.org/ruleEditor2/ Basically, whenever you catch an error in your writing you add a rule to ensure that it is caught the next time. After a few years your rule set will catch a large portion of your writing errors. It's fun too.

    基于规则的工具抓不住语境敏感的错误,只能作为辅助而非最终裁判。

    我们在做一个语言学习 App,语法纠错是核心功能,所以用了 Language Tool 的 API。我很感激开源版本让我们能起步,但它实在……有限。它非常依赖规则,而语言有大量依赖语境的东西,这条路注定吃力:比如德语里它判断不出某个动词该用哪个格,也判断不准介词用得对不对。最后我们基于 transformers 和一个多语言版的 errant 自己搭了语法引擎,不完美,但开发几周就比 Language Tool 有用了。

    dandiep查看英文原文

    I have been a user of the Language Tool API as we're building (experimenting with?) a language learning app [1] and grammar correction is a key component. I really want to love it, and I'm so appreciative of the open source version that has allowed us to get going, but it's just so... limited. I haven't really dug into the code, but I gather that it is very rules based and that seems destined to fail because so much of language is context sensitive. For example, it really can't determine in German if you're using the correct case or not for a particular verb. Or it can't really tell if you're using the right prepositions. Ultimately, we ended up building a grammar engine just for language learners using transformers [2] + a version of errant [3] we ported to be multilingual. It's not perfect, but after a couple weeks of development was more helpful than LT. 1. https://squidgies.app 2. e.g. this paper from Grammarly https://arxiv.org/abs/2005.12592, but there are a bazillion others 3. https://github.com/chrisjbryant/errant

    把语法检查放在你实际写作的地方(编辑器里),覆盖博客、注释、提交信息等一切文字。

    JetBrains 的 Grazie 插件底层用的就是 Language Tool。我主要用它检查博客文章,它也能检查代码注释和提交信息。

    darekkay查看英文原文

    The Jetbrains Grazie plugin [1] for IntelliJ IDEA uses Language Tool under the hood. I've been mostly using it for checking my blog posts, but it can also inspect code comments and commit messages. [1] https://plugins.jetbrains.com/plugin/12175-grazie

    同类还值得读

    1. 被低估的工程技能:把文章写好

      Undervalued Engineering Skills: Writing Well

      这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。

      写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选
    2. 每行只写一句话:让写作和修改都更轻松的排版法

      Writing one sentence per line

      这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。

      写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选
    3. 书面沟通是远程工作的超级能力

      Written communication is remote work super power

      这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。

      写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选
    4. 如何写出有用的文字

      How to Write Usefully

      保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。

      写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选
    5. 如何写得更清楚、想得更清楚,并学会复杂材料(PDF)

      How to write more clearly, think more clearly, and learn complex material [pdf]

      这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。

      写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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