使用hexo搭建github博客

hexo搭建

主要參考文章

1、準備工作
  • 首先打開github,點擊New repository,創(chuàng)建一個新倉庫,倉庫名必須要遵守格式:賬戶名.github.io,不然接下來會有很多麻煩。并且需要勾選Initialize this repository with a README。如下圖所示


    創(chuàng)建倉庫

在建好的倉庫右側(cè)有個settings按鈕,點擊它,向下拉到GitHub Pages,你會看到有個網(wǎng)址,訪問它,你將會驚奇的發(fā)現(xiàn)該項目已經(jīng)被部署到網(wǎng)絡(luò)上,能夠通過外網(wǎng)來訪問它,當然里面還很空什么東西都沒有。 該地址就是你的博客默認地址,你也可以購買域名,將其換成你喜歡的地址。


  • 確保你的電腦上已經(jīng)安裝好了git和Node.js。可以通過下圖中的命令查看


    查看
2、安裝hexo

1.在自己認為電腦合適的地方創(chuàng)個文件夾,我是在文檔中建了一個blog文件夾。



然后用命令行進入到該文件夾

$ cd /Users/你的用戶名/Documents/blog

輸入npm install hexo -g,開始安裝Hexo

$ npm install hexo -g

輸入hexo -v,檢查hexo是否安裝成功

$ hexo -v

輸入hexo init,初始化該文件夾(有點漫長的等待。。。)

$ hexo init

看到后面的“Start blogging with Hexo!”就說明初始化好了

輸入npm install,安裝所需要的組件

$ npm install

安裝好后,執(zhí)行以下命令

$ hexo g #generate 生成靜態(tài)文件
$ hexo s #server 啟動服務(wù)器。默認情況下,訪問網(wǎng)址為: [http://localhost:4000/](https://link.jianshu.com/?t=http://localhost:4000/)

打開http://localhost:4000,頁面如下圖

默認頁面

連接hexo和git

設(shè)置你的用戶名稱與郵件地址,如果是第一次使用git的話

$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com

使用ssh-keygen生成私鑰和公鑰
命令如下:

$ ssh-keygen -t rsa
生成秘鑰

登錄Github,點擊頭像下的settings,添加ssh,新建一個new ssh key,將id_rsa.pub文件里的內(nèi)容復(fù)制上去。

輸入ssh -T git@github.com,測試添加ssh是否成功。如果看到Hi后面是你的用戶名,就說明成功了

$ ssh -T git@github.com

配置Deployment,在其文件夾中,找到_config.yml文件,修改repo值(在末尾),repo值是github項目里的ssh。


HexoBlog部署到git我們需要安裝hexo-deployer-git插件,在blog目錄下運行一下命令進行安裝

$ npm install hexo-deployer-git --save

我們來試著創(chuàng)建一篇文章,使用

$ hexo new [layout] <title> #新建文章
<!--例如-->
$ hexo new post hello,hexo

之后會在source文件夾的_post文件夾中看到你新建的文件。

使用編輯器編好文章,接著就可以使用命令:

$ hexo d -g

生成以及部署了。在打開你的博客主頁就可以看到你創(chuàng)建的文章了。

問題及解決
在修改根目錄下_config.yml文件后,需要使用$ hexo deploy部署一下,否則不生效。

如果還不生效
hexo clean命令
再執(zhí)行hexo g -d命令

常用命令及更換next主題
  • Hexo的命令極簡單,安裝后只需要記住四個常用的基礎(chǔ)命令即可。執(zhí)行命令需要Git當前處于blog文件夾根目下。

hexo g #generate 生成靜態(tài)文件
hexo s #server 啟動服務(wù)器。在本地預(yù)覽效果,默認情況下,訪問網(wǎng)址為: http://localhost:4000/
hexo d #deploy 部署網(wǎng)站同步到github。部署網(wǎng)站前,需要預(yù)先生成靜態(tài)文件
hexo clean #clean 清除緩存文件 (db.json) 和已生成的靜態(tài)文件 (public)。

  • 最核心的寫作相關(guān)

  • 寫文章
    你可以執(zhí)行下列命令來創(chuàng)建一篇新文章。

hexo new [layout] <title> #新建文章

您可以在命令中指定文章的布局(layout),默認為 post,可以通過修改 _config.yml 中的 default_layout 參數(shù)來指定默認布局(在后文的配置中會提到具體修改參數(shù)),這樣所有的文章都會以md形式保存在source文件夾的_post文件夾中,只要在_post文件夾中新建md類型的文檔,就能在執(zhí)行hexo g的時候被渲染。

  • 刪除文章
    刪除那篇文章,然后重新運行

hexo clean
hexo g -d

更換主題方法參考文章,主要是下載相關(guān)主題,然后在根目錄下的_config.yml文件, 找到 theme字段,并將其值更改為 對應(yīng)主題名

hexo高級配置

修改過主題之后,還可以進行更深一步是設(shè)置比如添加分類、標簽、評論功能等等??梢宰孕兴阉?,都比較簡單。
我在設(shè)置時,參考文章的地址1-主要是主題風格挑選地址2-干貨多

Front-matter 設(shè)置

文章的 Front-matter 設(shè)置,在創(chuàng)建的文件中---中區(qū)域叫Front-matter ,用于指定個別文件的變量

---
title: title #文章標題
date: 2016-06-01 23:47:44 #文章生成時間
categories: "Hexo教程" #文章分類目錄 可以省略
tags: #文章標籤 可以省略
     - 標簽1
     - 標簽2
 description: #你對本頁的描述 可以省略
---

最后附上hexo官方文檔英文文檔、中文文檔。

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

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

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