用gitbook写一本书
与博客不同,一本书相对内容更为完成,更为体系。博客相比之下就零散的多。不过优秀的系列博客也常常被改编成书。
如果你想分享规模更大,成体系的知识的话,写本小书是个很好的选择。
本文介绍一个工具GitBook
,可以用Markdown写书,放在GitHub上,生成网页版和PDF版本的书籍。相较传统的Latex,更简单方便。适合当代程序员。
本文参考的资料主要来源于官网,相较之下,重点更突出,可以快速地 初始化、撰写、发布 一本书。
Install gitbook command line tool:
1 | npm install gitbook-cli -g |
Create a book:
1 | gitbook init ./directory |
Preview and serve your book:
1 | gitbook serve |
Or build the static website:
1 | gitbook build |
Debug for better error message with stack trace:
1 | gitbook build ./ --log=debug --debug |