mdbook-reading-time 操作手册
mdbook-reading-time 用于计算当前章节的字词数量和预计阅读时间。
原仓库:https://github.com/pawurb/mdbook-reading-time
本页实际结果
本页字词数:484
预计阅读时间:1 minute
这两个值由插件在构建时替换。
两个核心占位符
插件不会自动把结果插到页面中,需要在 Markdown 中主动放置占位符。
字词数
484
构建后替换为当前章节的 word count。
阅读时间
1 minute
构建后替换为类似:
9 minutes
样例:文章标题下显示阅读信息
# FlowANN
> 484 words · 1 minute
正文……
样例:只显示预计阅读时间
预计阅读:1 minute
当前配置
[preprocessor.reading-time]
words-per-minute = 250
插件默认是 200 WPM;当前书库改为 250 WPM。
概念上的计算关系是:
reading time ≈ word count / words-per-minute
例如:
1000 words / 250 WPM ≈ 4 minutes
调整阅读速度
希望预计时间更长,可以降低 WPM:
[preprocessor.reading-time]
words-per-minute = 180
希望预计时间更短,可以提高 WPM:
[preprocessor.reading-time]
words-per-minute = 300
这个参数只影响 reading_time,不会改变 word_count。
常用放置位置
标题下方
# 文章标题
> 484 words · 1 minute
正文末尾
---
全文 484 words。
Frontmatter 卡片之后
如果页面同时使用 mdbook-frontmatter-render,可把阅读信息放在属性卡之后、正文之前。
中文与论文笔记
插件输出的是自身统计得到的 word count,再按 WPM 换算时间。中文、公式密集或代码很多的页面,应把结果理解为粗略阅读成本,而不是严格计时。
如果需要校准,选几篇你实际读过的长文,对照真实耗时后统一调整 words-per-minute 即可。