HEXO+Github,搭建屬於本身的博客

hexo是一款基於Node.js的靜態博客框架, hexo github連接 ,這篇教程是針對與Mac的，參考連接，因爲原文講到的hexo是之前的老版本，因此如今的版本配置的時候會有些改動。

以前是想着寫博客，一方面是給本身作筆記，能夠提高本身的寫做、總結能力，一個技術點咱們會使用，並不難，可是要作到讓讓別人也能聽懂咱們講得，仍是須要必定的技巧和經驗的。不少相似於CSDN、博客園也均可以寫文章，可是頁面的樣式我，不是太喜歡，簡書還算好點得。最近看到一些大神們的博客,貌似都是用hexo寫得,我也依葫蘆畫瓢的搭建了一個。不羅嗦了，直接上搭建步驟。

配置環境

安裝Node（必須）

做用：用來生成靜態頁面的

到Node.js官網下載相應平臺的最新版本，一路安裝便可。

安裝Git（必須）

做用：把本地的hexo內容提交到github上去.

安裝Xcode就自帶有Git，我就很少說了。

申請GitHub（必須）

做用：是用來作博客的遠程創庫、域名、服務器之類的，怎麼與本地hexo創建鏈接等下講。

github帳號我也再也不囉嗦了,沒有的話直接申請就好了，跟通常的註冊帳號差很少，SSH Keys，看你本身了，能夠不配製，不配置的話之後每次對本身的博客有改動提交的時候就要手動輸入帳號密碼，配置了就不須要了，怎麼配置我就很少說了，網上有不少教程。

正式安裝Hexo

Node和Git都安裝好後,首先建立一個文件夾,如blog,用戶存放hexo的配置文件,而後進入blog裏安裝Hexo。

執行以下命令安裝Hexo：

sudo npm install -g hexo

初始化而後，執行init命令初始化hexo,命令：

hexo init

好啦，至此，所有安裝工做已經完成！blog就是你的博客根目錄，全部的操做都在裏面進行。

生成靜態頁面

hexo generate（hexo g也能夠）

本地啓動

啓動本地服務，進行文章預覽調試，命令：

hexo server

瀏覽器輸入http://localhost:4000

我不知道大家能不能，反正我不能，由於我還有環境沒配置好

配置Github

創建Repository

創建與你用戶名對應的倉庫，倉庫名必須爲【your_user_name.github.io】，固定寫法

而後創建關聯，個人blog在本地/Users/leopard/blog，blog是我以前建的東西也全在這裏面，有：

    _config.yml    node_modules    public      source

    db.json        package.json    scaffolds  themes

如今咱們須要_config.yml文件，來創建關聯，命令：

vim _config.yml

翻到最下面，改爲我這樣子的

deploy:

     type: git

     repo: https://github.com/leopardpan/leopardpan.github.io.git

     branch: master

而後執行命令：

npm install hexo-deployer-git --save

網上會有不少說法，有的type是github, 還有repository最後面的後綴也不同，是github.com.git，我也踩了不少坑，我如今的版本是hexo: 3.1.1，執行命令hexo -vsersion就出來了,貌似3.0後所有改爲我上面這種格式了。

忘了說了，我沒用SSH Keys若是你用了SSH Keys的話直接在github裏複製SSH的就好了，總共就兩種協議，相信你懂的。

而後，執行配置命令：

hexo deploy

而後再瀏覽器中輸入http://leopardpan.github.io/就好了，個人github的帳戶叫leopardpan,把這個改爲你github的帳戶名就好了

部署步驟

每次部署的步驟，可按如下三步來進行。

    hexo clean

    hexo generate

    hexo deploy

一些經常使用命令：

hexo new"postName" #新建文章

hexo new page"pageName" #新建頁面

hexo generate #生成靜態頁面至public目錄

hexo server #開啓預覽訪問端口（默認端口4000，'ctrl + c'關閉server）

hexo deploy #將.deploy目錄部署到GitHub

