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便可。