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

    讲故事与叙事2018idyll-lang.org

    Idyll 语言:为网络创作互动叙事

    Idyll Language – Author interactive narratives for the web

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

    导读

    这篇介绍 Idyll——一个用于在网页上创作交互叙事的语言/工具;HN 讨论中有作者说明项目进展,也有用户分享上手体验和对文档的建议。对写作者来说,它提供了把文本、交互与可视化结合起来的叙事思路,也提醒我们术语定义和示例文档会直接影响读者的理解与尝试意愿。

    关键词 交互叙事写作工具文档设计上手体验

    可以直接用的写作要点

    1. 01

      给作品归类时先定义关键术语,避免读者把“交互叙事”误解成自己熟悉的另一种体裁,比如文字冒险。

    2. 02

      降低读者的第一次体验门槛:让他们在几分钟内做出或玩到一个最小示例,比长篇说明更能建立信心。

    3. 03

      文档和示例本身就是作品叙事的一部分;如果作品强调交互,就尽量让读者在说明页直接操作,而不是只看截图或动画。

    4. 04

      示例和文档的打磨程度会影响读者对作品成熟度的判断,发布时应把可运行例子当作正式内容来对待。

    HN 评论精选

    上手门槛低,能让人很快做出原型,这对鼓励读者尝试很重要。

    我是 Idyll 的忠实用户,尤其喜欢它很容易上手;这是我第一次看到它后不到 20 分钟做出来的东西的截图。另外也推荐一下 Idyll 使用的解析库 nearley。

    hardmath123查看英文原文

    I'm a big fan of Idyll, especially how easy it is to get started with. Here's a screenshot of something I made not more than 20 minutes after first seeing it [1]. Also, can I put in a plug for nearley [2], the parsing library that Idyll uses? The Idyll parser is here [3]. [1] https://imgur.com/a/5I143 [2] http://nearley.js.org [3] https://github.com/idyll-lang/idyll/blob/master/packages/idyll-compiler/src/grammar.ne

    术语有歧义,文档最好让读者直接操作示例,而不是只靠动画和截图解释。

    我最近正想找类似的东西,但没搜到。我花了一会儿才明白“交互叙事”是什么;这个说法我没怎么听过,以为更像文字冒险。幸好点了链接,因为这几乎正是我要找的,而且看起来会很好用。我很喜欢这个项目,打算尽快试试。我想了解项目成熟度:git 记录近一年,开发不少;示例看起来功能足够有用。文档相当精致,显然下了功夫,尤其动画。让我有点不安的是,直接展示实际控件似乎更省事;这个工具应该能用交互叙事来介绍自己。这是长期意图还是超出范围?能在文档里直接玩这些组件会很好。

    dpwm查看英文原文

    I was looking for something like this fairly recently. I can't remember what I actually searched for, but I didn't find this. It took me a minute to understand what interactive narratives were. It's not a term I've really heard before so I imagined something more like a text adventure. I'm so glad I clicked the link anyway because this is pretty much exactly what I was looking for and it looks like it will work great. I really like the project and intend to try it sometime soon. I am trying to understand how mature this project is. The git log seems to go back almost a year but there does appear to be quite a lot of development. The examples seem to work well enough for me to believe this project has enough features to be useful. The documentation is rather polished and effort clearly went into it, especially with the animations. The thing that keeps slightly perturbing me is that it seems like it would have been less work to show the actual widgets. It seems like the tooling should be able to provide interactive narratives for using the tooling. Is this a long term intention or is it seen as outside the scope of the project? To play with the widgets themselves in the documentation seems like it would be really nice.

    同类还值得读

    1. Pixar in a Box:可汗学院的皮克斯讲故事课

      Pixar in a Box – Khan Academy

      这篇是 Khan Academy 与 Pixar 合作的“Pixar in a Box”项目介绍,用计算机图形和动画制作来讲解数学概念。

      讲故事与叙事2015 · 753 分 · 65 评4 条写作要点编辑精选
    2. 皮克斯的讲故事法则

      Pixar's Rules of Storytelling (2013)

      这是皮克斯动画工作室流传甚广的 22 条讲故事法则清单,从“从前有个___,每天___,有一天___”的骨架,到如何重写自己讨厌的作品。

      讲故事与叙事2018 · 513 分 · 74 评4 条写作要点编辑精选
    3. 皮克斯通过可汗学院提供免费在线讲故事课程

      Pixar offers free online lessons in storytelling via Khan Academy

      这篇报道介绍皮克斯与可汗学院合作的免费在线课程《讲故事的艺术》,把皮克斯内部的故事创作方法公开给普通学习者。

      讲故事与叙事2017 · 503 分 · 93 评4 条写作要点编辑精选
    4. 用皮克斯的故事公式说服投资人

      Use Pixar's story formula to win over investors

      这篇文章借用皮克斯的故事公式(以《海底总动员》为例)来示范如何给投资人讲创业路演故事:先讲目标、再讲障碍、最后讲改变。

      讲故事与叙事2021 · 439 分 · 188 评4 条写作要点编辑精选
    5. 贝索斯如何把叙事变成亚马逊的竞争优势

      Jeff Bezos Turned Narrative into Amazon's Competitive Advantage

      这篇讲杰夫·贝索斯如何把“六页叙事备忘录”变成亚马逊的管理与竞争优势:用可独立阅读的叙述性文档替代口头汇报和 PowerPoint。

      讲故事与叙事2019 · 435 分 · 181 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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