gitbook installation and use, and use docker deployment

This article briefly introduces how to install and use gitbook, and finally how to use docker to build a book image.

1. Precondition

Need Nodejs environment, install npm, domestic users install cnpm

npm install -g cnpm --registry=https://registry.npm.taobao.org

2. Install gitbook

cnpm install -g gitbook-cli
gitbook -V 
CLI version: 2.3.2 Installing GitBook 3.2.3 gitbook@3.2.3 ..\AppData\Local\Temp\tmp-20544doJtj1hfVp40\node_modules\gitbook ├── escape-string-regexp@1.0.5 ├── escape-html@1.0.3 。。。。 GitBook version: 3.2.3

3. Using gitbook

3.1 Generate table of contents and book structure

mkdir docker-start
gitbook init
warn: no summary file in this book
info: create README.md info: create SUMMARY.md info: initialization is finished

Edit Summary.md and enter:

* [简介](README.md)
* [1.Docker入门](chapter1/README.md) - [1.1 什么是Docker](chapter1/section1.md) - [1.2 Docker基本概念](chapter1/section2.md) - [1.3 安装Docker](chapter1/section3.md) - [1.4 使用Docker镜像](chapter1/section4.md) - [1.5 操作容器](chapter1/section5.md) - [1.6 访问仓库](chapter1/section6.md) - [1.6 数据管理](chapter1/section7.md) * [2.使用Docker部署web应用](chapter2/README.md) - [2.1 编写DockerFile](chapter2/section1.md) - [2.2 编写web应用](chapter2/section2.md) - [2.3 构建镜像](chapter2/section3.md) - [2.4 运行web应用](chapter2/section4.md) - [2.5 分享镜像](chapter2/section5.md) * [结束](end/README.md)

Execute again:

gitbook init
info: create chapter1/README.md
info: create chapter1/section1.md
info: create chapter1/section2.md
info: create chapter1/section3.md info: create chapter1/section4.md info: create chapter1/section5.md info: create chapter1/section6.md info: create chapter1/section7.md info: create chapter2/README.md info: create chapter2/section1.md info: create chapter2/section2.md info: create chapter2/section3.md info: create chapter2/section4.md info: create chapter2/section5.md info: create end/README.md info: create SUMMARY.md info: initialization is finished

3.2 Generate Books

use:

gitbook serve .
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed
info: loading plugin "livereload"... OK info: loading plugin "highlight"... OK info: loading plugin "search"... OK info: loading plugin "lunr"... OK info: loading plugin "sharing"... OK info: loading plugin "fontsettings"... OK info: loading plugin "theme-default"... OK info: found 16 pages info: found 15 asset files info: >> generation finished with success in 4.0s ! Starting server ... Serving book on http://localhost:4000

Visit  http://localhost:4000  to see the book

enter description here

Edit the generated md, gitbook will automatically restart,

enter description here

In the current directory, a _book directory will be generated, which contains the generated static html, which can be published to the server for direct use.

4. Publish gitbook books using docker

First copy the contents of the _book directory to a new directory.

Then write the Dockerfile

FROM nginx
WORKDIR /usr/share/nginx/html
ADD . /usr/share/nginx/html
EXPOSE 80

build:

docker build -t docker-start-web .
Sending build context to Docker daemon  4.766MB Step 1/4 : FROM nginx ---> 3f8a4339aadd Step 2/4 : WORKDIR /usr/share/nginx/html Removing intermediate container a4232f4b6b62 ---> 91a66299ecad Step 3/4 : ADD . /usr/share/nginx/html ---> 9a9fef80da3b Step 4/4 : EXPOSE 80 ---> Running in 59f2b829aba6 Removing intermediate container 59f2b829aba6 ---> b92c92688046 Successfully built b92c92688046 Successfully tagged docker-start-web:latest

implement:

docker run -p 4000:80 --name docker-start-web -d docker-start-web
f91cf4446b3746c665476b3dd214446a941d838fa9a3ad47680190bb08c9aa48

You can view it by accessing the server ip:4000.


Author: Jadepeng
Source: jqpeng's technical notepad -- http://www.cnblogs.com/xiaoqi
Your support is the greatest encouragement to bloggers, thank you for your careful reading.
The copyright of this article belongs to the author, and you are welcome to reprint it, but this statement must be retained without the author's consent, and a link to the original text is given in an obvious position on the article page, otherwise the right to pursue legal responsibility is reserved.

Guess you like

Origin http://43.154.161.224:23101/article/api/json?id=325904583&siteId=291194637