写作方法2020masteringemacs.org
如何在 Emacs 中写一本书
How to Write a Book in Emacs (2015)
导读
这是一篇 2015 年的实践文章,讲如何把 Emacs 当作写一整本书的写作环境:从结构组织、写作到导出成稿(如 PDF、EPUB)。对写作者的价值在于,它示范了如何用纯文本加轻量标记来管理长篇结构,让内容与排版分离;评论区还补充了模块化写作和可复现示例的思路。
可以直接用的写作要点
- 01
用纯文本加轻量标记写作,把排版交给导出工具,改稿时能专注于文字本身。
- 02
把长篇拆成可复用的内容块(主题、小节),再按需组装成章节,避免重复写作。
- 03
固定一套自己熟悉的编辑器与工作流,减少在工具之间切换带来的注意力损耗。
- 04
写完先导出成读者实际阅读的格式(如 PDF)通读一遍,检验成稿效果。
HN 评论精选
把内容拆成可复用的块再组装成章节,是管理长篇结构的有效方法。
我最近研究了一圈制作电子书的技术,发现 DITA 这个概念很有意思:先写可复用的内容块(叫 Topics),再把它们映射成章节,生成整本手册。DITA 本来是给技术手册用的,但我觉得把内容拆块同样适用于写书,甚至写博客。另外我试了 XMLmind 的 ebookc,能把一组 HTML 页面打包成 EPUB、PDF 等格式;和原文作者一样,我读电子书也更偏爱 PDF。
emmanueloga_查看英文原文
I recently explored a bit the (seemingly never ending!) landscape of ways to create ebooks. In the process, I found a number of technologies I did not know before: * https://www.dita-ot.org/ * http://projectmallard.org/ * https://www.xmlmind.com/tutorials/HTML5Books/HTML5Books.html I find the concept of DITA very interesting: to write reusable chunks of content (called "Topics"), that one can later map into chapters and sections to generate a whole manual. DITA is geared towards creating manuals, but got me thinking it would be a useful way of splitting content for books and even blog posts. Mallard seems inspired by DITA but more minimalist. Looks pretty cool if I was generating documentation for a software product. The last resource is what I will actually try [1]: "XMLmind Ebook Compiler (ebookc for short) is a free, open source tool which can turn a set of HTML pages into a self-contained ebook. Supported output formats are: EPUB, Web Help, PDF, RTF, WML, DOCX (MS-Word) and ODT (OpenOffice/LibreOffice)." Similar to the author of the OP, I also like PDF better than other formats for reading ebooks. 1: https://www.xmlmind.com/ebookc/download.shtml
选对并长期固定一个写作工具,能支撑整本技术书的写作。
我的《Powerful Python》就是用 Emacs 写的。简短地说:效果非常好。今天我想不出还有什么编辑器能让我写这种技术书。
redsymbol查看英文原文
I wrote Powerful Python in Emacs. In short, it worked great. Can't imagine choosing to write a technical book like that in any other editor today.
工具选择可考虑能否让代码示例与运行结果自动同步,保证示例可复现。
这跟 R 的 Bookdown 相比如何?Bookdown 除了常规的 Markdown 和 LaTeX,还能直接运行 R 代码,并把结果(表格、图表)嵌进书里。
datashow查看英文原文
How does this compare to R Bookdown ( https://bookdown.org/yihui/bookdown/ ), which can do the regular markdown stuff, plus LaTeX, and also run the R code and embed results (tables, plots, etc.) into the book?
同类还值得读
被低估的工程技能:把文章写好
Undervalued Engineering Skills: Writing Well
这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。
写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选每行只写一句话:让写作和修改都更轻松的排版法
Writing one sentence per line
这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。
写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选书面沟通是远程工作的超级能力
Written communication is remote work super power
这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。
写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选如何写出有用的文字
How to Write Usefully
保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。
写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选如何写得更清楚、想得更清楚,并学会复杂材料(PDF)
How to write more clearly, think more clearly, and learn complex material [pdf]
这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。
写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选