Hexo在GitHub托管博客詳細步驟

本片博文講詳細講解搭建過程,經歷鑒于我搭建托管博客所遇到的錯誤!為了避免讀者重蹈覆轍。我將盡量詳細,和一些遇到的錯誤與大家分享。

====

-------

# 第一步

1 首先我們先去準備[github](https://github.com/)(點擊文字進行跳轉)。

2 首先在主界面注冊github進行!按照步驟進行注冊。

3 注冊成功先不要急!此時我們還需要驗證郵箱地址。![郵箱驗證](http://c.hiphotos.baidu.com/image/pic/item/8c1001e93901213f827f40ed5ce736d12f2e95b6.jpg)

4 接下來我們需要建立一個倉庫![](http://b.hiphotos.baidu.com/image/pic/item/d833c895d143ad4b78cc48f18a025aafa40f0624.jpg)!記住建立倉庫時所填寫的內容!是你的帳號.github.io? (這是因為github規定的格式這樣才會直接講當前倉庫作為托管站點)![](http://b.hiphotos.baidu.com/image/pic/item/2934349b033b5bb5d89628cf3ed3d539b600bcb9.jpg)

5 到這里,你現在就成功了百分之25了!加油 ?是不是很容易。別著急 ?接下來就需要細心和仔細了,因為hexo對格式要求很嚴格(我在格式上錯誤了很多次,當時都有放棄的念頭了,所以希望大家遇到困難別氣餒,人家都能搞出來!我們為何不行呢)。

# hexo配置篇

1 再次提醒讀者朋友 一定要注意格式,我會在必要的地方提示。

2 首先大家需要在如下地址下載最新版hexo。[node.js](http://nodejs.cn/)(盡量下載最新版本!博文發出時間為16年6月!當前鏈接只是這段時間最新版)。

3 大家下載好!可以開始安裝了(如果你和我一樣是處女座不想安裝到期C盤,那么請一路next)

4 鼠標右鍵任意地方,選擇Git Bash ![](http://h.hiphotos.baidu.com/image/pic/item/810a19d8bc3eb13554e2bd8aae1ea8d3fd1f44dd.jpg),使用以下命令安裝hexo(ps:以下命令中的$符號只為了讓教程和實際看起來一致,實際輸入命令只需輸入$ 后面的命令即可) ```$ npm install hexo-cli -g```

如果之后在使用的過程中,遇到以下的錯誤

```ERROR Deployer not found : github```

則運行以下命令,或者你直接先運行這個命令更好。

```$ npm install hexo-deployer-git --save

$ hexo g

$ hexo d

```


接下來創建放置博客文件的文件夾:hexo文件夾。在自己想要的位置創建文件夾,如我hexo文件夾的位置為E:\hexo,名字和地方可以自由選擇,當然最好不要放在中文路徑下,至于原因,我想很多人懂得。之后進入文件夾,即E:\hexo內,點擊鼠標右鍵,選擇Git Bash,執行以下命令,Hexo會自動在該文件夾下下載搭建網站所需的所有文件。

```$ hexo init```

安裝依賴包

```$ npm install```

讓我們看看剛剛下載的hexo文件帶來了什么,在E:\hexo內執行以下命令,

```$ hexo g

$ hexo s```


然后用瀏覽器訪問http://localhost:4000/,此時,你應該看到了一個漂亮的博客了,當然這個博客只是在本地的,別人是看不到的,hexo3.0使用的默認主題是landscape。輕輕松松就看到了一點成果,是不是很激動,這就是hexo的強大之處,這個本地預覽的功能,我真是愛不釋手

# 讓我們開始部署本地文件到github

既然Repository已經創建了,當然是先把博客放到Github上去看看效果。編輯E:\hexo下的_config.yml文件,建議使用Notepad++。

在_config.yml最下方,添加如下配置(命令中的第一個huangjunhui為Github的用戶名,第二個huangjunhui為之前New的Repository的名字,記得改成自己的。另外記得一點,hexo的配置文件中任何’:’后面都是帶一個空格的),如果配置以下命令出現ERROR Deployer not found : github,則參考上文的解決方法。

![](http://f.hiphotos.baidu.com/image/pic/item/472309f79052982287c44df2dfca7bcb0a46d408.jpg)這里要注意格式了(注意間隔,按照圖片上的來,:后面有內容一定要加個空格)

配置好_config.yml并保存后,執行以下命令部署到Github上。如果你是第一次使用Github或者是已經使用過,但沒有配置過SSH,則可能需要配置一下,具體方法史上最全github使用方法:github入門到精通里面有介紹到。

```

$ hexo g

$ hexo d

```

執行上面的第二個命令,可能會要你輸入用戶名和密碼,皆為注冊Github時的數據,輸入密碼是不顯示任何東西的,輸入完畢回車即可。

此時,我們的博客已經搭建起來,并發布到Github上了,在瀏覽器訪問huangjunhui.github.io就能看到自己的博客了。第一次訪問剛地址,可能訪問不了,您可以在幾分鐘后進行訪問,一般不超過10分鐘。

#hexo的配置文件

hexo里面有兩個常用到的配置文件,分別是整個博客的配置文件E:\hexo\_config.yml和主題的配置文件E:\hexo\themes\light\_config.yml,此地址是對于我來說,hexo3.0使用的默認主題是landscape,因此你們的地址應該是E:\hexo\themes\landscape\_config.yml,下文所有講到light的地方,你們將之換為自己的主題名即可。本博客使用的主題是基于light改善的主題,目前還在完善中,如果完成的比較好,以后可能發布在github上。如果你想自己挑選喜歡的主題,hexo官方提供了12個主題供你自己選擇,使用方法很簡單,點擊自己想要的主題,進入該主題的Repository,使用Git將主題clone到本地,然后將整個文件夾復制到E:\hexo\themes文件夾下,將E"\hexo\_config.yml里的theme名字改為自己下載的主題的文件夾名即可。

接下來介紹整個博客的配置文件。

E:\hexo_config.yml

```# Hexo Configuration

## Docs: https://hexo.io/docs/configuration.html

## Source: https://github.com/hexojs/hexo/

# Site

title: 喜歡雨天的我

subtitle:

description: 生活一半記憶,一半繼續

author: Hou Shuai

language: zh-Hans

timezone:

# URL

## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'

url: http://yoursite.com/child

root: /

permalink: :year/:month/:day/:title/

permalink_defaults:

# Directory

source_dir: source

public_dir: public

tag_dir: tags

archive_dir: archives

category_dir: categories

code_dir: downloads/code

i18n_dir: :lang

skip_render:

# Writing

new_post_name: :title.md # File name of new posts

default_layout: post

titlecase: false # Transform title into titlecase

external_link: true # Open external links in new tab

filename_case: 0

render_drafts: false

post_asset_folder: false

relative_link: false

future: true

highlight:

enable: true

line_number: true

auto_detect: false

tab_replace:

# Category & Tag

default_category: uncategorized

category_map:

tag_map:

# Date / Time format

## Hexo uses Moment.js to parse and display date

## You can customize the date format as defined in

## http://momentjs.com/docs/#/displaying/format/

date_format: YYYY-MM-DD

time_format: HH:mm:ss

# Pagination

## Set per_page to 0 to disable pagination

per_page: 10

pagination_dir: page

# Extensions

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

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

theme: yelee

# Deployment

## Docs: https://hexo.io/docs/deployment.html

deploy:

type: git

repository: http://github.com/houshuai0816/houshuai0816.github.io.git

branch: master

```

按照自己的意愿修改完后,執行hexo g,hexo s,打開localhost:4000看看效果。

E:\hexo\themes\light\_config.yml,此處針對Concise主題,如果使用其他主題,請查看自己主題的幫助文檔

作者現在使用的樣式為[我的博客](http://houshuai0816.github.io/)

樣式出處[點擊跳轉](https://github.com/MOxFIVE/hexo-theme-yelee)

# 發布新的文章

1.在Git Bash執行命令:$ hexo new "my new post"

2.在E:\hexo\source\_post中打開my-new-post.md,打開方式使用記事本或notepad++。

hexo中寫文章使用的是Markdown,沒接觸過的可以看下Markdown語法說明,一分鐘學會Markdown

```title: my new post#可以改成中文的,如“新文章”

date:2015-04-0822:56:29#發表日期,一般不改動

categories: blog#文章文類

tags: [博客,文章]#文章標簽,多于一項時用這種格式,只有一項時使用tags: blog

---

#這里是正文,用markdown寫,你可以選擇寫一段顯示在首頁的簡介后,加上

#在之前的內容會顯示在首頁,之后的內容會被隱藏,當游客點擊Read more才能看到。```

寫完文章后,你可以使用1.$ hexo g生成靜態文件。2.$ hexo s在本地預覽效果。3.hexo d同步到github,然后使用http://huangjunhui.github.io進行訪問

# 自定義樣式布局系列

1 如果覺得hexo自帶的樣式不好的話,可以在[github](https://github.com/search? utf8=%E2%9C%93&q=hexo)下搜索自己感興趣的主題,需要先

```cd 到你存儲博客的文件下的themes文件夾下

git clone github上對應的網址

```

![](http://d.hiphotos.baidu.com/image/pic/item/8cb1cb13495409238e7b104f9a58d109b3de49f4.jpg)

2 配置樣式的內容同樣是在樣式目錄下的全局配置文件中更改 ```_config.yml```.根據樣式提示更改

3 對樣式進行覆蓋并部署到github上。需要在當前博客目錄下?

```

hexo clean

hexo g

hexo d

```

這樣就可以輸入自己在github上托管的網址查看效果了,是不是很簡單呢。如果想和自己在萬維網上的網址鏈接在一起,可以查看[鴻洋_博客](http://blog.csdn.net/lmj623565791/article/details/51319147)

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,030評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,310評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,951評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,796評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,566評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,055評論 1 322
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,142評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,303評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,799評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,683評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,899評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,409評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,135評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,520評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,757評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,528評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,844評論 2 372

推薦閱讀更多精彩內容