【超簡單】Windows下使用GitHub + Hexo搭建技術博客

0x00 前言

很多朋友都想試著搭建一個屬於自己的技術博客,我在這裡為大家介紹一種方法。Hexo是一個快速簡潔的博客框架,把代碼提交到Github上並且開啟Github pages就可以直接訪問了。網上的教程也有很多,不過新手在搭建的過程中會遇到很多坑,本文為大家規避了一些諸如「nmp速度慢」、「命令錯誤」等問題,希望可以幫助到大家!

0x01 安裝node.js和git

· nodejs官網:nodejs.org/zh-cn/

· git官網:git-scm.com/

注意:最好都裝在系統盤,默認為C盤,安裝不停點下一步

查看node和npm版本號:

查看git版本:

0x02 創建一個Github帳號(有的話可以跳過)

創建代碼庫:

登陸之後,點擊頁面右上角的加號,選擇New repository

注意,一定要設置代碼庫名稱為yourname.github.io,否則後面開啟gh-pages後無法訪問yourname.github.io

開啟gh-pages功能:

點擊界面右側的Settings,你將會打開這個庫的setting頁面,向下拖動,直到看見GitHub Pages。

設置完成後大概需要等15分鐘才可以訪問yourname.github.io

0x03 本地配置hexo

安裝hexo(失效用淘寶源):

在自己認為合適的地方創建一個文件夾,然後在文件夾空白處按住Shift+滑鼠右鍵,然後點擊在此處打開命令行窗口。(同樣要記住啦,下文中會使用在當前目錄打開命令行來代指上述的操作)

npm install hexo-cli -g

安裝cnpm,用來代替npm:

npm install -g cnpm --registry=https://registry.npm.taobao.org

git bash中使用淘寶源安裝hexo:

npm install -g hexo-cli --registry=https://registry.npm.taobao.org

npm install hexo --save

查看hexo版本信息:

hexo -v

初始化hexo

hexo init

出現的錯誤不用管,接著輸入下面命令,自動安裝需要的組件

cnpm install

0x04 開始體驗hexo

hexo g

hexo s

0x05 安裝配置hexo主題

清空緩存

hexo clean

安裝主題

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

漫長的等待,終於裝好了

更新主題:

先執行hexo clean,然後重新hexo g,並且hexo d,很快就能看到新主題的效果了~

0x06 配置Deployment

git bash配置身份信息

git config --global user.name "yourname"

git config --global user.email "youremail"

同樣在_config.yml文件中,找到Deployment,然後按照如下修改:

deploy:type: gitrepo: git@github.com:yourname/yourname.github.io.gitbranch: master

注意:上面的type: repo: branch: 後面都有空格,千萬不要寫掉了!!

安裝所需插件

npm install hexo-deployer-git --save

輸入hexo d,出現下面對話框,輸入yes回車,出現以下報錯,說明沒有配置ssh

0x07 配置ssh

git bash中輸入,生成本機SSH key

ssh-keygen -t rsa -C "yourname@foxmail.com"

連續回車3次

在C:Users用戶名.ssh下找到 id_rsa.pub,用sublime打開,複製粘貼到Github ssh設置新建的SSH keys中,Title任意寫

創建好了是這樣的

hexo d出現如下錯誤,因為github項目是空的

0x08 推送本地目錄到github

本地創建一個文件夾為yourname.github.io,右鍵git bash,鍵入以下命令

echo "# cooper1x.github.io" >> README.md

git init

git add README.md

git commit -m "first commit"

git remote add origin https://github.com/cooper1x/cooper1x.github.io.git

git push -u origin master

最後一條命令敲完出現如下對話框,輸入帳號密碼登陸,帳號最好輸入郵箱地址

然後回到hexo目錄,hexo d部署,然後就可以通過cooper1x.github.io訪問了。

0x09 新建文章

完成上面部署工作後,看到這裡很多朋友還是不知道怎麼新建文章。其實很簡單,首先在hexo目錄下右鍵進入git,輸入hexo n回車,這樣會在根目錄下的source/_post目錄下創建一個md文件,然後右鍵用markdown編輯器打開(可以使用Sublime Text)。寫好了之後,回到hexo根目錄使用hexo g,這樣會生成博客文件到 public相關目錄中,最後輸入hexo d回車,等待數秒後就可以發布到github了。

參考:

xuanwo.org/2015/03/26/h

hexo.io/zh-cn/docs/migr


推薦閱讀:

github 怎麼搭建博客?
如何看待「B站建開源工作組 多APP使用其開源項目?」?
有哪些github pages開源項目可以用來建博客?
Jekyll 與 WordPress 的區別是什麼?
Github Pages/GitCafe pages 可以搭建博客,並且可以綁定域名,是基於什麼原理的呢?

TAG:Hexo | GithubPages | 博客 |