想把一个很牛的连载帖子做成可以检索的在线电子书,方便查找浏览。
搜索了一下,read the doc不错,同时还有很多替代品,比如gitbook。https://alternativeto.net/software/read-the-docs/
但需要先安装nodejs。
Nodejs安装和设置
按照最常规的下载然后解压,设置连接
ln -s a b 中的 a 就是源文件,b是链接文件名,其作用是当进入b目录,实际上是链接进入了a目录
https://www.cnblogs.com/hxy5/p/9460063.html
https://www.runoob.com/nodejs/nodejs-install-setup.html
https://www.jianshu.com/p/d68e461f585c
https://www.cnblogs.com/zhi-leaf/p/10979629.html
运行 node -v正常 ,但运行npm -v遇到错误:Cannot find module '../lib/utils/unsupported.js'。搜索一圈都让删掉重装。
用find /etc -name node搜索相关的所有文件并删掉,同样在/usr里面,npm文件同理删除。
删掉后重新用 yum install nodejs安装。
但运行node -v会提示 /usr/local/bin/node: 没有那个文件或目录
再次搜索node会发现/usr/bin/node里存在,运行之/usr/bin/node -v,/usr/bin/npm -v,都成功了 。
看来是很PATH设置的问题,找不到usr/bin下面的程序。https://www.jianshu.com/p/ea6c4758dba4
那么就连接一下吧:
sudo ln -s /usr/bin/npm /usr/local/bin/npm
sudo ln -s /usr/bin/node /usr/local/bin/node
现在成功了。可能常规安装方法也是有类似的问题,说不定可以成功。
gitbook安装
然后安装gitbook-cli:sudo npm install gitbook-cli -g。
更换npm为国内源: sudo npm config set registry=http://registry.npm.taobao.org -g。http://www.blogdaren.com/post-2567.html
这回运行gitbook -V检查版本。成功。
https://www.jianshu.com/p/421cc442f06c
生成第一本书
在想生成书的目录下,运行gitbook init,会建立初始的文件。
修改summary框架,和相应的md文件即可。可以用 notepad++的 markdown插件编写。
markdown语法。https://www.jianshu.com/p/191d1e21f7ed
编写完之后,运行gitbook build生成结果,即_book目录下的html网页 。
https://www.jianshu.com/p/dc53e589897a
https://chrisniael.gitbooks.io/gitbook-documentation/content/build/push.html
https://tonydeng.github.io/gitbook-zh/gitbook-howtouse/output/outfile.html