最全的教程用Hexo+GitHub搭建個人博客

前言

思來想去堆生,還是決定記錄下我搭建的這個Blog的所有流程,這也算是我的處子作啦雷酪。首先要對Hexo表示感謝淑仆。我是Windows的系統(tǒng),
所以本文講的都是在本系統(tǒng)中是如何搭建的哥力。即將畢業(yè)的我蔗怠,突然感覺該需要一個東西來記錄下我的所學(xué)所想。大概拖拖拉拉的用了好多天才最后搭建好,主要是提高下自己的功力省骂。

下面我將分步詳細介紹如何用Hexo和GitHubPages來搭建Blog蟀淮。個人能力有限,以下流程有什么不懂的或者有好的知識與我分享歡迎聯(lián)系我钞澳,大家共同進步怠惶。

What is Hexo

Hexo 是一個快速、簡潔且高效的博客框架轧粟。Hexo 使用 Markdown(或其他渲染引擎)解析文章策治,在幾秒內(nèi),即可利用靚麗的主題
生成靜態(tài)網(wǎng)頁兰吟。出自臺灣大學(xué)生 tommy351 之手通惫。是一個基于Node.js的靜態(tài)博客程序。另外還有一個好處:使用 Hexo + GitHub 搭建博客
不需要購買域名和服務(wù)器混蔼,由 Github 提供域名和網(wǎng)站頁面空間履腋。支持多種框架主題,我選擇的是Next主題,簡約遵湖。

What is GitHub

GitHub 是一個面向開源及私有 軟件項目的托管平臺悔政,因為只支持 Git 作為唯一的版本庫格式進行托管。有足夠的免費空間(1G)延旧,
自己管理資料谋国,保存可靠。2018年10月19日迁沫,歐盟正式無條件批準了微軟以75億美元收購GitHub芦瘾。


