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

前言

一直想要一個自己的獨立博客,但是覺得申請域名+服務器的太麻煩了就一直沒有實現。偶然機會發現Hexo這個優秀的靜態博客框架,再搭配現在流行的gitHub,簡直是完美寫博客的黃金搭檔(免費+方便)。于是就上網參考了好多教程最后磕磕碰碰的搭建了起來。但是網上的教程多多少少都有點問題,可能比較早吧。就有了這個自己總結的教程,一是自己總結一下。二是給也想搭建Hexo博客的童鞋們多一點參考。

正文

我這個教程是基于window系統用戶,Hexo3版本

安裝前提軟件

Node.js:
作用:node.js用來創建hexo博客框架的,我當前安裝版本為:node-v5.6.0-x64

Git客戶端:
作用:把本地的hexo內容提交到github上去,我當前安裝的是Git-2.7.0-64-bit

安裝Hexo

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

hexo g #完整命令為hexo generate,用于生成靜態文件
hexo s #完整命令為hexo server,用于啟動服務器,主要用來本地預覽
hexo d #完整命令為hexo deploy,用于將本地文件發布到github上
hexo n #完整命令為hexo new,用于新建一篇文章

利用 npm 命令即可安裝。在任意位置點擊鼠標右鍵,選擇Git Base

hexo1.jpg
hexo1.jpg

輸入安裝hexo命令:

npm install -g 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帳號

已經有Github帳號跳過此步,首先進入Github進行注冊,用戶名、郵箱和密碼之后都需要用到,自己記好。

創建repository

repository相當于一個倉庫,用來放置你的代碼文件。首先,登陸進入Github,并進入個人頁面,選擇repositories(下圖第一個紅圈的地方),然后New一個repository(下圖第二個紅圈的地方)

hexo2.jpg
hexo2.jpg

創建時,只需要填寫Repository name即可,當然這個名字的格式必須為youname.github.io,例如我的為tengj.github.io

hexo3.png
hexo3.png

部署本地文件到github

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

deploy: 
    type: git
    repository: https://github.com/tengj/tengj.github.io.git
    branch: master

配置_config.yml并保存。如果你是第一次使用Github或者是已經使用過,但沒有配置過SSH,則可能需要配置一下:

在Git Bash輸入以下指令(任意位置點擊鼠標右鍵),檢查是否已經存在了SSH keys。

ls -al ~/.ssh

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

hexo4.png
hexo4.png

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

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

然后鍵入以下指令:

ssh-agent -s
hexo1_6.png
hexo1_6.png

繼續輸入指令:

ssh-add ~/.ssh/id_rsa

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

hexo1_7.png
hexo1_7.png

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

eval `ssh-agent -s`
ssh-add
hexo1_8.png
hexo1_8.png

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

clip < ~/.ssh/id_rsa.pub

然后到Github里面,點擊右上角的設置圖標Settings,找到SSH keys,Ttile隨便你命名,Key就黏貼上你剛才復制的key,然后點Add SSH key,最后會讓你重新輸入下gitHub的密碼

hexo1_9.png
hexo1_9.png

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

ssh -T git@github.com

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

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

hexo g
hexo d

如果執行hexo d命令報下名錯:

就先安裝一下hexo-deployer-git這個模塊:

npm install hexo-deployer-git --save

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

發表一篇文章

1.在Git Bash執行命令:

hexo new "my new post"

2.在E:\hexo\source_post中打開my-new-post.md,打開方式使用記事本或者其他文本工具。
hexo中寫文章使用的是Markdown,這里推薦使用markdownpad這個工具。 Markdown編寫語法自己百度一下,不難

title: my new post         #可以改成中文的,如“新文章”
date: 2016-02-21 16:04:09      #發表日期,一般不改動
categories: blog            #文章文類
tags: [文章]                    #文章標簽,多于一項時用這種格式,只有一項時使用tags: blog
---
#這里是正文,用markdown寫,你可以選擇寫一段顯示在首頁的簡介后,加上
<!--more-->,在<!--more-->之前的內容會顯示在首頁,之后的內容會被隱藏,當游客點擊Read more才能看到。

寫完文章后,你可以使用

$ hexo g  生成靜態文件
$ hexo s  在本地預覽效果
$ hexo d  同步到github

然后使用http://lyqblue.github.io 進行訪問。

總結

到這里,就算初步搭好了一個屬于自己的獨立博客,后續就是本地寫文章然后部署最后發布就行。當然這只是最基本的流程,hexo提供了許多好看的主題,我準備下篇里面詳細介紹下主題的下載以及配置。讓你的博客更加的酷炫!

大家按照我這個整理的教程搭建,理論上都能搭建成功。如果過程中發現一些問題,也可以留言我們一起探討。祝大家一次就能搭建屬于自己的獨立博客~撒花

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容