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

    出版与作家生涯2016rkrishnan.org

    Brian Kernighan 谈《Go 程序设计语言》一书的排版

    Brian Kernighan on the Typesetting of “The Go Programming Language” Book

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

    导读

    这篇围绕 Brian Kernighan 谈《Go 程序设计语言》一书的排版展开,记录技术书制作中的工具与工艺选择。评论区把话题延伸到 troff 的维护、TeX/LaTeX 与 Prince 等排版方案,以及网页排版在移动端的可读性。对写作者来说,它提醒我们排版不是装饰,而是技术写作生产质量和阅读体验的一部分。

    关键词 排版技术写作TeX/LaTeX工具选择

    可以直接用的写作要点

    1. 01

      技术书排版要选长期有人维护、生态活跃的工具,避免把项目绑在无人维护的旧工具上。

    2. 02

      若追求高标准技术书排版,TeX/LaTeX 的学习曲线值得投入;可先沉淀模板和流程,让后续写作复用。

    3. 03

      用 HTML/CSS 等熟悉技术做分页排版能降低门槛,但要评估工具生态、开源替代和长期成本。

    4. 04

      发布前用移动端检查阅读体验,长文本不要塞进 <pre> 造成横向滚动。

    HN 评论精选

    排版工具的选择要考虑长期维护和社区延续性。

    可惜的是,这里用到的工具目前无人维护;GNU troff 正在招募维护者,且维护该软件包需要把版权转让给 FSF,并确保后续贡献者也签署相关文件。

    baldfat查看英文原文

    Sadly the tool used is not maintained currently GNU troff is looking for a maintainer. If you’re interested, please take a look at this general information about GNU packages and being a GNU maintainer, and then email maintainers@gnu.org with a bit about your background and particular interest in this package. Thanks. Please note that maintaining this package requires assigning copyright to the FSF, and ensuring that any future contributors also execute papers, since that is what past authors and contributors have done.

    高标准技术书排版值得投入 TeX/LaTeX,且其生态仍在发展。

    作为排版爱好者,我试过这里提到的大部分方案(Prince、Troff、Lout、Docbook XML、Asciidoc、LaTeX、ConTeXt 等,除了图形界面工具)。TeX 远看似乎很差,多半是道听途说;直到你要写一本达到一定高生产标准的技术书,才会发现 TeX 最有可能帮你做到。它有学习曲线,是时间投资,但会有回报。而且 LaTeX 等并非停滞不前,每天都有公司和团队改进生态。我个人喜欢 ConTeXt,除非已有预设模板(比如会议投稿),这时直接用他们的 LaTeX 指南更合理。

    FraaJad查看英文原文

    As a typesetting aficionado, I have tried most of the suggestions here (Prince, Troff, Lout, Docbook XML, Asciidoc, LaTeX, ConTeXt, .. except GUI typesetting tools.) TeX appears bad from a distance, mostly from hearsay, until you have to write an actual technical book of certain expected high production standards and you realize TeX gives you the best shot at doing so. There is a learning curve. It is an investment of your time, but it pays off. Also, it is not like LaTeX et al are standing still in time. There are companies and teams working on improving the ecosystem everyday. I personally like ConTeXt unless I'm doing a predefined template exists (for conferences etc.,) where it makes sense to just use their LaTeX guidelines.

    网页排版要照顾移动端,别让长文本横向滚动。

    讽刺的是,这个页面把 Kernighan 教授的邮件放在 <pre> 标签里排版,结果移动端用户得左右滚动一百次才能读完。

    octref查看英文原文

    Ironically this page typesets Prof. Kernighan's email in a <pre> tag so mobile users could enjoy scrolling left and right 100 times to read it.

    用熟悉的 Web 技术做分页排版可降低门槛,但需注意工具生态和开源替代。

    最近我在玩 Prince,发现它很强大,对分页媒体支持极好。由于文档用 HTML、CSS、JavaScript、SVG 构建,大多数人也熟悉这些技术。不过 Prince 似乎没有开源竞争对手。

    oxplot查看英文原文

    Recently I've been playing with Prince [1] and I've found it to be very powerful with excellent support for paged media. Given that HTML, CSS, Javascript, SVG is used to build the document, it's also familiar to most people already. There doesn't seem to be any open source competitor to Prince though. [1]: http://www.princexml.com/

    同类还值得读

    1. 写书:值得吗?

      Writing a book: is it worth it?

      Martin Kleppmann(《设计数据密集型应用》作者)复盘写书到底值不值:金钱回报低、耗时极长,但带来了可见度、信任和职业机会。

      出版与作家生涯2020 · 642 分 · 287 评4 条写作要点编辑精选
    2. 写书并不是个好主意

      Writing books is not really a good idea

      这篇文章讨论靠写书谋生的现实难度,评论区从版税数学、收入预期和写作目标三个角度补充了作者视角。

      出版与作家生涯2021 · 577 分 · 609 评4 条写作要点编辑精选
    3. 如何自助出版一本书:实用资源清单

      How to self-publish a book: A handy list of resources

      这是一份关于「如何自助出版一本书」的资源清单帖,涵盖从编辑、排版到 ISBN、销售渠道的实操工具与花费。

      出版与作家生涯2018 · 558 分 · 88 评4 条写作要点编辑精选
    4. 我自助出版一本Ruby on Rails书,赚了7万美元

      How I Made $70k Self-Publishing a Book about Ruby on Rails

      这是一篇 Ruby 开发者自述:他把一套 Rails 性能课程(书+视频+答疑)自出版,一年毛收入约 7 万美元,并总结了选题、定价、营销等经验。

      出版与作家生涯2017 · 539 分 · 175 评4 条写作要点编辑精选
    5. 石黑一雄警告年轻作家因“恐惧”而自我审查

      Sir Kazuo Ishiguro warns of young authors self-censoring out of 'fear'

      石黑一雄提醒年轻作者因“恐惧”而自我审查,即这条帖子讨论的核心。

      出版与作家生涯2021 · 396 分 · 641 评5 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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