Gitbook
gitbook 首先是一个软件,正如上面定义的那样,它使用 Git 和 Markdown 来编排书本,如果用户没有听过 Git 和 Markdown,那么 gitbook 可能不适合你!
一般有两个方式使用gitbook,最终都会呈现给用户,两种方式分别为:gitbook本地制作和gitbook页面制作
gitbook本地制作
原理:gitbook本地使用+推送到github+设置github page=实现和gitbook一样的显示效果,下面是步骤:
安装Node.js,这个你直接上网百度吧,安装教程很多。
安装gitbook:npm install -g gitbook-cli
检查gitbook是否安装成功:gitbook -V
开始使用gitbook gitbook init
会出现两个文件README.md和SUMMARY.md
在SUMMARY.md文件内容中写入如下内容:
再继续一次gitbook init
,这时可以看到,gitbook就自动生成了这些目录了(第一章,第二章等目录结构)。再运行gitbook serve
来预览这本书籍
使用gitbook build
命令来生成最终的项目:
命令执行结束后,会在项目下生成_book
的文件夹,此文件夹就是最终生成的项目。 在_book
文件夹里有一个index.html
文件,这个文件就是文档网站的HTML入口,把_book
文件夹复制到服务器,然后把web服务的入口引向index.html
即可完成文档网站的部署。(你可以自己找个tomcat试下,应该可以的),不过我这里不是使用tomcat来部署,而是使用github page来部署。
(如果你想查看输出目录详细的记录,可使用gitbook build ./ --log=debug --debug
来构建查看。)
去Github上创建一个公开仓库,取名为随意(我取名为test)。创建完后,你到本地_book目录下执行:
gitbook线上制作
我对于Gitbook的简单使用我就探索到这了,我的基本要求已经满足了,
最后更新于
这有帮助吗?