標籤：

手把手教從零開始在GitHub上使用Hexo搭建博客教程(一)-附GitHub註冊及配置

01-26

前言

有朋友問了我關於博客系統搭建相關的問題，由於是做開發相關的工作，我給他推薦的是使用github的gh-pages服務搭建個人博客。

推薦理由：

  1. 免費：github提供gh-pages服務是免費的，有300MB空間；
  2. 開源：由於github開源的原因，有很多人參與其中，自然技術支持很好。
  3. 便捷：博客完全託管在github上，基本上不需要花時間去管理，博客使用Markdown語法，上手很容易。

需要了解的內容（能掌握更好）：

  • html+css+javascript
  • git基本語法
  • markdown語法
  • nodejs

目前，在github上搭建博客系統使用最多就是Hexo和Jekyll。

Hexo是基於Nodejs開發的，Jekyll是基於Ruby開發的。

通過兩個系統使用的比較，個人習慣喜歡Hexo，所以本文介紹的是Hexo搭建博客，如果你對Jekyll也有興趣，可自行學習。

安裝Git客戶端

已安裝過的用戶略過

  1. 下載Git客戶端：下載地址
  2. 安裝Git客戶端：Windows用戶直接Next就可以了。Mac和Linxu系統的用戶可通過命令方式安裝，這裡不詳細介紹了。

註冊GitHub

老手和已註冊過的用戶略過

  1. 打開GitHub官網：How people build software · GitHub
  2. 填寫註冊信息進行註冊操作：沒有登錄的用戶打開網站首頁就會顯示註冊的操作（如圖所示），或者是點擊Sign up按鈕進入註冊詳情頁。

  3. 填寫好註冊信息，點擊Sign up for GitHub(註冊)按鈕後，接下來是選擇協議部分。根據自己的情況選擇相關的協議，一般人選的都是免費的那一項。

創建倉庫

  1. 登錄github賬號：在github首頁點擊Sign in按鈕進入登錄頁面。填寫用戶名或郵箱和密碼，點擊Sign in按鈕登錄。

  2. 點擊創建倉庫：點擊在登錄的用戶圖像左邊的+號和下三角符號按鈕。

  3. 填寫創建倉庫信息：

    倉庫名稱必須是用戶名.github.io（別問我為什麼，人家就是這樣規定的），比如我的用戶名是SeayXu，就是SeayXu.github.io。

  4. 填寫好相關信息，點擊Create repository(創建倉庫)按鈕。

配置SSH

老手和已配置過的用戶略過

  1. 打開Git Bash終端：在桌面右鍵，會出現"Git Bash here"的選項，點擊即可。

  2. 設置user name和email：

    $ git config --global user.name "你的GitHub用戶名"$ git config --global user.email "你的GitHub註冊郵箱"

  3. 生成ssh密鑰:輸入下面命令

    $ ssh-keygen -t rsa -C "你的GitHub註冊郵箱"

    一般情況下是不需要密碼的，所以，接下來直接回車就好。

    此時，在用戶文件夾下就會有一個新的文件夾.ssh，裡面有剛剛創建的ssh密鑰文件id_rsa和id_rsa.pub。

    註：id_rsa文件是私鑰，要妥善保管，id_rsa.pub是公鑰文件。
  4. 添加公鑰到github：

    點擊用戶頭像，然後點擊顯示的Settings(設置)選項；

    在用戶設置欄，點擊SSH and GPG keys選項，然後點擊New SSH key(新建SSH)按鈕；

    將id_rsa.pub中的內容複製到Key文本框中，然後點擊Add SSH key(添加SSH)按鈕；

  5. 測試SSH：

    $ ssh -T git@github.com

    接下來會出來下面的確認信息：

    The authenticity of host "github.com (207.97.227.239)" can"t be established. RSA key fingerprint is 17:24:ac:a5:76:28:24:36:62:1b:36:4d:eb:df:a6:45. Are you sure you want to continue connecting (yes/no)?

    輸入yes後回車。

    然後顯示如下信息則OK(其中的SeayXu是用戶名)。

    Hi SeayXu! You"ve successfully authenticated, but GitHub does not provide shell access.

以上是準備工作。

創建本地倉庫

打開Git Bash終端，等待執行命令。

  1. 新建倉庫文件夾：這裡就取名為blog。

    $ mkdir blog

  2. 進入到blog文件夾：

    $ cd blog # 切換到blog目錄

初探Hexo

如果沒有安裝Nodejs，請先安裝Nodejs，Nodejs官網；

以下操作是在blog文件夾中。

  1. 安裝Hexo

    $ npm install hexo-cli -g

    hexo全局安裝一次就夠了，後面可以直接使用hexo相關的操作。

  2. 初始化Hexo

    $ hexo init

  3. 安裝依賴

    $ npm install

  4. 啟動Hexo

    $ hexo server

    啟動之後，打開瀏覽器，在地址欄輸入：localhost:4000，你會看到Hexo的示例頁面。

註：此時可以初始化git本地倉庫了，或者是等本地博客搭建好之後也可以。

再探Hexo

  1. 新建文章：

    $ hexo new <title>

    此時在source_posts文件夾中便會多出一個文檔"title.md".

    如果要刪除，直接在此文件夾下刪除對應的文件即可。

  2. 生成靜態頁面

    $ hexo generate

    生成的靜態內容在public文件夾內。

  3. 清除生成內容

    $ hexo clean

    執行此操作會刪除public文件夾中的內容。

  4. 部署Hexo

    $ hexo deploy

    該操作會將hexo生成的靜態內容部署到配置的倉庫中，請看下面介紹。

部署Hexo

  1. 編輯配置文件，關聯遠程倉庫：

    在編輯器中打開Hexo配置文件**_config.yml**，找到下面內容：

    # Deployment## Docs: https://hexo.io/docs/deployment.htmldeploy: type:

    添加github倉庫信息：

    # Deployment## Docs: https://hexo.io/docs/deployment.htmldeploy: type: git repo: git@github.com:SeayXu/seayxu.github.io.git #github倉庫地址 branch: master # github分支

    注意：type、repo、branch的前面有兩個空格，後面的:後面有一個空格

  2. 安裝git插件

    npm install hexo-deployer-git --save

    如果沒有安裝git插件，會有錯誤提示，安裝後重新部署就可以了。

  3. 部署

    $ hexo deploy

    如果沒有意外，部署就成功了，可以打開 手把手教從零開始在GitHub上使用Hexo搭建博客教程(一)-附GitHub註冊及配置<用戶名>.github.io 查看。

hexo命令縮寫

  • hexo g：hexo generate
  • hexo c：hexo clean
  • hexo s：hexo server
  • hexo d：hexo deploy

hexo命令組合

hexo clean && hexo g -s，就是清除、生成、啟動

hexo clean && hexo g -d，就是清除、生成、部署

本文簡單介紹Hexo的部署，接下來的文章會介紹Hexo的相關配置。

【Hexo博客交流群】

群號：582271078

推薦閱讀：

※脫翁筆記(3)：我是一個Scanner控│脫苦海
※博客十年
※脫翁筆記(4)：香港與中歐班列已然擦身而過│脫苦海
※搭建個人博客，你需要知道這些

TAG:Hexo | 博客 | GithubPages |