开源啦~ 开源啦~ 有自己出版电子书需求的同学欢迎自取~

王福强

2021-01-14

原本只是简单回复一下，没想到这位兄弟当真了，唉， 罢罢罢，谁让俺脸皮薄呢， 就顺势开源了吧！

如果你也习惯用Markdown码字，那么， https://github.com/keevol/pandoc_md_book_starter这个项目或许你也会感兴趣， 因为切换语法或者语言的习惯成本还是挺大的 1， 毕竟，最终还是内容为王嘛， 工具只要自己趁手就好。先前《深度思考揭秘》和《极简管理课》2两本ebook其实就是使用这个项目构建的。

https://github.com/keevol/pandoc_md_book_starter基于Pandoc 3和Markdown-PP 4两个核心项目构建， 其中Markdown-PP的作用就是可以让我们以更加结构化的形式组织内容（比如分章节，自主调整内容目录和排布等）， 而Pandoc则是生成html/pdf和epub格式电子书的关键。

NOTE

开源的内容摘除了发送邮件的逻辑和脚本，因为牵扯私人邮件账户内容和电子书交付逻辑。

整个项目是一个脚手架/模板项目，可以直接Clone或者Fork，然后在其基础上进行定制和使用。核心代码在bin目录，就是一堆脚本。 而电子书的源码(内容编写部分)则在src目录下，一个简单的Convention是，存在一个index.md的索引或者整书的入口文件（其内容夹杂了Markdown语法和Markdown-PP的自定义语法）， 其它章节内容则分目录存放和编写，每个目录下原则有一个Markdown源文件以及一个images目录用于存放插图。大家查看了项目的src目录样例之后应该可以一目了然。

内容编写完之后，可以使用bin目录下脚本编译并生成相应格式的输出结果， 项目支持html,PDF以及epub格式，输出结果位于${CURRENT_DIR}/build目录下。

NOTE

epub虽然也支持，但实际上并未规模化使用和交付，如果需要，请自行改进一下吧~

如果使用过程中有什么问题，也可以到项目主页提issue，当然request merge就更好了。

GL & HF

  1. 老胡之前推荐了https://github.com/mraible/infoq-mini-book, 也很完备， 但却要用asciidoc来书写，所以没有采纳，有习惯用asciidoc的兄弟则可以自取↩︎

  2. https://afoo.me/books.html↩︎

  3. https://pandoc.org/↩︎

  4. https://github.com/jreese/markdown-pp↩︎

>>>>>> 更多阅读 <<<<<<

「福强私学」来一个？

「福强私学」, 一部沉淀了个人成长、技术与架构、组织与管理以及商业上的方法与心法的百科全书。

footer img for kb.afoo.me

开天窗，拉认知，订阅「福报」，即刻拥有自己的全模态人工智能。

订阅「福报」