hexo help # 查看幫助

hexo version #查看Hexo的版本

報錯總結

ERROR Deployer not found: git 或者 ERROR Deployer not found: github

解決方法： npm install hexo-deployer-git --save

如發生報錯： ERROR Process failed: layout/.DS_Store , 那麼進入主題裏面layout和_partial目錄下，使用刪除命令：

rm-rf.DS_Store

ERROR Plugin load failed: hexo-server

緣由：

Besides,utilities are separated into a standalone module.hexo.util is not reachable anymore.

解決方法，執行命令：

sudo npm install hexo-server

執行命令hexo server，提示：Usage: hexo ....

緣由：

我認爲是沒有生成本地服務

解決方法，執行命令：

npm install hexo-server --save

提示：hexo-server@0.1.2 node_modules/hexo-server

....

表示成功了參考

這個時候再執行：

hexo-server

獲得:

INFOHexois running at http://0.0.0.0:4000/.PressCtrl+C to stop.

這個時候再點擊http://0.0.0.0:4000，正常狀況下應該是最原始的畫面，可是我看到的是：

白板和Cannot GET / 幾個字

緣由：

因爲2.6之後就更新了，咱們須要手動配置些東西，咱們須要輸入下面三行命令：

npm install hexo-renderer-ejs --save

npm install hexo-renderer-stylus --save

npm install hexo-renderer-marked --save

這個時候再從新生成靜態文件，命令：

hexo generate（或hexo g）

啓動本地服務器：

hexo server（或hexo s）

再，點擊網址http://0.0.0.0:4000OK終於能夠看到屬於你本身的blog啦，😄，雖然很簡陋，但好歹有了一個屬於本身的小窩了。參考連接，本地已經簡單的設置好了，可是如今域名和服務器都是基於本身的電腦，接下來須要跟github進行關聯。

主題推薦

這裏有大量的主題列表使用方法裏面

都有詳細的介紹，我就很少說了。

我這裏有幾款我的認爲不錯的主題，免去大家，一個一個的選了，歡迎吐槽個人審美，😄

Cover- A chic theme with facebook-like cover photo

Oishi- A white theme based on Landscape plus and Writing.

Sidebar- Another theme based on Light with a simple sidebar

TKL- A responsive design theme for Hexo. 一個設計優雅的響應式主題

Tinnypp- A clean, simple theme based on Tinny

Writing- A small and simple hexo theme based on Light

Yilia- Responsive and simple style 優雅簡潔響應式主題，我用得就是這個。

Pacman voidy- A theme with dynamic tagcloud and dynamic snow

一些基本路徑

文章在source/_posts, 文章支持Markdown語法，可使用一些MarkDown渲染工具。若是想修改頭像能夠直接在主題的_config.yml文件裏面修改，友情連接，之類的都在這裏。開始打理你的博客吧，有什麼問題或者建議，均可以提出來，我會繼續完善的。

修改頭像

我當前的路徑/Users/leopard/blog/themes/yilia，ls 你能夠看到

Gruntfile.js    _config.yml package.json

README.md  layout      source

vim _config.yml 進去，找到 #你的頭像url avatar: 後接一個URL就好了，頭像就修改爲功了

修改主題和做者名字

我當前的路徑/Users/leopard/blog，ls 你能夠看到

_config.yml  node_modules    public      source      themes

db.json        package.json     scaffolds   ssh-keygen

vim _config.yml 進去，找到 author: 潘柏信，修改爲你本身的名字就好了

修改主題，而後繼續往下找到

# Extensions

## Plugins: http://hexo.io/plugins/

## Themes: http://hexo.io/themes/

theme:yilia

改爲theme: yilia，theme:後面接你本身的主題名字就好了,而後分別執行

部署 hexo g

提交 hexo d

你的主題，和名字就修改爲功了

Markdown語法參考連接

連接一

原文地址：https://www.jianshu.com/p/465830080ea9