Ubuntu 安装 Gitbook 步骤和使用方法详解 以及 阿里云基于 Gitbook 我的博客部署

目录

• 1、安装 nodejs 和 npm
• 2、安装 gitbook
• 3、使用 gitbook 创做
• 4、在浏览器浏览咱们写的文章
• 5、阿里云服务器部署 GitBook

1、安装 nodejs 和 npm

Ubuntu安装方法以下，Windows安装方法详见《node.js教程》

• 打开终端，输入如下命令便可安装；
  sudo apt-get install nodejs
sudo apt-get install npm
  
  
• 升级 nodejs 和 npm 版本；
  sudo npm install n -g
sudo n stable
npm i -g npm
  
  
  
• 配置 npm 镜像源为淘宝源；
  npm config set registry http://registry.npm.taobao.org/
  
  
  
  

2、安装 gitbook

• 先安装 gitbook-cli，执行如下命令
  sudo npm install -g gitbook-cli
  

• 查看版本并安装 gitbook
  输入命令gitbook -V会自动帮咱们安装 gitbook，须要注意这一步会很慢，执行 Installing GitBook 3.2.3 大概须要20分钟左右，请耐心等待；
  
  
  

• 验证是否安装成功
  安装成功后，输入gitbook -V再次查看版本看是否安装成功，如图所示，显示版本号即表示安装成功；
  
  
  

• GitBook 插件
  当遇到「左侧的目录折叠」这种需求的时候，就用到 GitBook 插件了。
  官方获取插件地址： https://plugins.gitbook.com/
  
  

• 安装 GitBook 插件方法以下：
  安装插件只须要在书籍目录下增长 book.json 文件，例如增长 折叠目录 的插件，须要在 book.json 内增长下面代码:
  

  {
      "plugins": ["expandable-chapters-small"],
      "pluginsConfig": {
          "expandable-chapters-small":{}
      }
  }

  而后终端执行命令 gitbook install 来安装插件便可。
  
  
  

3、使用 gitbook 创做

• 新建博客目录

  cd ~
  mkdir gitbook

• 初始化目录

  cd gitbook
  gitbook init

• 查看博客目录

  ls -la
  
  —— README.md		# 书籍的介绍写在这个文件里
  —— SUMMARY.md		# 书籍的目录结构在这里配置

• 编译博客项目

  gitbook init	# 生成摘要中定义的markdown文件
  gitbook build	# 生成_book文件夹及html网页

4、在浏览器浏览咱们写的文章

• 在本地启动 gitbook 服务

  gitbook serve

• 在浏览器中浏览咱们的博客
  用浏览器登陆 http://localhost:4000/，便可查看咱们创做的内容；
  
  
  

5、阿里云服务器部署 GitBook

• 想在阿里云服务器上面部署GitBook，一样须要根据以上步骤在阿里云服务器安装GitBook。

• 上面说了gitbook build以后，目录下面会生成一个_book这里就是生成的静态网页资源，里面有个index.html，这个是网站的入口。

• 在 /etc/nginx/sites-enabled 的目录下面，新建一个.conf格式的文件 api_gitbook.conf。文件里面的代码以下：

  server {
        listen 4000;
        server_name localhost;
        location / {
             root /home/apibook/_book;
             index index.html;
             try_files $uri $uri/ =404;
        }
  }

• 而后重启ngixn
  service nginx reload
  

• 这样咱们就能够远程访问使用 GitBook 创做的文章了，注意你的服务器的安全组须要开放了4000端口。
  而后打开浏览器访问：http://阿里云服务器IP地址:4000便可。