hexo干貨系列:(一)hexo+gitHub搭建個(gè)人獨(dú)立博客

前言


一直想要一個(gè)自己的獨(dú)立博客,但是覺得申請(qǐng)域名+服務(wù)器的太麻煩了就一直沒有實(shí)現(xiàn)。偶然機(jī)會(huì)發(fā)現(xiàn)Hexo這個(gè)優(yōu)秀的靜態(tài)博客框架,再搭配現(xiàn)在流行的gitHub,簡(jiǎn)直是完美寫博客的黃金搭檔(免費(fèi)+方便)。于是就上網(wǎng)參考了好多教程最后磕磕碰碰的搭建了起來。但是網(wǎng)上的教程多多少少都有點(diǎn)問題,可能比較早吧。就有了這個(gè)自己總結(jié)的教程,一是自己總結(jié)一下。二是給也想搭建Hexo博客的童鞋們多一點(diǎn)參考。

正文


我這個(gè)教程是基于window系統(tǒng)用戶,Hexo3版本

安裝前提軟件


Node.js:
作用:node.js用來創(chuàng)建hexo博客框架的,我當(dāng)前安裝版本為:node-v5.6.0-x64
Git客戶端:
作用:把本地的hexo內(nèi)容提交到github上去,我當(dāng)前安裝的是Git-2.7.0-64-bit

安裝Hexo

安裝前先介紹幾個(gè)hexo常用的命令,#后面為注釋。

hexo g #完整命令為hexo generate,用于生成靜態(tài)文件
hexo s #完整命令為hexo server,用于啟動(dòng)服務(wù)器,主要用來本地預(yù)覽
hexo d #完整命令為hexo deploy,用于將本地文件發(fā)布到github上
hexo n #完整命令為hexo new,用于新建一篇文章

利用 npm 命令即可安裝。在任意位置點(diǎn)擊鼠標(biāo)右鍵,選擇Git Base



輸入安裝hexo命令:

npm install -g hexo

安裝完成后,在你喜愛的文件夾下(如E:\Hexo),執(zhí)行以下指令(在E:\Hexo內(nèi)點(diǎn)擊鼠標(biāo)右鍵,選擇Git Bash),Hexo 即會(huì)自動(dòng)在目標(biāo)文件夾建立網(wǎng)站所需要的所有文件。

hexo init

安裝依賴包:

    npm install

讓我們看看剛剛下載的hexo文件帶來了什么,在E:\hexo內(nèi)執(zhí)行以下命令:

    hexo g
    hexo s

然后用瀏覽器訪問http://localhost:4000, 此時(shí),你應(yīng)該看到了一個(gè)漂亮的博客了,當(dāng)然這個(gè)博客只是在本地的,別人是看不到的,hexo3.0使用的默認(rèn)主題是landscape。輕輕松松就看到了一點(diǎn)成果,是不是很激動(dòng),這就是hexo的強(qiáng)大之處,這個(gè)本地預(yù)覽的功能,我真是愛不釋手。

注冊(cè)Github帳號(hào)


已經(jīng)有Github帳號(hào)跳過此步,首先進(jìn)入Github進(jìn)行注冊(cè),用戶名、郵箱和密碼之后都需要用到,自己記好。

創(chuàng)建repository

repository相當(dāng)于一個(gè)倉(cāng)庫(kù),用來放置你的代碼文件。首先,登陸進(jìn)入Github,并進(jìn)入個(gè)人頁(yè)面,選擇repositories(下圖第一個(gè)紅圈的地方),然后New一個(gè)repository(下圖第二個(gè)紅圈的地方)


創(chuàng)建時(shí),只需要填寫Repository name即可,當(dāng)然這個(gè)名字的格式必須為youname.github.io,例如我的為tengj.github.io,這里建議用你github的用戶名作為Repository name,這樣可以省下很多的麻煩,強(qiáng)烈建議。

部署本地文件到github


既然Repository已經(jīng)創(chuàng)建了,當(dāng)然是先把博客放到Github上去看看效果。編輯E:\hexo下的_config.yml文件,建議使用Notepad++。
在_config.yml最下方,添加如下配置(命令中的第一個(gè)tengj為Github的用戶名,第二個(gè)tengj為之前New的Repository的名字,記得改成自己的。另外記得一點(diǎn),hexo的配置文件中任何’:’后面都是帶一個(gè)空格的),如果配置以下命令出現(xiàn)ERROR Deployer not found : github,則參考上文的解決方法

deploy:
  type: git
  repo:
      github: git@github.com:tengj/tengj.github.io.git,master

