如何亲手构建电子书largescaleJS_ru用pandoc一键生成epub、fb2、mobi、pdf完整教程【免费下载链接】largescaleJS_ruRussian translation of Addy Osmani book.项目地址: https://gitcode.com/gh_mirrors/la/largescaleJS_rulargescaleJS_ru是 Addy Osmani 经典著作《Patterns for Large-Scale JavaScript Application Architecture》大型 JavaScript 应用架构设计模式的完整俄文翻译。本文带你亲手构建电子书借助pandoc和一条make books命令一键生成epub、fb2、mobi、pdf四种格式的成品书。全文约 5 分钟零俄语基础也能上手。 项目速览先看清这本书的结构在动手构建电子书之前花 1 分钟认识源文件的组织方式位置内容_includes/translation/rus/17 个 Markdown 章节从00_intro.md引言到16_credits.md鸣谢_config.ymlJekyll 站点配置定义书名与作者epub/电子书成品目录含 4 种格式书籍与封面cover.jpg由cover.psd设计稿导出Makefile构建电子书的核心入口章节源稿中配有大量清晰的架构插图例如这张订单打包 → 打标签 → 发货流程与 Facade / Mediator 协作图⚙️ 环境准备装好 pandoc 与 kindleGen构建流水线只需要两个外部工具这是全流程唯一的安装步骤工具作用负责环节pandoc万能文档转换工具Markdown → epub / fb2 / pdfkindleGenAmazon 官方转换工具epub → mobiKindle 设备用系统自带的包管理器安装pandocLinux / macOS / Windows 均有对应包下载kindleGen并加入系统 PATH只在需要 mobi 时使用克隆仓库到本地git clone https://gitcode.com/gh_mirrors/la/largescaleJS_ru cd largescaleJS_ru 一键构建电子书make books 的 5 步流水线全部构建逻辑集中在Makefile的books目标中运行一条命令即可make books它实际执行 5 个步骤books: cat ./_includes/translation/rus/[0-9]*.md | sed s/!-- //g | sed s/--//g ./epub/_source.md pandoc ./epub/_source.md -o ./epub/largescale-js.epub --toc-depth2 --epub-cover-image./epub/cover.jpg --epub-chapter-level2 pandoc ./epub/_source.md -o ./epub/largescale-js.fb2 --toc-depth2 --epub-cover-image./epub/cover.jpg --epub-chapter-level2 kindleGen -c1 -locale ru ./epub/largescale-js.epub -o largescale-js.mobi rm ./epub/_source.md逐步拆解合并章节cat按文件名顺序把 17 个章节拼成完整书稿epub/_source.md——数字前缀命名保证了合并顺序清理注释sed剔除!-- ... --形式的 HTML 注释避免残留到成品书里生成 epubpandoc完成第一次转换并绑定封面生成 fb2 mobi同一份源稿再转 fb2随后kindleGen -locale ru声明俄文环境产出适配 Kindle 的 mobi清理中间稿rm删除临时文件_source.md仓库中现存的这份可视为构建样例能直接打开预览全书。 章节里的插图会随源稿原样进入成品书比如这张错误处理模块图 pandoc 三大核心参数让 epub 更像正式出版物参数作用--epub-cover-image./epub/cover.jpg绑定 580×800 的封面图--toc-depth2目录收录到第 2 级标题章、节都进目录--epub-chapter-level2以第 2 级标题为章节切分 epub 内部结构书稿用二级标题分章这两个参数恰好与之匹配于是生成带完整目录的正规 epub。书中讲分层架构时用的模块订阅结构图下图与 pandoc 用标题层级组织目录的思路异曲同工 成品验收4 种电子书格式一次生成构建完成后epub/目录下的产物如下文件大小适用场景largescale-js.epub约 382 KB通用电子书格式主流阅读应用均支持largescale-js.fb2约 123 KB俄语区主流的 FictionBook 格式largescale-js.mobi约 924 KB老款 Kindle 设备largescale-js.pdf约 788 KB打印与固定版式阅读 fb2 是俄语读者的国民格式这正是本书同时输出 epub 与 fb2 的原因。PDF 不在make books里仓库中的largescale-js.pdf是提前构建好的。需要重新生成时在合并出_source.md之后、清理之前追加一条 pandoc 命令即可pandoc ./epub/_source.md -o ./epub/largescale-js.pdf --toc-depth2❓ 常见问题Q1README.md里的命令和 Makefile 不一样README 中的pandoc epub.md ...是早期手动流程的留档当前标准入口是make books一切以Makefile为准。Q2只改了一章需要重新构建吗需要。make books每次全量重新合并 17 个章节但整个过程很快改完任意一章直接重跑即可。Q3可以跳过 mobi 转换吗可以。如果只面向现代阅读设备装好pandoc后跳过 kindleGenepub / fb2 完全够用。Q4构建后的目录里少了_source.md这是正常现象——流水线最后一步会主动删除中间稿保持仓库整洁。✅ 总结3 个文件、1 条命令完成从 Markdown 到 4 种电子书格式的完整链路17 个章节 Markdown ──cat 合并──▶ _source.md ──pandoc──▶ epub / fb2 ──kindleGen──▶ mobi核心记住 3 点章节按数字前缀命名保证合并顺序正确--toc-depth2--epub-chapter-level2匹配二级标题分章的写法封面由--epub-cover-image绑定与源稿完全解耦。照着Makefile的books目标操作你也能为自己的 Markdown 书一键构建电子书。【免费下载链接】largescaleJS_ruRussian translation of Addy Osmani book.项目地址: https://gitcode.com/gh_mirrors/la/largescaleJS_ru创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考