01-Hexo+GitHubGitee搭建個人博客系列-基礎環(huán)境搭建

后街男孩主頁


為什么需要個人博客

古人為了要記往一件事,就在繩子上打一個結(jié)。文字是人類文明的最主要的載體。有了文字,人類的知識才能記錄下來,得以在空間和時間上廣為傳播。古埃及人用草紙記載其科技成就,使之流傳千古。有了文字和書寫工具,思想和技術可以保留和傳遞,就有了文化的延續(xù)和發(fā)展。

現(xiàn)在我們進入信息時代,記錄的方式也隨著改變,越來越多的筆記軟件進入我們的視線,但是局限于自定義界面的痛苦,我更喜歡使用自己的博客來記錄生活和學習。以前學習的時候,學一點丟一點,其實就是自己沒有好好的做筆記,我總在想那個問題我遇到過,我好像知道怎么解決,可是我就是想不起解決辦法。

這次的系列教程會教大家如何從零搭建一個免費的個人博客。搭建的過程十分簡單,我會帶你一步一步搭建,搭建過程中如果遇到任何問題,大家可以在文章下面留言,我會給大家解答。大家也可以去我的微信公眾號科技毒瘤君交流學習。

教程說明

這個教程講解的很詳細,非常適合入門小白的搭建,教程中每一步都有截圖和介紹,相信你一定會學會,歡迎大家關注我的公眾號--科技毒瘤君,持續(xù)關注后續(xù)的教程。

教程中所涉及到的指令,大家可以復制其代碼,然后在對應的控制臺中點擊鼠標右鍵,選擇粘貼(paste)即可。

搭建后的效果

因為使用的免費的服務,Gitee Pages不能自定義域名,所以我一般把他作為國內(nèi)的備份,而GitHub是支持自定義域名的,就是訪問速度較慢,如果GitHub的掛掉了,我就可以無縫銜接到國內(nèi)了。下面的GiteeGitHub分別的網(wǎng)址,大家可以前往看看最后的效果。

Gitee:https://beiwangshan.gitee.io/

GitHub:https://houjie.xyz/

需要注意的是,GitHub自定義后的域名在騰訊系列的產(chǎn)品中會不能訪問,提示安全問題,我也配置了SSL安全證書,就是不能通過安全認證。其他的瀏覽器可以。

開始搭建

軟件準備

空的文件夾

我們需要在本地電腦上建立一個空文件夾,我這里命名為Blog,文件可能會隨著文章數(shù)量的增多而變得龐大,所以大家自行選擇位置。趨于教程,我把文件夾放在桌面,后面的教程我也會直接使用這個文件搭建。

blog文件夾

安裝Git

安裝Git

Git

為什么需要Git,因為我們需要把本地的文件推送到Gitee或者GitHub,所以需要這個版本控制的軟件。我們進入官網(wǎng)后下載Windows版本的軟件。然后在本地安裝,安裝很簡單,這里就不做介紹了。懶得百度的我給大家準備了百度后的鏈接,點擊前往即可

安裝node.js

下載地址

Hexo是基于nodeJS編寫的,所以需要安裝一下nodeJs和里面的npm工具。按照自己電腦的版本進行下載。推薦大家下載Windows Installer(.msi)下載之后點擊安裝就可以了。

node.js

在node.js安裝完成之后,我們還需要檢驗一下是否安裝,我們打開CMD命令行工具,輸入以下指令:

node -v

npm -v

node和npm版本

關于打開CMD控制臺:

?快捷方式,我們同時按下win+R鍵,然后輸入cmd,最后回車即可

?

安裝Hexo

我們在Blog文件夾下執(zhí)行CMD控制臺,輸入以下指令:

npm install -g hexo-cli

安裝hexo

安裝完成之后,我們輸入以下指令,檢驗hexo版本:

hexo -v

hexo版本

如何在指定文件夾打開CMD控制臺:

?我們打開指定的文件夾,然后在文件目錄框中輸入cmd然后回車即可。

指定文件夾打開cmd


初始化hexo

經(jīng)過上面的步驟,我們已經(jīng)具備了搭建的環(huán)境,下面就是具體的安裝過程,同樣我會以圖文的方式指導安裝。小白友好度極佳。同時建議大家參考一下官方的Hexo中文文檔,里面也有十分詳細的介紹。

初始化

