项目介绍
vRain 是 GitHub 上的中文古籍刻本风格直排电子书生成器。它模拟传统雕版印刷流程:先渲染宣纸/竹简背景,再按“右起竖排”坐标逐字压印,生成可检索、可注释、体积仅原扫描图三十分之一的 PDF。项目用 Perl 编写,开源 GPL,已在百万字级《资治通鉴》样本上验证十分钟出片。
核心功能
使用方法
1. 安装依赖
# Ubuntu / Debian
sudo apt install perl imagemagick libimage-magick-perl \
libpdf-builder-perl fonts-noto-cjk
# macOS (Intel)
brew install perl imagemagick
cpan Image::Magick PDF::Builder
2. 准备文本
text/
└── 论语.txt # 用【注】夹批注,%换页,$换半叶
3. 配置刻本
编辑 book.cfg 示例:
[page]
width=148mm
height=210mm
columns=10
rows=20
background=xuanpaper.jpg
[font]
main=AR PL UKai CN
fallback=Noto Serif CJK SC
size=12pt
4. 一键生成
perl vrain.pl --config book.cfg --output 论语直排.pdf
百万字约 12 分钟,输出 6 MB PDF(原扫描 180 MB)。
代码演示:自定义鱼尾
在 book.cfg 追加:
[fish-tail]
type=double # single | double | black
position=center
重跑脚本即可在页面中心生成黑白双鱼尾,完全像素级对齐。
优势对比:vRain vs 传统扫描
总结
vRain 把繁琐的古籍数字化简化为“文本 + 配置”两文件,十分钟直出可检索、可批注、可换背景的直排 PDF,体积压缩 30 倍。无论是研究、出版还是小红书“兀雨书屋”式分享,都能一键搞定。立即克隆仓库,让千年刻本在屏幕上重生!