配置_config.yml并保存。如果你是第一次使用Github或者是已經(jīng)使用過,但沒有配置過SSH,則可能需要配置一下:
在Git Bash輸入以下指令(任意位置點(diǎn)擊鼠標(biāo)右鍵),檢查是否已經(jīng)存在了SSH keys。

ls -al ~/.ssh

如果不存在就沒有關(guān)系,如果存在的話,直接刪除.ssh文件夾里面所有文件:



輸入以下指令(郵箱就是你注冊(cè)Github時(shí)候的郵箱)后,回車,出現(xiàn)提示讓你輸入的時(shí)候直接先回車,好像需要3次,如下圖所示:

ssh-keygen -t rsa -C "358593266@qq.com"

然后鍵入以下指令:

ssh-agent -s

繼續(xù)輸入指令:

ssh-add ~/.ssh/id_rsa

輸入之后,在我這里是出錯(cuò)了,不知道你的有沒有出錯(cuò)。



如果你的也是這樣子出錯(cuò)了的話,就輸入以下指令:

eval `ssh-agent -s`
ssh-add

到了這一步,就可以添加SSH key到你的Github賬戶了。鍵入以下指令,拷貝Key(先拷貝了,等一下可以直接粘貼,不放心的在執(zhí)行下面命令后,先黏貼在記事本上):

clip < ~/.ssh/id_rsa.pub

然后到Github里面,點(diǎn)擊右上角的設(shè)置圖標(biāo)Settings,找到SSH keys,Ttile隨便你命名,Key就黏貼上你剛才復(fù)制的key,然后點(diǎn)Add SSH key,最后會(huì)讓你重新輸入下gitHub的密碼




最后還是測(cè)試一下吧,鍵入以下命令:

ssh -T git@github.com

你可能會(huì)看到有警告,沒事,輸入“yes”就好



以上就表示SSH配置好了,執(zhí)行以下命令部署到Github上。

hexo g
hexo d

如果執(zhí)行hexo d命令報(bào)下名錯(cuò):



就先安裝一下hexo-deployer-git這個(gè)模塊:

npm install hexo-deployer-git --save

安裝好了繼續(xù)執(zhí)行hexo d部署命令,輸入gitHub的賬號(hào)密碼,就可以訪問了。我的是: tengj.github.io

發(fā)表一篇文章


  • 在Git Bash執(zhí)行命令:
hexo new "my new post"
  • 在E:\hexo\source_post中打開my-new-post.md,打開方式使用記事本或者其他文本工具。
    hexo中寫文章使用的是Markdown,這里推薦使用markdownpad這個(gè)工具。 Markdown編寫語(yǔ)法自己百度一下,不難
  title: my new post #可以改成中文的,如“新文章”
  date: 2016-02-21 16:04:09 #發(fā)表日期,一般不改動(dòng)
  categories: blog #文章文類
  tags: [文章] #文章標(biāo)簽,多于一項(xiàng)時(shí)用這種格式,只有一項(xiàng)時(shí)使用tags: blog
  --
  這里是正文,用markdown寫,你可以選擇寫一段顯示在首頁(yè)的簡(jiǎn)介后,加上
  <!--more-->,在<!--more-->之前的內(nèi)容會(huì)顯示在首頁(yè),之后的內(nèi)容會(huì)被隱藏,當(dāng)游客點(diǎn)擊Read more    才能看到。

寫完文章后,你可以使用1.$ hexo g生成靜態(tài)文件。2.$ hexo s在本地預(yù)覽效果。3.hexo d同步到github,然后使用http://tengj.github.io 進(jìn)行訪問。

參考


使用Hexo搭建個(gè)人博客(基于hexo3.0)
HEXO+Github,搭建屬于自己的博客
史上最詳細(xì)“截圖”搭建Hexo博客并部署到Github

總結(jié)

到這里,就算初步搭好了一個(gè)屬于自己的獨(dú)立博客,后續(xù)就是本地寫文章然后部署最后發(fā)布就行。當(dāng)然這只是最基本的流程,hexo提供了許多好看的主題,我準(zhǔn)備下篇里面詳細(xì)介紹下主題的下載以及配置。讓你的博客更加的酷炫!
大家按照我這個(gè)整理的教程搭建,理論上都能搭建成功。如果過程中發(fā)現(xiàn)一些問題,也可以留言我們一起探討。祝大家一次就能搭建屬于自己的獨(dú)立博客~撒花

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

相關(guān)閱讀更多精彩內(nèi)容

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