搭建前準備工作

  1. Hexo官方文檔??(具體對hexo有什么問題可以查看文檔)
  2. Git??(點進去可直接下載最新版本,具體的安裝流程
  3. Node.js??(選個最新的下載就好集畅,具體安裝流程
  4. Next主題官網(wǎng)??(一些配置講解的還是比較詳細)
  5. 其他的一些主題可供參考??(根據(jù)自己的喜好風(fēng)格近弟,選擇自己的主題)
  6. Notepad++(我用的是這個來編寫Markdown文章的,如果文章出現(xiàn)亂碼牡整,可以用記事本打開另存為藐吮,然后選擇UTF-8編碼就好了)

開始搭建

說了那么多,準備工作也可以了逃贝,現(xiàn)在擼起袖子干吧!


安裝環(huán)境依賴(Git and Node.js)

首先把前面說的Git和Node.js安裝到電腦上(Windows系統(tǒng))迫摔,教程也有沐扳,對于聰明的你來說,不會難倒你句占。這是我們搭建博客基層的軟件沪摄。以下所有的命令輸入都是在Git軟件里面進行的。


安裝Hexo

在你安裝好Git軟件后纱烘,你可以在電腦空白地方或者桌面上右擊鼠標(biāo)杨拐,就會看到Git GUI Here和Git Bash Here,然后在你想把博客源文件
放的電腦哪個位置擂啥,在里面創(chuàng)建個文件夾用于保存Hexo生成的博客內(nèi)容(文件夾名可為myblog)哄陶。
然后進入該文件夾,空白位置右擊哺壶,然后點擊Git Bash Here 屋吨,在里面輸入:

npm install -g hexo-cli 

接著輸入hexo -v然后輸出以下內(nèi)容就表示安裝成功了(結(jié)果有可能不一樣因為版本問題,但不影響使用)

$ hexo -v
hexo: 3.7.1
hexo-cli: 1.1.0
os: Windows_NT 10.0.10240 win32 x64
http_parser: 2.7.0
node: 7.0.0
v8: 5.4.500.36
uv: 1.9.1
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 57.1
modules: 51
openssl: 1.0.2j

如果沒有報錯山宾,就表示安裝成功了至扰。接下來繼續(xù)輸入:

hexo init  # 初始化組件

回車后npm就會自動安裝博客所需的組件了,你要做的就是等待资锰,等全部安裝完就可以了敢课。這時你就看到文件夾里會出現(xiàn)以下目錄結(jié)構(gòu):

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

驗證以下hexo是否安裝成功,還是在這個文件夾里右擊找到Git Bash Here在里面輸入命令

hexo g

等待加載完然后在輸入命令

hexo s

出現(xiàn)這種樣式,就啟動成功了

INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

然后打開你的瀏覽器直秆,在網(wǎng)址欄里輸入http://localhost:4000(默認端口為4000)濒募。就會看到博客的原始狀態(tài),也就證明安裝成功了如下圖所示:


是不能訪問切厘。原因是:那是你的電腦端口被占用了萨咳,hexo默認的端口是4000,你應(yīng)該換個端口運行疫稿,可換成hexo s -p 5000就可以訪問了培他。
運行成功后,就在剛剛的Git Bash Here對話框中按鍵盤上的Ctrl+c停止服務(wù)遗座,瀏覽器就不能瀏覽了舀凛。到此整個hexo搭建的博客結(jié)束了。此時感覺自己小有成就感途蒋。


部署到GitHub

首先你需要創(chuàng)建一個Github:https://github.com/賬號猛遍。在你注冊時,一定要記住你使用的注冊的郵箱号坡,GitHub大多數(shù)都是通過郵箱發(fā)送消息的懊烤。

申請成功后,會有郵箱通知宽堆,驗證下就可以了腌紧。

創(chuàng)建代碼倉庫

這時用我們自己的GitHub用戶名建立倉庫,http://username.github.io這樣的用戶或訪問站點畜隶,每個用戶名只能建立一個壁肋。
首先,在保證登錄的情況下籽慢,我們點擊右上角的+號浸遗,點擊New repository,新建一個倉庫

進入后,在Repositoty name輸入框里填寫自己的用戶名.github.io箱亿。例如我的用戶名為xiayunhu跛锌,則填寫xiayunhu.github.io

隨后選擇Setting進入設(shè)置,找到Github Pages如下:

然后我們需要任意選擇一個主題极景,點擊Choose a theme察净,然后選擇好后,頁面會跳轉(zhuǎn)到倉庫里如圖所示:

此時你再打開Setting盼樟,我們會看到你開啟了GitHub Pages之后得到的域名如下:

現(xiàn)在你可以使用https://UserName.github.io氢卡,訪問自己的博客網(wǎng)站了。關(guān)于更多Github的使用和介紹晨缴,大家可以去菜鳥教程上或者百度自行了解译秦。

配置SSH

本地博客和Github都做好了,接下來我們?nèi)绾螌⒈镜谿it項目和Github連接起來?就是用SSH筑悴。還是在博客文件夾里右擊打開Git Bash Here輸入以下命令

ssh -T git@github.com

如圖所示:

輸入命令回車们拙,然后你會看到這樣的反饋

The authenticity of host 'github.com (207.97.227.239)' can't be established. RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48. Are you sure you want to continue connecting (yes/no)?

直接在后面輸入yes再回車,看到下面的圖的結(jié)果阁吝,就證明配置成功了砚婆。

注意,問題來了哦突勇,當(dāng)你輸入yes后装盯,有可能會提示如下信息

因為大多數(shù)的情況是github賬號沒有添加ssh公鑰信息,這是打開GitHub網(wǎng)站甲馋,在確保登錄的情況下埂奈,找到網(wǎng)站的右上角找到Settings

點進去,在左邊找到SSH and GPG keys后定躏,點進去右上角找到New SSH key點進去后如下圖所示:

如圖片中的key提示账磺,我們要原樣復(fù)制~/.ssh/id_rsa.pub文件的內(nèi)容。如果沒有該文件在Git Bash Here里輸入以下命令

ssh-keygen -t rsa

然后一直回車結(jié)束痊远,然后在C盤的C:\Users\Administrator.ssh里找到id_rsa.pub文件垮抗,用記事本打開,Ctrl+A -> Ctrl+CNew SSH key里面Ctrl+V粘貼碧聪,點擊Add SSh key保存就可以了借宵。最后再輸入

ssh -T git@github.com

回車就OK了。

將本地文件部署到GitHub

在把本地倉庫傳到github上去之前矾削,還需要設(shè)置username和email,因為github每次commit都會記錄他們豁护。

$ git config --global user.name "your name"     #倉庫的名字
$ git config --global user.email "your_email@youremail.com"     #你的郵箱

設(shè)置完后哼凯,我們每次使用hexo d命令時就不用每次都輸入密碼了。
接下來我們就要修改hexo中的_config.yml文件(也就是站點配置文件)如下圖所示:

找到文件里面的deploy標(biāo)簽楚里,改成如下列所示断部,Ctrl+S保存,此時要注意班缎,冒號后邊都要加上一個空格蝴光,否則會報錯的。

  deploy:
          type: git
          repo: git@github.com:xiayunhu/xiayunhu.github.io.git
          branch: master

然后在文件夾里運行Git Bash Here輸入以下命令

     npm install hexo-deployer-git --save

再依次輸入

    hexo clean
    hexo generate  #可簡寫hexo g
    hexo deploy    #可簡寫hexo d

出現(xiàn)以下提示

那么恭喜你达址,個人博客已經(jīng)部署到GitHub上了蔑祟。你可以去你的GitHub倉庫查看是否有信息,稍微等待一下就可以訪問http://your_user_name.github.io(your_user_name也就是你的倉庫名字)沉唠,此時你就可以看到你的個人博客了疆虚。


將自己的域名和GitHub Pages的空間綁定

我們現(xiàn)在可以通過本地瀏覽或者GitHub Pages提供的域名訪問了,但總感覺不是自己的東西,于是我就自己申請了一個域名径簿,來瀏覽自己的博客罢屈,這樣在介紹自己的博客的時候,明顯的高大尚許多篇亭。我是在騰訊云的網(wǎng)站上申請的缠捌,需要備案(比較麻煩,需要半個多月)译蒂,你也可以在阿里云上申請或者其他的地方購買曼月,應(yīng)該不騰訊云快,我介紹的是騰訊云上申請的域名蹂随。

申請域名

此時要注意的是:不需要購買服務(wù)器

進入到騰訊云的官網(wǎng),在產(chǎn)品一欄十嘿,找到域名注冊,這樣就可以注冊了岳锁,不同的域名價格不一绩衷,自行找個好記得就好。

具體備案激率,根據(jù)里面的流程自行備案咳燕。等備案好,然后對域名進行解析:

點擊添加解析乒躺,記錄類型選A或CNAME招盲,A記錄的記錄值就是ip地址,github(官方文檔)提供了兩個IP地址嘉冒,192.30.252.153和192.30.252.154曹货,這兩個IP地址為github的服務(wù)器地址,兩個都要填上讳推,解析記錄設(shè)置兩個www和@顶籽,線路就默認就行了,CNAME記錄值填你的github博客網(wǎng)址银觅。如我的是xiayunhu.github.io礼饱。

這些全部設(shè)置完成后,此時你并不能要申請的域名訪問你的博客究驴。接著你需要做的是在hexo根目錄的source文件夾里創(chuàng)建CNAME文件镊绪,不帶任何后綴,里面添加你的域名信息洒忧,如:www.xyhwh.com蝴韭。
注意搭建完成訪問出現(xiàn)404 :你認為配置沒有問題拴孤,那么可能只是你的瀏覽器在搗鬼洒琢,可嘗試清除瀏覽器緩存再訪問或者換個瀏覽器訪問歧蒋。應(yīng)該就解決了。

GitHub Pages里配置域名

進入GitHub李皇,然后找到Settings如下圖所示:

然后往下找精算,找到GitHub Pages一欄如圖所示:

這樣整個用Hexo+GitHub搭建的博客到現(xiàn)在就搭建完成了蒙谓。


后記

以上所述剥啤,就是搭上建博客的全部流程,如果你有什么問題或者文章有錯的地方减余,歡迎在下面留言综苔。具體的主題配置,將會在下節(jié)詳細介紹位岔。


參考的資料:

Hexo中文文檔
Next主題使用文檔


?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末如筛,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子抒抬,更是在濱河造成了極大的恐慌杨刨,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,104評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件擦剑,死亡現(xiàn)場離奇詭異妖胀,居然都是意外死亡,警方通過查閱死者的電腦和手機惠勒,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評論 3 399
  • 文/潘曉璐 我一進店門赚抡,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人纠屋,你說我怎么就攤上這事涂臣。” “怎么了售担?”我有些...
    開封第一講書人閱讀 168,697評論 0 360
  • 文/不壞的土叔 我叫張陵赁遗,是天一觀的道長。 經(jīng)常有香客問我族铆,道長吼和,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,836評論 1 298
  • 正文 為了忘掉前任骑素,我火速辦了婚禮,結(jié)果婚禮上刚夺,老公的妹妹穿的比我還像新娘献丑。我一直安慰自己,他們只是感情好侠姑,可當(dāng)我...
    茶點故事閱讀 68,851評論 6 397
  • 文/花漫 我一把揭開白布创橄。 她就那樣靜靜地躺著,像睡著了一般莽红。 火紅的嫁衣襯著肌膚如雪妥畏。 梳的紋絲不亂的頭發(fā)上邦邦,一...
    開封第一講書人閱讀 52,441評論 1 310
  • 那天,我揣著相機與錄音醉蚁,去河邊找鬼燃辖。 笑死,一個胖子當(dāng)著我的面吹牛网棍,可吹牛的內(nèi)容都是我干的黔龟。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼滥玷,長吁一口氣:“原來是場噩夢啊……” “哼氏身!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起惑畴,我...
    開封第一講書人閱讀 39,899評論 0 276
  • 序言:老撾萬榮一對情侶失蹤蛋欣,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后如贷,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體陷虎,經(jīng)...
    沈念sama閱讀 46,457評論 1 318
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,529評論 3 341
  • 正文 我和宋清朗相戀三年倒得,在試婚紗的時候發(fā)現(xiàn)自己被綠了泻红。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,664評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡霞掺,死狀恐怖谊路,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情菩彬,我是刑警寧澤缠劝,帶...
    沈念sama閱讀 36,346評論 5 350
  • 正文 年R本政府宣布,位于F島的核電站骗灶,受9級特大地震影響惨恭,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜耙旦,卻給世界環(huán)境...
    茶點故事閱讀 42,025評論 3 334
  • 文/蒙蒙 一脱羡、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧免都,春花似錦锉罐、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至险领,卻和暖如春侨舆,著一層夾襖步出監(jiān)牢的瞬間秒紧,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評論 1 272
  • 我被黑心中介騙來泰國打工挨下, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留熔恢,地道東北人。 一個月前我還...
    沈念sama閱讀 49,081評論 3 377
  • 正文 我出身青樓复颈,卻偏偏與公主長得像绩聘,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子耗啦,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,675評論 2 359

推薦閱讀更多精彩內(nèi)容