写作方法2016unconj.ca
在 Emacs 里用 ProseLinter 检查散文的文字问题
Linting Prose in Emacs with ProseLinter
导读
这篇介绍如何在 Emacs 里用 ProseLinter 对文章做"文风检查"(lint),把代码世界里自动检查的习惯搬到写作上。对写作者来说,它提供了一种把风格规范、常见毛病变成可自动提醒的思路,值得一读。
可以直接用的写作要点
- 01
把文风检查接进写作流程:写完一段就跑一次 linter,比事后通读更容易发现口头禅、冗余和套话。
- 02
工具不必绑定编辑器——ProseLinter 是命令行 Python 工具,可直接用在 Markdown、reStructuredText 和整本书的项目里。
- 03
可以把常犯的错误沉淀成一份自己的检查清单或风格指南,让"审稿"部分自动化,人只管内容。
- 04
像 Garner 用法词典、经济学人风格指南这类权威规范,值得当成写作时的参照标准,逐条对照修改。
HN 评论精选
权威用法词典应当被工具化,变成写作时的即时参考。
Proselint 很棒!我一直想要这样的工具。我还想要另一样东西:有人把 Garner 的用法词典做成一个 Emacs 模式。那本书简直天生就该变成一个软件工具。
tptacek查看英文原文
Proselint is neat! I've wanted something like this forever. The other thing I want: someone to build an Emacs mode out of Garner's usage dictionary. That book is begging to be a software tool.
这类检查工具可独立运行,适合 Markdown/rst 和整本书的写作项目。
ProseLinter 挺酷,它是 Python 写的,可以用 pip 装成命令行工具,不需要 Emacs。我刚拿它跑了一些 reStructuredText 文件,看起来它同时支持 rst 和 markdown。对我正在用 Sphinx 写的一本书会很有帮助,谢谢。
mixmastamyk查看英文原文
Proselinter looks pretty cool, it is python and can be installed with pip as a command-line tool. Doesn't need Emacs! I just ran it on some reStructuredText files and it looks that it supports them as well as markdown! It's going to be very helpful for a book in sphinx I'm working on, thank you.
希望 linter 能对接具体风格指南,让规范落地可执行。
这个很不错。如果能用来遵循《经济学人》风格指南这类规范就更好了。
ArnoldP查看英文原文
This is really cool, It would be nice for adhering to style guides such as http://www.economist.com/styleguide/introduction/
同类还值得读
被低估的工程技能:把文章写好
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 条写作要点编辑精选