如何使用hexo搭建個人博客

經(jīng)過各種找資料,踩過何種坑,終于搭建好了 hexo,域名目前用得時 github 的,我的 hexo3.2.2 版本,hexo 不同的版本,很多配置都不一樣。好吧,廢話不多說了,開始吧。

之前是想著寫博客,一方面是給自己做筆記,可以提升自己的寫作、總結能力,一個技術點我們會使用,并不難,但是要做到讓讓別人也能聽懂我們講得,還是需要一定的技巧和經(jīng)驗的。很多類似于 CSDN、博客園也都可以寫文章,但是頁面的樣式我不是太喜歡,簡書還算好點得。最近看到一些大神們的博客,貌似都是用 hexo 寫得,我也依葫蘆畫瓢的搭建了一個。不羅嗦了,直接上搭建步驟。

簡介

hexo是一個npm包,在node環(huán)境上運行,功能就是將你的文章(.md文件)生成為靜態(tài)html文件。

基礎準備

下面正式開始搭建博客!首先要想使用 Hexogithub pages 搭建博客,需要以下環(huán)境:

  • github 上注冊一個賬號,并創(chuàng)建一個指定名字的 reposity
  • homebrew 套件管理器,主要用來安裝 gitnode.js
  • git 版本管理工具
  • node.js
  • 配置 SSH key
  • 安裝 hexo
  • 同步 hexo 博客到 github
注冊Github賬號并創(chuàng)建reposity

申請完賬號,登陸之后,就可以創(chuàng)建 reposity 了,點擊 New repository
,會跳轉到這個界面:

Paste_Image.png
安裝brewhome
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)”

安裝失敗, 執(zhí)行以下腳本卸載:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)" 
報錯:Failed to locate Homebrew!

執(zhí)行以下:

sudo rm -rf /usr/local/.git rm -rf Library .git .gitignore bin/brew README.md share/man/man1/brew rm -rf ~/Library/Caches/Homebrew

成功后,再次執(zhí)行,下載腳本:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

下載成功

安裝git版本管理工具

git 是一個強大的版本管理工具,github 的版本管理就是基于 git 的,現(xiàn)在 svn 基本過時了,使用 Git 進行版本管理才是王道。安裝完 homebrew 之后,安裝 Git 幾乎零成本,還是在 terminal 終端,輸入以下命令:

brew install git

然后等一段時間就 ok 了,homebrew 會自動去幫你完成下載安裝。

安裝node.js

hexo 是基于 node.js 的,所以要讓 hexo 運行,node.js 環(huán)境是必不可少的。使用 homebrew 安裝 node.js 也特別簡單,在 terminal 終端輸入如下命令:

brew install node

ps:安裝最新版的 Node.js 之后,我們就可以使用 npm 命令,在 mac 下遇到 npm 命令找不到的問題,解決方案如下:

sudo ln -s /usr/local/bin/node /usr/bin/node
sudo ln -s /usr/local/lib/node /usr/lib/node
sudo ln -s /usr/local/bin/npm /usr/bin/npm
sudo ln -s /usr/local/bin/node-waf /usr/bin/node-waf
安裝hexo

前面我們安裝了 node.js,裝完 node.js 之后,我們就可以使用 npm 命令了,而 hexo 安裝就是使用 npm,在終端輸入以下命令:

npm install -g hexo

ps:等待一會兒,hexo 會自動完成下載安裝。等 hexo 安裝完成之后,在創(chuàng)建一個文件夾,這個文件夾以后就是你存放本地博客的地方了。

搭建hexo博客

創(chuàng)建新建一個文件夾,用來存放本地博客。

hexo init
npm install

hexo會在創(chuàng)建的文件夾創(chuàng)建本地博客所需的一切資源。

hexo server

訪問本地localhost:4000可以看到博客已經(jīng)搭建成功。

同步hexo博客到github

  • 配置本地和githubssh
  • github上創(chuàng)建名字為XXX.github.io的項目,XXX為自己的github用戶名。
  • 開本地的創(chuàng)建的文件夾中的_config.yml配置文件,將其中的type設置為git
檢查你電腦上現(xiàn)有的ssh key
cd ~/.ssh   # 切換到ssh目錄
ls -al ~/.ssh # 查看

注意:
如果你本地沒有生成的話,終端上面會顯示,No such file or directory。說明你是第一次使用git,如果已經(jīng)存在的話,則會顯示id_rsaid_rsa.pub

獲取ssh
ssh-keygen -t rsa -C "your.email@example.com" -b 4096
配置github的ssh

登陸github后,點擊右上角自己的頭像–>點擊Your profile–>點擊你的博客遠程倉庫,頁面中就能找到ssh。

安裝自動部署發(fā)布工具

這里用到了 hexo-deployer-git,使用如下命令安裝:

npm install hexo-deployer-git --save

配置hexo

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/sunjinshuai/sunjinshuai.github.com
branch: master

在terminal終端,執(zhí)行以下命令:

hexo generate   // 可以簡寫成hexo g 根據(jù)markdown文件生成靜態(tài)文件
hexo deploy     // 或者簡寫成hexo d 將本地修改,部署到遠端

此時,打開瀏覽器,訪問https://sunjinshuai.github.io ,就可以看到你的博客。

Hexo安裝新主題apollo

Hexo換皮膚還是比較簡單的,既可以自己根據(jù)默認的主題來修改,也可以到https://hexo.io/themes/ 上去找主題。

安裝

github上的文檔給出了詳細的安裝命令:

hexo init #blogname#
cd #blogname#
npm install
npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive
git clone https://github.com/pinggod/hexo-theme-apollo.git themes/apollo
啟用

安裝成功后就可以開始啟用主題,主題的啟用需要修改_config.yml 的 theme 配置項為 apollo:

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: apollo

# 在歸檔頁面顯示所有文章
# 需要上面安裝的 hexo-generator-archive 插件支持
archive_generator:
per_page: 0
yearly: false
monthly: false
daily: false

hexo常用的命令

hexo init       //在指定目錄執(zhí)行該命令,會將當前目錄初始化為hexo站點,生成hexo站點所需的一切文件
hexo new “my new blog title”   //新建一篇文章。如果沒有設置 layout 的話,默認使用 _config.yml 中的 default_layout 參數(shù)代替。如果標題包含空格的話,請使用引號括起來。
hexo clean      // 清除緩存,如果對本地文件做了修改,同步到遠程驗證修改的效果之前,先clean,清除緩存
hexo generate   // 可以簡寫成hexo g 根據(jù)markdown文件生成靜態(tài)文件
hexo server     // 或者簡寫成hexo s 啟動本地hexo 服務器,默認localhost:4000可以訪問
hexo deploy     // 或者簡寫成hexo d 將本地修改,部署到遠端
hexo version    // 顯示hexo版本

關于HEXO安裝失敗的解決方法

目前國內npm源有問題;所以鍵入如下代碼即可安裝成功:

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

推薦閱讀更多精彩內容