docusaurus 是facebook 開源的一款文件腳手架工具，可以快速的進行文件生成，基於markdown
同時已經內建了gh-pages 釋出的命令，對於ci 工具，我們只需要簡單的配置就可以了

環境準備

• 建立github空專案
  很簡單直接滑鼠點選就可以了
• 建立docusaurus demo站點

npx docusaurus-init

• 修改名稱
  docusaurus 有自己的專案佈局要求,修改之後的如下
  
• 配置修改
  因為使用gh-pages 存在一個資源載入路徑的問題，docusaurus 很不錯已經幫助我們提供了配置了，只需要修改就可以了
  如下：

./website/siteConfig.js

新增circleci 整合

• 新增ci整合
  這個可以開啟circleci 網站進行授權，或者通過github 市場新增
• 配置circleci 構建檔案
  circleci 有自己的構建路徑說明

  mkdir .circleci
  touch config.yml
  內容如下：
  version: 2
  jobs:
  build:
  docker:
    - image: circleci/node:8.11.4
  filters:
  
  ## 分支過濾，很重要，不然gh-pages 會報錯，
  
    branches:
      only:
      - master
  steps:
    - checkout
    - run:
        name: Deploying to GitHub Pages
        command: |
          git config --global user.email "
   
  [email protected]"  ## git 的一些配置
          git config --global user.name "rongfengliang"
          echo "machine github.com login rongfengliang password $GITHUB_TOKEN" > ~/.netrc  ## 基於github token 的登入
          cd website && yarn install && GIT_USER=rongfengliang yarn run publish-gh-pages ## npm script 執行
   
  

  說明：
  GIT_USER 使用者比較重要，同時注意許可權的設定，需要具有write 的許可權，GITHUB_TOKEN 是一個環境變數，可以在circleci 構建
  環境變數配置介面新增
  

構建&&檢視效果

• 新增circleci 構建
  
• 構建
  修改程式碼，提交，就會觸發構建
• 效果
  
• 構建好的gh-pages
  
  
• 說明
  如果提示gh-pages 不存在，可以手工建立，並刪除程式碼，提交就可以了

參考資料