前言：
做為一枚立志成為武林高手的程序員，怎么可以沒有屬于自己的一片園子呢。
一直想搭建一個博客悍缠，但是始終沒開始搞。近期沒事耐量，今天必須把這個事兒搞定飞蚓。
HEXO+Github 快速、簡潔且高效的博客框架
Jekyll+GitHub 將純文本轉(zhuǎn)換為靜態(tài)博客網(wǎng)站
FarBox The Best Blog Platform for Humans
Hugo Hugo是由Go語言實現(xiàn)的靜態(tài)網(wǎng)站生成器廊蜒。簡單趴拧、易用、高效山叮、易擴展著榴、快速部署。
用過HEXO的部分人屁倔，現(xiàn)在都轉(zhuǎn)用Jekyll脑又。
用過Jekyll的人呢，現(xiàn)在又轉(zhuǎn)用FarBox。
還有些用過Jekyll的兄弟們挂谍，現(xiàn)在轉(zhuǎn)用Hugo
FarBox是需要自己掏點腰包，對于我個屌絲來說瞎饲。暫不考慮口叙。
那對于Hugo，是我最佳選擇嗅战。
如果有兄弟想將Jekyll的文章遷移到Hugo妄田，Hugo可以一鍵遷移Jekyll。
快速開始
使用默認的Ananke皮膚創(chuàng)建一個Hugo站點
在這個示例中使用
macOS系統(tǒng), 其它系統(tǒng)怎么進行快速開始驮捍，看安裝
您還需要安裝Git才能運行本教程疟呐。
第一步 導(dǎo)入Hugo
Homebrew，macOS的軟件包管理器东且，可以從brew.sh安裝启具。 如果您正在運行Windows等，請參閱安裝
brew install hugo
驗證您Hugo安裝成功：
hugo version
第二步 創(chuàng)建一個新站點
在名為quickstart的文件夾中創(chuàng)建一個新的Hugo站點珊泳。
quickstart站點名字（建議起名字為yourName.com）
hugo new site quickstart
第三步 添加一個皮膚
請參閱themes.gohugo.io以查看需要考慮的主題列表鲁冯。 這個快速啟動使用美麗的Ananke皮膚。
cd quickstart;\
git init;\
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;\
$ la themes/ananke #看下ananke庫
total 48
-rw-r--r-- 1 hunter staff 41B Jul 31 23:40 .git
-rw-r--r-- 1 hunter staff 331B Jul 31 23:40 .gitignore
-rwxr-xr-x 1 hunter staff 1.0K Jul 31 23:40 LICENSE.md
-rw-r--r-- 1 hunter staff 4.0K Jul 31 23:40 README.md
drwxr-xr-x 3 hunter staff 102B Jul 31 23:40 archetypes
drwxr-xr-x 5 hunter staff 170B Jul 31 23:40 exampleSite
drwxr-xr-x 4 hunter staff 136B Jul 31 23:40 images
drwxr-xr-x 10 hunter staff 340B Jul 31 23:40 layouts
-rwxr-xr-x 1 hunter staff 500B Jul 31 23:40 package.json
drwxr-xr-x 8 hunter staff 272B Jul 31 23:40 src
drwxr-xr-x 4 hunter staff 136B Jul 31 23:40 static
-rwxr-xr-x 1 hunter staff 521B Jul 31 23:40 theme.toml
注意看：
ananke目錄下有個示例站點exampleSite色查。我們用人家的庫薯演，當然得按人家的示例來操作。
在下面秧了，第四步 裝飾你的站點 直接把示例站點中的static跨扮、content文件夾和config.toml文件，與自己站點中的static验毡，content文件夾衡创，和config.toml文件進行替換。
static文件夾：存放圖片
content文件夾：存文章(xxxx.md)
第四步 裝飾你的站點
cp -R /Users/hunter/HaiTeng-Wang.com/themes/ananke/exampleSite/static ./
cp -R /Users/hunter/HaiTeng-Wang.com/themes/ananke/exampleSite/content ./
cp /Users/hunter/HaiTeng-Wang.com/themes/ananke/exampleSite/config.toml ./
關(guān)于cp,命令這里不多說晶通。
你可以用命令行钧汹，將ananke的示例站點exampleSite下的文件，替換成自己的站點文件录择。當然拔莱，如果你愿意，可以手動替換隘竭。
替換完畢后塘秦，你的站點下的static、content文件夾終于不是空的了动看。
你的配置文件config.toml可不再只有幾行命令尊剔，而是這樣
title = "Notre-Dame de Paris"
baseURL = "https://example.com"
languageCode = "en-us"
theme = "gohugo-theme-ananke"
themesDir = "../.."
MetaDataFormat = "yaml"
DefaultContentLanguage = "en"
SectionPagesMenu = "main"
Paginate = 3 # this is set low for demonstrating with dummy content. Set to a higher number
googleAnalytics = ""
enableRobotsTXT = true
[sitemap]
changefreq = "monthly"
priority = 0.5
filename = "sitemap.xml"
[params]
description = "The last theme you'll ever need. Maybe."
facebook = ""
twitter = "https://twitter.com/GoHugoIO"
instagram = ""
youtube = ""
# choose a background color from any on this page: http://tachyons.io/docs/themes/skins/ and preface it with "bg-"
background_color_class = "bg-black"
featured_image = "/images/gohugo-default-sample-hero-image.jpg"
注意:
你需要刪除這行: themesDir = "../.."
你需要查看你的theme,theme = "ananke"
然后，在你的站點根目錄執(zhí)行 Hugo 命令進行調(diào)試：
hugo server -D
瀏覽器里打開：http://localhost:1313
目前為止: 你的站點已經(jīng)創(chuàng)建完畢菱皆。
關(guān)于裝飾你的站點须误，自己隨便改一改站點下的static挨稿、content文件,和config.toml配置文件看看發(fā)生了什么改變。
第五步 部署 Host on GitHub
如果你需要部署在 GitHub Pages 上京痢。
首先在GitHub上創(chuàng)建一個Repository奶甘，命名為：coderzh.github.io （coderzh替換為你的github用戶名）。
然后修改config.toml
publishDir = "docs"
baseURL = "https://haiteng-wang.github.io/"
然后祭椰，在你的站點根目錄執(zhí)行 Hugo 命令進行調(diào)試：
hugo
$ la
你會發(fā)現(xiàn)你的站點下多了個docs文件夾
-rw-r--r--@ 1 hunter staff 6.0K Aug 1 01:12 .DS_Store
drwxr-xr-x 12 hunter staff 408B Aug 1 01:17 .git
-rw-r--r-- 1 hunter staff 108B Jul 31 23:40 .gitmodules
drwxr-xr-x 2 hunter staff 68B Jul 31 23:38 archetypes
-rw-r--r-- 1 hunter staff 838B Aug 1 01:16 config.toml
drwxr-xr-x 8 hunter staff 272B Jul 31 21:55 content
drwxr-xr-x 2 hunter staff 68B Jul 31 23:38 data
drwxr-xr-x 15 hunter staff 510B Aug 1 01:17 docs
drwxr-xr-x 2 hunter staff 68B Jul 31 23:38 layouts
drwxr-xr-x 4 hunter staff 136B Aug 1 01:12 static
drwxr-xr-x 4 hunter staff 136B Jul 31 23:44 themes
然后繼續(xù)在你的站點根目錄執(zhí)行g(shù)it 命令臭家，添加遠程倉庫。
git remote add origin https://github.com/coderzh/coderzh.github.io.git
git add -A
git commit -m "first commit"
git push -u origin master
然后設(shè)置你的github-pages
點擊生成的url看看博客是不是已經(jīng)生成好了,注意如果沒生成好方淤，你可以查看站點下的URL是否對應(yīng)
baseURL = "https://haiteng-wang.github.io/HaiTeng-Wang.github.io-/"
若沒有對應(yīng)钉赁，你需要修改你站點下的baseURL。
以下步驟以后修改站點內(nèi)容携茂，同樣的操作你踩。
修改config.toml文件
baseURL = "https://haiteng-wang.github.io/HaiTeng-Wang.github.io-/"
然后在站點根目錄執(zhí)行Hugo命令
Hugo
接下來執(zhí)行g(shù)it命令
git add .
git commit -m "fix：BaseUrl"
git push
好了，再來查看你的博客地址https://haiteng-wang.github.io是不是生成好了讳苦？
(文章語言姓蜂，沒有采用中性詞語，且很多大白話医吊。半夜兩點了實在困傻了钱慢。原諒我沒有好好整理。)
后續(xù):
如果成功生成GitHub Pages卿堂，但是生成后是這樣的
那我們就直這樣嘍
$ cd docs
$ git init
$ git remote add origin https://github.com/coderzh/coderzh.github.io.git
$ git add -A
$ git commit -m "first commit"
$ git push -u origin master
如果束莫，您發(fā)現(xiàn)文章中，有待梳理草描，寫的不清除的地方览绿，或有更好的補充建議。歡迎評論我穗慕，或聯(lián)系我饿敲。
