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

    写作方法2022thorstenball.com编辑精选

    我写书时用到的工具(2018)

    The Tools I Use to Write Books (2018)

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

    导读

    这是 Go 语言书籍作者 Thorsten Ball 介绍自己写书工具链的文章:Markdown、pandoc、自定义脚本、纯文本工作流。它值得写作者一读,因为评论区里几位出过书的人几乎一致认为:工具只占边际影响,真正决定成败的是坐下来写完的动机,而格式排版问题都可以事后补救。

    关键词 写作工具写作动机结构规划自助出版

    可以直接用的写作要点

    1. 01

      选一套顺手的纯文本工作流后就别再折腾工具,把精力留给每天真正坐下写完的篇幅。

    2. 02

      先用 Markdown 之类的轻量格式写完全稿,再借助 pandoc 等工具转换格式;格式问题可以留到最后统一处理。

    3. 03

      动笔前先写一句话故事概括,再扩成三句话说明主要事件,层层展开,保证全书有连贯的主线和节奏。

    4. 04

      把「写作」和「排版出版」当成两件事:书稿完成后再处理页边距、页码、封面条码这些细致工作,别让它们干扰创作。

    HN 评论精选

    工具无关紧要,阻碍人写书的是动机不足;格式问题可以事后修补。

    我写过四本技术书,包括《经典计算机科学问题》系列。我同意 Thorsten 最后说的:这些工具其实都不重要,最多只是边际影响。大多数说想写书的人缺的是动机,而不是工具。2013 年我和 Apress 合作时他们用 Word 模板;Manning 允许用 asciidoc 或 Word 模板,我第一本书用 Markdown 写、再用 pandoc 转成 asciidoc,格式问题多到让我后两本书宁愿回去用 Word 模板。现在这本我打算试试 Leanpub 的类 Markdown 格式。但还是那句话:这些都不重要,格式以后能修,你必须坐下来写!

    WoodenChair查看英文原文

    I've written 4 technical books including the Classic Computer Science Problems Series (https://classicproblems.com). I agree with what Thorsten said at the end—none of this really matters—or it's marginal at most. Most people who say they want to write a book lack the motivation to do it. It's not the tools getting in the way. Apress used Word templates back in 2013 when I did my first book with them. Manning let you use asciidoc or Word templates when I worked with them. I wrote my first book with them in markdown and translated to asciidoc using pandoc. There were so many formatting issues and I found the tools for asciidoc so immature that I ultimately went to using their Word templates on my next two books with them despite preferring purely text formats. Now I'm working on my next book and I think I'm going to try self publishing. I'm liking leanpub's use of a markdown like format. But again none of this really matters. You can fix formatting later. You have to sit down and write! PS Thorsten's "Writing an Interpreter in Go" is great: https://amzn.to/3yLTJjE

    先用一句话、再三句话逐层扩展的「雪花法」,让故事从开头就有清晰的主线和结构。

    给感兴趣的人推荐「雪花法」(Snowflake Method):先写一句话摘要,再写三句话描述主要发生了什么,然后像分形一样不断扩展。这样从一开始就有一个情节连贯、结构规划好的故事。可能更适合虚构写作。

    yboris查看英文原文

    Maybe relevant to those interested: The Snowflake Method https://www.advancedfictionwriting.com/articles/snowflake-method/ The gist (might work better for fiction, unsure): write a single sentence summary, then, three sentences to describe what major things happen, then fractal it out - keep expanding. This way, from the start, you have a cohesive story with a planned-out arc.

    书籍排版制作有大量琐碎的印刷细节,这属于出版工程,与写作本身要分开对待。

    我帮一位作者用 Word 做过 KDP 自助出版,工作量不小——把书稿变成可印刷状态有大量细碎问题要解决。装订尤其麻烦:条码、封面元素的位置取决于书脊宽度,而书脊宽度又取决于字号、页边距、字数、纸张厚度。页码也是麻烦事:有的要求前后页不编号、有的要求重置、有的要求罗马数字加阿拉伯数字混排、有的要求居中或靠边,离页边距太近印刷厂就会不满。

    ggm查看英文原文

    I did KDP for an author, from Word. It wasn't nothing. I valued my labour at $0 to get experience, There are a LOT of fine-grained issues to resolve, bringing a book to printable state. Binding is it's own special hell: There are huge expectations of barcoding, which plays with your cover artwork, and the positioning of things on the cover is a function of the width of the spine, which is a function of pointsize, margins, wordcount, paper density/weight/thickness. I became very dependent on other peoples templates and calculators to "get this right" Perhaps the oddest part of this, is the join over paper and ePublishing: they are very unequal in terms of DPI expectations, for both font and artwork. I think the golden rule here is "preserve your pixels as long as you can" but there is also "think about metadata, in images and in fonts and text" because producing print ready PDF and ePub formats, the meta is what the printery/bindery is going to work with. EPSF and other stuff comes to the fore very quickly. Page numbering is another bugbear: some places demand you DONT number pre and post, some expect it to reset, some expect one to be roman numerals, the rest in decimals. some want it spine, some want it edge, some want it centered. Get too close to the margins, now the printer hates you...

    同类还值得读

    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

    关注向阳乔木

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

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

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