Github 結合 Hexo 搭建輕量博客
本次搭建,是在Windows系統上進行
開始
Hexo 是一個快速、簡潔且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在幾秒內,即可利用靚麗的主題生成靜態網頁。
也有很多此類的文章了,不過還是要記錄一下,分享給大家,我自己也做個復習。我也是不久前才弄好 ^_^
工具準備
- 1.安裝Node.js
- 2.安裝Git
安裝過程就不說了,估計沒有不會的。
- 3.注冊Github帳號
點擊進入 Github ,注冊帳號(用戶名關系到博客以后的 域名前綴)。
安裝Hexo
安裝完上述程序,就可以進行Hexo的安裝了。
打開命令行,輸入安裝命令:
npm install hexo-cli -g
等待完成,安裝 Hexo 后,依次執行下列命令,Hexo將會在指定文件夾中新建所需要的文件。
folder(不用打[])是你新建的文件夾名稱,用于存放博客的所有文件。
默認安裝在你打開的命令行默認所在的目錄,可以切換至其他目錄進行安裝。
hexo init [folder] cd [folder] npm install
比如我把目錄切換到D盤進行安裝。
列出一個目錄,看見下面這句話,就說明安裝成功了。
可以打開電腦看一下目錄結構。
執行下面命令,生成網站(public文件夾):
hexo g
結果如下:
執行下面命令,運行服務,就可以在瀏覽器中訪問了,地址為: http://localhost:4000 :
hexo s
如果遇到 hexo s 無效或者錯誤,可能是因為沒有安裝hexo server,執行下面命令,然后再試:
npm install hexo-server --save
瀏覽器查看(這就是安裝好的模樣,這是默認主題,可以添加新的主題):
但是現在我們只能在我們本地的電腦上面瀏覽,別人無法看見,我們還需要將它部署到Github上面。這樣就可以讓別人訪問了。
hexo 基本命令,先了解,后面會用到。
hexo g #完整命令為hexo generate,用于生成靜態文件 hexo s #完整命令為hexo server,用于啟動服務器,主要用來本地預覽 hexo d #完整命令為hexo deploy,用于將本地文件發布到github上 hexo n #完整命令為hexo new,用于新建一篇文章 hexo clean #清除生成的文件
部署
新建倉庫(New repository)
登錄到你的Github帳號,在右上角+號點擊新建。
填寫信息。格式為:你的用戶名.github.io。然后創建。
配置網站信息
打開你的文件夾,找到 _config.yml 文件,打開它。最開始和最后。
默認可能會沒有repo和branch選項,我們要手動寫上。
repo: 地址為下圖中的地址。替換成你的就可以。
Github 默認分支是 master。
暫時修改這些信息就可以。
# Site title: Hexo #網站標題 subtitle: #副標題 description: #描述 author: zgm #作者,你的名字 language: zh-Hans #設置語言 zh-Hans為中文 timezone: #時區 默認使用電腦的時區 # Deployment ## Docs: https://hexo.io/docs/deployment.html deploy: type: git repo: https://github.com/你的用戶名/你的用戶名.github.io.git branch: master
設置Git
在Git Bash輸入以下指令(任意位置點擊鼠標右鍵),檢查是否已經存在了SSH keys。
ls -al ~/.ssh
如果不存在就沒有關系,如果存在的話,可以直接刪除.ssh文件夾里面所有文件。輸入以下指令:
郵箱就是你注冊Github時候的郵箱
執行命令,生成密鑰。
ssh-keygen -t rsa -C "xxx@xxx.com"
然后回車,出現提示就直接回車,第一次會問你是否繼續,回車,第二次問你是否設置一個密碼,寫不寫都可以,第三次是重復輸入密碼,沒有的話就直接回車。
之后找到用戶目錄下.ssh文件夾,打開id_rsa.pub文件,復制里面的內容。
打開github網頁找到右上角點擊你的頭像,找到Setting,進去點SSH keys,新建一個SSH。
在Git Bash輸入下面的命令:
ssh -T git@github.com
登陸成功。
前面我們說過,hexo d 是部署到Github的命令,但是現在我們執行的話,會提示你
ERROR Deployer not found:git
所以我們還要安裝hexo-deployer-git:
npm install hexo-deployer-git --save
安裝完成后,在Git Bash配置一下用戶名和密碼(分別是你的郵箱和用戶名):
git config --global user.email "xxx@xxx.com" git config --global user.name "你的用戶名"
執行部署命令:
hexo d
通常情況下是先生成網站,然后部署。可以將兩個步驟放到一起:
hexo d -g
現在你就可以打開網站看到效果了。
發表
新建文章
通過以下命令新建文章:
hexo new "文章名字"
然后用編輯器打開你文件夾下面的 source\_posts 里面的 文章名字.md 文件。
title: 文章名字 #標題 date: 2016-12-09 12:04:29 #發表日期 categories: blog #文章文類 tags: [文章,blog] #文章標簽 --- #這里是正文,用markdown寫,你可以選擇寫一段顯示在首頁的簡介后 #加上<!--more-->,在<!--more-->之前的內容會顯示在首頁, #之后的內容會被隱藏,點擊Read more才能看到。
更新文章
在命令行執行:
hexo d -g
這樣就可以把你的新文章傳上去啦。
參考
來自:http://www.jianshu.com/p/840a353f8df5