1.下載 msysgit ,并安裝
https://git-for-windows.github.io/
2.安裝Node.js
在 Windows 環境下安裝 Node.js 非常簡單,僅須下載安裝文件并執行即可完成安裝。
下載地址:https://nodejs.org/download
因為我用的Windows的64位,所以下載地址在這:
https://nodejs.org/dist/v0.12.7/x64/node-v0.12.7-x64.msi
安裝好后,打開cmd,輸入下面命令,看下是否正常
node -v
npm -v
正常的話,效果如下,不行就百度下原因吧。 3.安裝hexo
利用 npm 命令即可安裝。(先在任意位置點擊鼠標右鍵,選擇Git bash)
npm install -g hexo
在打印的日志里面,請記下安裝的hexo的位置,然后再系統的環境變量PATH里面加多這個庫的lib地址;
要不然你會遇到hexo command not found .
4.創建hexo文件夾
安裝完成后,在你喜愛的文件夾下(如H:\hexo),執行以下指令(在H:\hexo內點擊鼠標右鍵,選擇Git bash),Hexo 即會自動在目標文件夾建立網站所需要的所有文件。
hexo init
安裝依賴包
npm install
本地查看
現在我們已經搭建起本地的hexo博客了,執行以下命令(在H:\hexo),然后到瀏覽器輸入ocalhost:4000看看。
hexo generatehexo server
好了,至此,本地博客已經搭建起來了,只是本地哦,別人看不到的。下面,我們要部署到Github。
Github賬號
已有賬號可以跳過,沒有的,請自行注冊,很簡單,這里就不介紹了。
創建repository
在自己Github主頁右下角,創建一個 New repository。
比如我的Github賬號是
sanjay
,那么我應該創建的repository名字應該是sanjay.github.io
這個是github官方規定的。用戶名和項目名稱一直
You must use the
username.github.io
naming scheme.
Content from themaster
branch will be used to build and publish your GitHub Pages site.
You can only use your own account name for a User or Organization Page repository. A repository likejoe/bob.github.io
will not build a User Pages site.
When User Pages are built, they are available athttp(s)://<username>.github.io.
部署
編輯_config.yml(在H:\hexo下
)。
你在部署時,要把下面的sanjay都換成你的賬號名。
#這個在最下面的一行
deploy: type: git #最新版3.X把這個github縮寫成git了,這句注視可以不復制的.
repository: https://github.com/Sanjay/Sanjay.github.io.git
branch: master
執行下列指令即可完成部署。
hexo g #新版本支持的縮寫,可以看最后面的tips了解情況
hexo d
注意:有些新用戶需要設置 ssh,否則上述命令會失敗。ssh 的介紹和設置方法請看官方教程,不用擔心,很簡單。連接: https://help.github.com/articles/generating-ssh-keys/
記住:
每次修改本地文件后,需要hexo generate才能保存。每次使用命令時,都要在H:\hexo目錄下。 Okay,我們的博客已經完全搭建起來了,在瀏覽器訪問Sanjay.github.io就能看到你的成就了!
bugs
有網友反應右鍵菜單中沒有git bash選項,可以進入開始菜單找到git bash,然后通過cd進入相應目錄執行命令。
在github部署完成之后,馬上訪問可能出現404錯誤,這是正常的,(最多)等待十分鐘左右就可以訪問了。如果還不行,那很可能是 github 發送給你的驗證郵件你沒有打開看,據多方反映,驗證后就沒問題了。
如果在hexo d之后出現fatal: ‘username.github.io’ does not appear to be a git repository,一是檢查 repo 的名字是否合乎規范、是否含有大寫字母、config.yml 中的 deploy 配置是否正確,二是把 git bash 關掉,重新打開再執行命令。
有的同學可能不是 IT 界的,或者對shell 命令不太了解。在要求輸入密碼時,你輸入之后密碼是不顯示的,這是為了安全,并非是你沒輸上。 出現亂碼的,不要使用 windows 中的「記事本」打開并編輯文件,推薦使用 sublime text,很簡單。如果已經在「記事本」中編輯過,需要使用 sublime text 轉碼為「utf8」。
安裝 hexo 時卡在那兒不動,很可能是網絡不給力,能全局 break wall 就好了。 遇到什么其他的問題,不妨刪除.deploy 和db.json 再重新生成試一試。
tips
hexo現在支持更加簡單的命令格式了,
比如:
hexo g == hexo generate
hexo d == hexo deploy
hexo s == hexo server
hexo n == hexo new