安裝 Hexo

Hexo

需要使用到基本 git 上傳指令以及修改 Yaml 格式環境設定

文章撰寫使用 Markdown 格式

http://markdown.tw/

Hexo 安裝

• 必需在 Node.js 環境下

# hexo CLI - Hexo 指令工具
npm install -g hexo-cli

# hexo 自動部署工具
# 出現 ERROR Deployer not found: git 的錯誤時就需要安裝
npm install hexo-deployer-git --save

• 建立一個 Hexo 雛形

hexo init
npm install

• 開啟本地預覽
  • 打開 http://localhost:4000 就可看到建立好的網頁
  • 下方有詳細說明

hexo server

到這裡為止就完成一個可觀看的簡單 Hexo 頁面

在部署 Hexo 到 GitHub 上前，要先上傳 Hexo 原始碼到 branch: master 分支

之後才部署 Hexo 編譯後的頁面到 branch: gh-pages 分支

• 部署至 GitHub branch: gh-pages 分支

  • 上傳前先修改 _config.yml 的 deploy

deploy:
    type: git
    repo: git@github.com: UserName / repository .git 
    branch: gh-pages

hexo g  # 生成 public 靜態檔案
hexo d  # 部署至 Github Pages

• 部署兩個站點

# 絕對路徑改成相對路徑，修改 _config.yml
relative_link: true

• 更新內容上傳

hexo g
hexo d

# 或是只執行下面一行也可以
hexo d -g

上傳出錯時可能的問題

• 靜態檔案 public 生成出錯 - 只要清除先前建立的靜態檔案，再重新生成一次後上傳

hexo cl  # 清除之前建立的靜態檔案，也可以輸入 hexo clean
hexo g  # 建立靜態檔案 [在 /public 資料夾內]，也可以輸入 hexo generate
hexo d  # 部署到 Github Pages，也可以輸入 hexo deploy

• 其他指令

建立新的空文章格式

hexo new "My_New_Post"

git 上傳 Hexo 原始碼

• git 基本只會用到的指令

# 本地端
git init
git add.
git commit -m "git init"

# 上傳到 Github
# push branch: master → 原始碼
# git remote add origin git@github.com:Wcc723/hexo-demo-1114.git // 儲存庫路徑
git remote add origin 儲存庫路徑 # 這裡要修改上傳的儲存庫路徑
# git push -u origin master  // branch:master
git push -u origin master

# 出錯問題
# 推到 Git 出錯 - 有可能是先前資料卡住，先刪記錄後再推一次
git remote rm origin
# 再不能上傳, 有可能是金鑰錯誤
# https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/

開啟本地預覽 server

hexo server

• 預設 http://localhost:4000

• 參數

  • -p 、 -port 變更設定 PORT

  hexo server -p 1599
  # 變更後開啟 server => http://localhost:1599

  • -s 、 -static 只觀看 public 內已建立的靜態檔案
  • -l 、 -log 開啟記錄，預設會覆寫記錄
  • -g 、 -generate 在啟動 server 前先建立靜態檔案
  • -i 自訂 IP ，預設 0.0.0.0 。設定後就不能用 127.0.0.1 、 localhost

  hexo server -i 192.168.1.1