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

    写作方法2014speedcite.com

    Show HN:为文章一键生成引用

    Show HN: One-click citations for your essays

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

    导读

    这是一个一键生成论文引用的在线工具(SpeedCite):输入网址、DOI 或 ISBN,就能得到 MLA、APA、Chicago 等格式的引用。HN 评论一方面分享了用 DOI 按需生成引用的命令行技巧,另一方面也用实际测试暴露了自动抓取元数据时标题被截断、书籍页面无法识别等问题。对写作者来说,这篇值得一读,因为它既展示了提高效率的办法,也提醒我们:自动生成的引用必须逐条核对。

    关键词 引用管理学术写作文献工具引用格式

    可以直接用的写作要点

    1. 01

      引用工具能省去手工排版的时间,但自动抓取的标题、作者常会出错(例如把标题截成 "Show HN: One."),提交前务必对照原文逐条核对。

    2. 02

      与其维护一个庞大的 bibtex 文件,不如只记录“引用键: DOI”的对照表,再按需生成所需格式的引用。

    3. 03

      同一篇文献按投稿要求可能需要 MLA、APA 或 Chicago 等不同格式,写作前先确认目标格式再统一生成。

    4. 04

      给引用工具输入 DOI、ISBN 这类规范标识,通常比直接粘贴任意网页 URL 更可靠。

    HN 评论精选

    用 DOI 按需拉取引用格式,维护 DOI 对照表比维护庞大的 bibtex 文件更轻便。

    感兴趣的话,可以用 curl 在命令行做类似的事,试试这些命令:[三个 curl 示例,分别请求默认书目信息、bibtex 和 apa 格式]。学会这个之后,我的学术生活轻松多了:现在我只需要维护一个“引用键: DOI”的对照表,而不用维护一个庞大的 bibtex 文件。是的,我试过 Mendeley 之类的工具,但我确实更喜欢能按我说的去执行的脚本。

    aaren查看英文原文

    For interest, you can do something like this on the command line using curl. Try these: curl -LH "Accept: text/bibliography" "http://dx.doi.org/10.1017/S0022112061000019" curl -LH "Accept: text/bibliography; style=bibtex" "http://dx.doi.org/10.1017/S0022112061000019" curl -LH "Accept: text/bibliography; style=apa" "http://dx.doi.org/10.1017/S0022112061000019" My academic life became a lot simpler when I learnt this - now I only need to maintain a database of {cite key: DOI} pairs, rather than a bibtex monster. Yes, I have tried Mendeley et al. and yes, I do prefer scripts that do what I tell them to.

    自动抓取网页元数据会截断标题,生成引用后必须人工核对。

    把本帖的 URL 输入 speedcite 后,返回的标题信息被截断了:MLA 格式输出为 "Show HN: One." Ycombinator.com. N.p. Web. 30 Apr. 2014;APA 和 Chicago 格式同样只得到 "Show HN: One."。

    bradknowles查看英文原文

    Going to the URL for this page (https://news.ycombinator.com/item?id=7674449) and plugging that into speedcite, I get back truncated information on the subject line: The MLA format cite comes out as: "Show HN: One." Ycombinator.com. N.p. Web. 30 Apr. 2014. <https://news.ycombinator.com/> The APA format cite comes out as: Show HN: One. Ycombinator.com. Retrieved Apr 30, 2014, from https://news.ycombinator.com. The Chicago formate cite comes out as: "Show HN: One." Ycombinator.com. https://news.ycombinator.com/.

    工具对电商或书籍页面支持不佳,输入来源的类型有限。

    我在亚马逊图书首页点了一本书,用 URL、ISBN 或 ISBN-14 都无法让它工作。例如 John Green 的《The Fault in Our Stars》平装本页面链接就无法识别。

    rkuykendall-com查看英文原文

    I clicked a book on the Amazon Books homepage and couldn't get it to work with the URL, ISBN, or ISBN-14. The Fault in Our Stars Paperback by John Green: http://www.amazon.com/The-Fault-Stars-John-Green/dp/014242417X/ref=acs_ux_rw_ts_b_books_2_i/181-1226938-4232212?_encoding=UTF8&s=books&pf_rd_m=ATVPDKIKX0DER&pf_rd_s=merchandised-search-5&pf_rd_r=1KBZV025GCFHMJHM3TAC&pf_rd_t=101&pf_rd_p=1615333102&pf_rd_i=283155

    同类还值得读

    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

    关注向阳乔木

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

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

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