《资治通鉴》胶片版
TLDR: https://tongjian.qiaopang.com
作为一个喜欢且经常读史读古文的程序员,《资治通鉴》这样的大部头我读起来还是觉得非常费力。首先是时间上的开销很大 —— 一页纸往往要读上半小时到一小时,其中免不了查阅词典,了解生僻字词的读音和释义;其次是难以深度阅读 —— 大量的地名人名和时间的关系,无法很快厘清,因而对错综复杂的历史事件读之依旧是懵懵懂懂;再次,无论是实体书的阅读,还是电子书的阅读,笔记都很难处理,比如人物的图像,事件(主要是战争)的地图,无法和原文很好地一一对照。最后,三百万字,二百九十四卷的内容,往往令读者还未开始阅读便自我放弃了。
于是我便萌生了制作《资治通鉴》胶片版的念头。我可阅读的时间往往比较碎片化,所以希望闲暇时可以读上一小段,这样不必抱着大部头望而兴叹;我希望文档本身是活的,帮助理解内容的佐料(注释,图片,地图等)可以不断以一种简单轻量的方式被添加进来;此外,文档本身应该是精美的,看着舒服。这便是这个胶片版的最初的目标。
这个目标进一步细化,便成了这个样子:
- 选取质量上乘的《资治通鉴》 txt 版本
- 将文档切分成 294 卷,每卷一个胶片
- 自动生成符合 marp 格式的胶片,做一些格式上的处理
- 为引文生成不同的格式
- 每页胶片都自动放置一个 audio tag,可以播放本页的语音素材,比如:臣光曰
-
找相熟的小伙伴们创作每一张胶片的语音素材为每一张胶片自动生成语音素材 - 通读之,添加注释,相关图片和地图
制作出来的 slides 截图如下:
运行
本地需要有 nodejs 运行时,然后安装依赖:
make init
make dep
之后可以 make run
运行 http 服务器。服务器运行完毕后,可以在浏览器中打开 http://localhost:8080/
查阅。
如果要批量生成 html / pdf 版本,可以 make build
或者 make build-pdf
。
语音素材的生成
《资治通鉴》胶片版内的所有语音素材均使用 科大讯飞开放平台 的在线语音合成技术提供。目前使用的发音人为 讯飞楠楠。感谢科大讯飞的开放平台,我得以自动化生成所有语音素材。由于目前我使用的免费版有日 API 访问上限,所以所有内容生成语音素材尚需时日。
如果你想生成自己的语音素材,可以在科大讯飞开放平台创建账户,生成你的 appid / app_key,并将其配置到环境变量 XF_TTS_ID
和 XF_TTS_KEY
中。之后你可以使用 make gen-audios CHAPTER=xxx
来生成对应卷的语音素材。
如果你对生成语音素材感兴趣,可以看这几个工具:
- tools/cli/normalizer.js: 把原始的文本素材转化为 JSON。
- tools/cli/generator.js: 将 JSON 转化为 marp slides。
- tools/cli/tts.js: 读取
resources/_meta
中的文件,按章节生成语音素材。
如何编辑及添加素材
所有的素材都放在 slides/assets
下,按卷命名。
添加图片或者地图
以这张 slide 为例:
可以把对应的图片拷贝至 assets/images/001/jinyang.jpg
,然后在对应的 slide 页中使用 marp 的 图片语法,如下:
---
![bg left](assets/images/001/jinyang.jpg)
![](assets/audios/001/16.mp3)
赵襄子使张孟谈潜出见二子,曰:__「臣闻唇亡则齿寒。今智伯帅韩、魏而攻赵,赵亡则韩、魏为之次矣。」__ 二子曰:__「我心知其然也,恐事末遂而谋泄,则祸立至矣」__ 。张孟谈曰:__「谋出二主之口,入臣之耳,何伤也?」__ 二子乃阴与张孟谈约,为之期日而遣之。襄子夜使人杀守堤之吏,而决水灌智伯军。智伯军救水而乱,韩、魏翼而击之,襄子将卒犯其前,大败智伯之众。遂杀智伯,尽灭智氏之族。唯辅果在。
---
添加注释
注释使用 abbr
完成。以这张 slide 为例:
要注释的内容用 *[]:
括起来,注释放在 :
后即可。注意如果注释的内容前后没有标点或者空格,需要再原文中手工插入空格。
---
![](assets/audios/001/11.mp3)
及智宣子卒,智襄子为政,与韩康子、魏桓子宴于蓝台。智伯戏康子而侮段规,智国闻之,谏曰:__「主不备,难必至矣!」__ 智伯曰:__「难将由我。我不为难,谁敢兴之?」__ 对曰:__「不然。《夏书》有之曰:‘一人三失,怨岂在明,不见是图。’夫君子能勤小物,故无大患。今主一宴而耻人之君相,又弗备,曰不敢兴难,无乃不可乎!蜹、蚁、蜂、虿,皆能害人,况君相乎!」__ 弗听。
*[蜹]: ruì,指蠛 miè 蠓 měng,"醯酸而蠛蠓聚焉。" 《荀子 劝学篇》;古同「蚋」:"蚋蚁蜂虿,皆能害人。"
---
添加脚注
脚注比较特殊,正常的 markdown 脚注会放在整个文档最后,并不方便阅读,这里生成了 <div class="note">
完成。以这张 slide 为例:
其语法是在要注释的地方使用上标语法 ^xx^
,然后用 ::: note
和 :::
标注脚注的开始和结束。
---
![](assets/audios/001/64.mp3)
秦侵晋^1^。
::: note
在《吴子 励士 第六》中有这样两段文字:“行之三年,秦人兴师,临于西河,魏士闻之,不待吏令,介胄而奋击之者,以万数。”,“于是武侯从之。兼车五百乘,骑三千匹,而破秦五十万众。”区区52个字,记录了阴晋之战的经过。
:::
---
贡献
目前的版本是自动生成的,还很粗糙,我自己也在边读边整理。如果你遇到任何问题,欢迎提 issue,当然跟欢迎发 pull request。
鸣谢
河洛·基督大伯爵
原始 txt 素材来自 河洛中文社区,由【河洛·基督大伯爵 】整理校对。
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
精校小说尽在河洛中文社区:http://www.horou.com/
本电子书由【河洛·基督大伯爵 】整理校对,请勿转载。
版权归原作者所有,文本仅供试读,请勿用于一切商业用途!
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
科大讯飞开放平台
tts 的质量相当上乘,在此感谢!