Skip to content

Latest commit

 

History

History
62 lines (41 loc) · 2 KB

7.md

File metadata and controls

62 lines (41 loc) · 2 KB

其他技巧补充

创建在其他目录下

gitbook init bookname

bookname是书籍名，这样会先创建一个bookname的目录，然后再生成SUMMARY.md和README.md。

在书籍目录下，可以看到多了一个_book目录，里面就是网页的内容。

[root@mail gitbook]# ll && ll _book/
total 20
drwxr-xr-x 3 root root 4096 Jun  9 09:24 _book
-rw-r--r-- 1 root root  307 Jun  9 09:36 book.js
-rw-r--r-- 1 root root  202 Jun  9 09:27 package.json
-rw-r--r-- 1 root root   16 Jun  7 20:44 README.md
-rw-r--r-- 1 root root   60 Jun  9 09:28 SUMMARY.md
total 16
drwxr-xr-x 10 root root 4096 Jun  9 09:24 gitbook
-rw-r--r--  1 root root 6172 Jun  9 09:24 index.html
-rw-r--r--  1 root root  568 Jun  9 09:24 search_index.json

将_book推送到服务器，就是一个静态网站。

Github部署

  • 先在Github创建一个书籍的工程

  • 将本地工程推送到Github的工程，在书籍目录下输入命令：

    git init
git add .
git commit -m "first commit"
git remote add origin https://github.com/PortgasAce/book.git
git push -u origin master

将上面的url换成自己工程仓库即可，执行完后刷新Github可以看到本地的书籍被推送到远程。

使用Git Pages服务 GitPages是一个将github仓库作为网页展示的服务。使用它可以将书籍变为在线浏览。 启用GitPages服务有两个选项，一个是将master分支作为展示分支，另一个是将master分支的docs目录作为展示目录。

由于我们将书籍的markdown源文件推送到了master分支，所以选择docs目录作为GitPages服务的展示目录会更好。接下来，我们将之前产生在_book目录的文件生成到docs目录。进入书籍目录，输入命令

gitbook build . ./docs

如果出现Error: ENOENT: no such file or directory, stat '/Users/portgas/Desktop/test/docs/gitbook/gitbook-plugin-sharing/buttons.js' 可以忽略。

然后推送到远程仓库，打开GitPages服务。