教你免費搭建個人博客，Hexo&Github

01-25

更好的閱讀體驗，請看我的博客教你免費搭建個人博客，Hexo&Github

說在前面：

為什麼自己搭建博客，知乎不行嗎？

可以看看劉未鵬 | Mind Hacks，前些天發布了某篇文章應該是被人舉報了，結果知乎就刪了。有自己的博客自由，自在。更多請看為什麼要自建博客？ - 獨立博客 - 知乎

我用了多久才完成博客的搭建？

不瞞您說，我花了有3天時間。對著別人的「5分鐘搭建免費個人博客」花了3天才完成，中間遇到了無數困難。查看很多資料，所以當你遇到困難，別放棄，仔細看文檔或資料。

為了發布這篇教程，重新註冊了Github，崔斯特的博客這個是我自己的博客，崔斯特測試所用博客這個是我一邊寫這篇教程一邊搭建的。所以如果你也和我一樣，喜歡自由，喜歡搗騰，那就來吧。
系統：windows 7 64位，編輯器：sublime text3，控制台：cmder
搭建博客使用hexo+Github

什麼是 Hexo？文檔

Hexo 是一個快速、簡潔且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在幾秒內，即可利用靚麗的主題生成靜態網頁。

一、配置Github

首先註冊、登錄 https://github.com/

記住自己的Username（很重要）

然後右上角選擇 Create a new repository https://github.com/new

Repository name 填自己的名字 http://yourname.github.io(yourname與你的註冊用戶名一致,這個就是你博客的域名了)

例如，我的域名是http://github.com/zhihuya，就填入http://zhihuya.github.io。成功後出現下面的畫面

二、環境安裝（node、git）

安裝 Node.js Node.js

安裝 Git waylau/git-for-win: Git for Windows. 國內直接從官網下載比較困難，需要翻牆。這裡提供一個國內的下載站，方便網友下載

Git教程這裡有廖雪峰老師的教程，非常好。

安裝完成後，在開始菜單里找到「Git」->「Git Bash」，名稱和郵箱是Github上的

安裝 Hexo。所有必備的應用程序安裝完成後，即可使用 npm 安裝 Hexo。

$ npm install -g hexo-cli

（使用的cmder，超級好用~~。等待時間可能有點長）

好了到這一步我們環境全部安裝好了。

三、設置

在電腦F盤（看自己）目錄下新建文件夾 test，進入test，按住Shift鍵點擊滑鼠右鍵

因為我有安裝Cmder，沒有安裝的點擊「在此處打開命令窗口」，輸入

hexo init blog

稍微等待下，速度有點慢。成功提示

INFO Start blogging with Hexo!

# 因為你初始化hexo 之後source目錄下自帶一篇hello world文章, 所以直接執行下方命令$ hexo generate# 啟動本地伺服器$ hexo server# 在瀏覽器輸入 http://localhost:4000/就可以看見網頁和模板了INFO Start processingINFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

訪問http://localhost:4000/，便可以看到網站初步的模樣，不要激動，我們還要把網頁發布到Github上去。

重新打開CMD，輸入：

ssh-keygen -t rsa -C "Github的註冊郵箱地址"

一路Enter過來就好，得到信息：

Your public key has been saved in /c/Users/user/.ssh/id_rsa.pub.

找到該文件，打開（sublime text），Ctrl + a複製裡面的所有內容，然後進入Sign in to GitHub：

New SSH key ——Title：blog —— Key：輸入剛才複製的—— Add SSH key

四、配置博客

在blog目錄下，用sublime打開_config.yml文件，修改參數信息

# Hexo Configuration## Docs: http://hexo.io/docs/configuration.html## Source: https://github.com/hexojs/hexo/# Site #站點信息title: #標題subtitle: #副標題description: #站點描述，給搜索引擎看的author: #作者email: #電子郵箱language: zh-CN #語言# URL #鏈接格式url: #網址root: / #根目錄permalink: :year/:month/:day/:title/ #文章的鏈接格式tag_dir: tags #標籤目錄archive_dir: archives #存檔目錄category_dir: categories #分類目錄code_dir: downloads/codepermalink_defaults:# Directory #目錄source_dir: source #源文件目錄public_dir: public #生成的網頁文件目錄# Writing #寫作new_post_name: :title.md #新文章標題default_layout: post #默認的模板，包括 post、page、photo、draft（文章、頁面、照片、草稿）titlecase: false #標題轉換成大寫external_link: true #在新選項卡中打開連接filename_case: 0render_drafts: falsepost_asset_folder: falserelative_link: falsehighlight: #語法高亮 enable: true #是否啟用 line_number: true #顯示行號 tab_replace:# Category & Tag #分類和標籤default_category: uncategorized #默認分類category_map:tag_map:# Archives2: 開啟分頁1: 禁用分頁0: 全部禁用archive: 2category: 2tag: 2# Server #本地伺服器port: 4000 #埠號server_ip: localhost #IP 地址logger: falselogger_format: dev# Date / Time format #日期時間格式date_format: YYYY-MM-DD #參考http://momentjs.com/docs/#/displaying/format/time_format: H:mm:ss# Pagination #分頁per_page: 10 #每頁文章數，設置成 0 禁用分頁pagination_dir: page# Disqus #Disqus評論，替換為多說disqus_shortname:# Extensions #拓展插件theme: landscape-plus #主題exclude_generator:plugins: #插件，例如生成 RSS 和站點地圖的- hexo-generator-feed- hexo-generator-sitemap# Deployment #部署，將 lmintlcx 改成用戶名deploy: type: git repo: 剛剛github創庫地址.git branch: master