我們繼續(xù)在控制臺輸入以下指令:

hexo init myblog

這個myblog可以自己取什么名字都行,他會按照這個名字在你的Blog文件夾下面創(chuàng)建這個名字的文件夾。這個安裝過程可能需要等待一會兒,具體根據(jù)自己的網(wǎng)絡定。執(zhí)行完成后繼續(xù)執(zhí)行以下指令:

cd myblog //進入這個myblog文件夾

npm install

安裝hexo

新建完成之后,你的myblog目錄結(jié)果如下:

.

├──?_config.yml

├──?package.json

├──?scaffolds

├──source

|???├──?_drafts

|???└──?_posts

└──?themes

這里介紹一下主要會使用到的目錄及文件的意義:

_config.yml:站點配置文件,后面的教程也會把myblog目錄下的這個文件叫做站點配置文件

source:資源文件,最后寫的文章也會在這里放著。

themes:主題文件目錄,到時候我們需要換主題的時候就放在這里面。每個主題里面也有一個配置文件_config.yml,我把他叫做主題配置文件,后面也會這樣稱呼它,大家注意和站點配置文件區(qū)分

站點文件目錄


啟動博客

因為我們安裝了Git,我們就可以在站點目錄下執(zhí)行一系列的操作,首先第一個操作是運行網(wǎng)站,我們通過上面的步驟,已經(jīng)完成了博客主題框架的搭建,我們可以先運行一下試試。

所謂站點目錄就是myblog目錄

指定文件目錄運行

在運行前,我們需要切換到站點目錄下,然后在目錄的空白處單擊鼠標右鍵,選擇Git Bash Here,我稱之為Git控制臺,這個名詞大家也記住,后面的文章會經(jīng)常用到。

打開后,我們輸入運行的指令

hexo g # 生成

hexo s # 啟動服務

啟動服務

然后我們?nèi)g覽器中打開這個地址

http://localhost:4000/

預覽效果


創(chuàng)建倉庫

我使用的是Gitee+GitHub的雙倉庫搭建,我的一份博客會分別放置在兩個倉庫中,Gitee pages對國內(nèi)用戶友好,但是不支持自定義域名,GitHub對國內(nèi)用戶訪問速度較慢,但是支持自定義域名,對于訪問速度,我也會在后續(xù)的文章中指導大家。

關于倉庫的選擇,我建議大家都去注冊著,至于最后要用哪個,看情況選擇。

注冊

兩個倉庫的注冊地址如下:

Gitee:https://gitee.com/

GitHub:https://github.com/

注冊時候取一個好記的名字,這個名字也會加到你的訪問域名之中,例如我的就是:

beiwangshan.gitee.io

beiwangshan83.github.io

注冊過程省略,實在不會就去百度吧。注冊之后需要去個人中心設置郵箱。注冊的郵箱一定要驗證,否則后面的步驟無法執(zhí)行。

創(chuàng)建倉庫地址

Gitee倉庫

點擊右上角的+號,選擇新建一個倉庫

倉庫名稱必須和自己的用戶名保持一致,假如你的用戶名叫test,那么你的倉庫名稱就是test,因為我這里已經(jīng)創(chuàng)建了,所以會報已經(jīng)存在。下面的路徑不要理會,會根據(jù)倉庫名稱自動生成。

倉庫名稱


倉庫簡介可寫可不寫,倉庫保持開源。下面的就按照圖中的設置。然后點擊創(chuàng)建。

倉庫設置

GitHub倉庫

Create a new repository,同樣的創(chuàng)建一個倉庫,但是倉庫名稱必須是用戶名.github.io,假如你的用戶名是test,那么你的倉庫名稱應該是:test.github.io,然后選擇public,下面的初始化都不用選擇。

GitHub倉庫


生成SSH添加到Gitee或者GitHub

ssh,簡單來講,就是一個秘鑰,其中,id_rsa是你這臺電腦的私人秘鑰,不能給別人看的,id_rsa.pub是公共秘鑰,可以隨便給別人看。把這個公鑰放在GitHub上,這樣當你鏈接GitHub自己的賬戶時,它就會根據(jù)公鑰匹配你的私鑰,當能夠相互匹配時,才能夠順利的通過git上傳你的文件到GitHub上。

我們回到Git控制臺,輸入以下指令:

git config --global user.name "yourname"

