用途
文件分享
- 注册github账号
- 创建项目的Github Pages
- 通过git客户端提交文件
个人网站
- Jekyll和Github搭建个人静态博客
- 使用 github + jekyll 搭建个人博客
- 新开页面链接写法：
[标题](链接){:target="_blank"}
多人协作
通过clone来多人编辑gitbook
jekyll
命令
- 创建网站目录：jekyll new dir
- 启动网站：cd dir; jekyll serve –watch
本地网站
模板
- https://www.zhihu.com/question/20223939
- https://github.com/jekyll/jekyll/wiki/Sites
- https://jekyllthemes.io/
gitbook
使用
- 去https://www.gitbook.com注册，管理github账号，创建book
- 下载book。熟手不建议用gitbookEditor。
- 用git管理工具(SourceTree)下载到本地。如是github授权注册的，需在gitbook网站上初始化密码。
- 用”gitbookEditor”导入book到本地
- 编写SUMMARY.md，通过“gitbook init”自动生成所有目录和文件
命令
- 运行(会同时执行编译，监听和运行端口是可选项)：gitbook serve –lrport 35729 –port 4000
- 自动创建所有目录和文件：gitbook init
- 自动安装插件：gitbook install
- 编译：gitbook build
安装
windows/Mac
- 参考
[下载](https://nodejs.org/en/) npm install gitbook-cli -g gitbook -V
服务器(centos)
- 安装gitbook
// 需要git，nodejs，npm，gitbook yum -y install git yum -y install nodejs yum -y install npm npm config set registry https://registry.npm.taobao.org // 推荐使用国内npm镜像 // npm install -g gitbook // 新版本貌似不用安装了 npm install -g gitbook-cli gitbook -V
部署使用
- 每个book是1个网站
初始化
- 编写book.json
- 脚本
git clone ${git_path} ${path} cd ${path} gitbook install gitbook build - 启动脚本
git -C ${path} checkout master // git下载代码 git -C ${path} pull cd ${path} lsof -i :4000 | awk '{print $2}' | xargs kill -9 gitbook install gitbook serve --lrport 35729 --port 4000 // 非服务器使用 nohup gitbook serve --lrport 35729 --port 4000 >/dev/null & // 服务器使用