特別提醒，在每個參數的：後都要加一個空格

修改網站相關信息

title: 崔斯特測試所用博客subtitle: 副標題description: 網頁描述author: 崔斯特language: zh-CNtimezone: Asia/Shanghai

配置部署（我的是zhihuya，修改成自己的）

deploy: type: git repo: https://github.com/zhihuya/zhihuya.github.io.git branch: master

五、發表文章

在CMD中輸入

$ hexo new "崔斯特測試文章"INFO Created: F: estlogsource\_posts崔斯特測試文章.md

找到該文章，打開，使用Markdown語法，該語法介紹可以查看利用HEXO搭建的博客及Markdown語法介紹

---title: 崔斯特測試文章date: 2017-02-28 13:03:44tags:---這是一篇測試文章，歡迎關注作者博客[1]: https://zhangslob.github.io/

保存，然後執行下列步驟：

F: estlog$ hexo cleanINFO Deleted database.INFO Deleted public folder.F: estlog$ hexo generateINFO Start processingINFO Files loaded in 1.48 s#省略INFO 29 files generated in 4.27 sF: estlog$ hexo serverINFO Start processingINFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

這個時候，打開http://localhost:4000/，發現剛才的文章已經成功了

最後一步，發布到網上，執行：

F: estlog$ hexo deployINFO Deploying: gitINFO Clearing .deploy_git folder...INFO Copying files from public folder...#省略

其中會跳出Github登錄，直接登錄，如果沒有問題輸入zhihuya（換成你的）.http://github.io/

崔斯特測試所用博客

然後就可以看到已經發布了

六、總結

本篇僅僅針對windows，Mac請移步20分鐘教你使用hexo搭建github博客

發布文章的步驟：

1、hexo new 創建文章

2、Markdown語法編輯文章

3、部署（所有打開CMD都是在blog目錄下）

hexo clean #清除緩存網頁正常情況下可以忽略此條命令hexo generate #生成hexo server #啟動服務預覽，非必要，可本地瀏覽網頁hexo deploy #部署發布

簡寫Tips：

hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate#生成
hexo s == hexo server #啟動服務預覽
hexo d == hexo deploy#部署

如果在執行 hexo deploy 後,出現 error deployer not found:github 的錯誤，執行：

npm install hexo-deployer-git --save

出錯是正常的，出錯了自己先百度或google，實在不知道的可以詢問我。

託管的話不僅有github可以用，還有個國內的http://coding.net可選

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

到這裡已經完成了博客的搭建，但是還有很多需要設置和調整的。這是我的博客，也許你會發現，我和剛才搭建的不一樣，因為我修改了博客主題，簡潔、優美。

主題介紹litten/hexo-theme-yilia: 一個簡潔優雅的hexo主題 A simple and elegant theme for hexo.

知乎崔斯特 - 知乎

博客崔斯特的博客

==========================分割線=======================================

2017年3月1日更新：主題推薦

NexT主題開始使用 - NexT 使用文檔

可以增加評論和閱讀量(親，根據官方文檔配置）

評論有http://duoshuo.com/，計數有http://ibruce.info/2015/04/04/busuanzi/！

點擊查看教你免費搭建個人博客，Hexo&Github

效果如下：

小夥伴們，如果成功搭建了，就在評論區留下自己的域名吧~~

-------------------------------------

作者：張世潤

博客專欄：崔斯特的博客專欄

知乎專欄：Python練習題介紹

大家也可以加小編微信：tszhihu （備註：Python），拉大家到 Python愛好者社區微信群，可以跟各位老師互相交流。謝謝。第一時間獲取視頻更新動態。

也可以關注官方微信公眾號：Python愛好者社區