git config --global user.email "youremail"

yourname:指的是你的用戶名

youremail:指的是你綁定的郵箱地址

可以用以下兩條指令,檢查一下你有沒有輸對,正確的情況會返回你的用戶名和郵箱地址

git config user.name

git config user.email

然后創(chuàng)建SSH,一路回車即可

ssh-keygen -t rsa -C "youremail"

youremail換成自己的郵箱

這個時候它會告訴你已經(jīng)生成了.ssh的文件夾。在你的電腦中找到這個文件夾。

文件路徑目錄:

? C盤 -->? 用戶 -->? 電腦用戶名 -->? .ssh

而后在GitHub的setting中,找到SSH keys的設置選項,點擊New SSH key,把你的id_rsa.pub(用記事本打開)里面的信息復制進去。標題名稱自己隨便起。

SHH KEYS

Gitee 同樣在個人設置之中 --> SSH公鑰里面添加

驗證是否配置成功

回到Git控制臺,輸入下面的指令:

ssh -T git@github.com # 驗證GitHub

ssh -T git@gitee.com # 驗證Gitee

下面的情況是配置成功的:

配置成功


關于SHH秘鑰:

? 如果你的gitee和GitHub使用的是不同的郵箱也沒事,只要生成一個密碼即可,同時添加到gitee和GitHub。

將hexo部署到GitHub/Gitee

修改站點配置文件

這一步,我們就可以將hexo和GitHub和Gitee關聯(lián)起來,也就是將hexo生成的文章部署到GitHub和Gitee上,我們打開站點配置文件(_config.yml),然后翻到最后,把deploy:修改為:

deploy:

type:git

repo:

Github:#你的GitHub對應的倉庫地址

gitee:#你的gitee對應的倉庫地址

branch:master

其中GitHub和gitee后面的值是你倉庫的HTTPS地址,Gitee你可以在克隆/下載按鈕下獲取,GitHub則在Code按鈕下

需要注意

配置文件都需要遵循yml語法,在:號后面有一個空格,然后跟著需要填寫的數(shù)據(jù)。

安裝deploy-git

這個時候需要先安裝deploy-git,也就是部署的命令,這樣你才能用命令部署到GitHub和gitee。

npm install hexo-deployer-git --save

接著在Git控制臺輸入:

hexo clean

hexo generate

hexo deploy

hexo clean清除了你之前生成的東西,也可以不加。

hexo generate顧名思義,生成靜態(tài)文章,可以用hexo g縮寫

hexo deploy部署文章,可以用hexo d縮寫

注意deploy時可能要你輸入username和password。

提交代碼

等待提交完成,我們就可以去倉庫刷新查看一下,可以看到剛才的代碼已經(jīng)提交上來了。GitHub可能相對較慢一些,等待一會就可以啦。

開啟pages服務

gitee中

在Gitee中,我們需要點擊倉庫上面的服務,打開Gitee Pages服務,以后每次發(fā)布完文章,我們都需要在這里來更新一下服務。第一次打開,應該是部署按鈕,我們勾選上面的強制使用HTTPS,然后點擊部署就好了。

比較繁瑣,所以我只是把這個倉庫作為存儲網(wǎng)站的服務,萬一哪一天GitHub不能訪問了,就只能靠他了。

gitee中開啟pages服務


GitHub中

在GitHub中,其實我們不需要特定的設置,它會自己解析你的倉庫,從而達到自動部署的功能。出于保險,我們還是去看一看。

打開倉庫上面的Settings,然后找到GitHub Pages,你會看到 Your site is published at https://houjie.xyz/,

因為我配置了自己的域名(后期會專門用一章教程來說),所以是這樣的,在沒配置之前,你的應該是這樣的:

http://yourname.github.io

GitHub中開啟pages服務


這一節(jié)的教程暫時到這啦,第一節(jié)的教程比較多,也比較枯燥,配置到這的網(wǎng)站效果還不是很好,我會盡快在下一期的教程為大家美化這個網(wǎng)站,然后配置好自己的域名,最后是如何做好文章的發(fā)布,文章我都會同步在我的微信公眾號科技毒瘤君和個人博客,歡迎大家前往留言自己遇到的問題,我都會一一回復大家的。歡迎大家多多分享哦!

后街博客

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

友情鏈接更多精彩內(nèi)容