hexo+github搭建博客心歷路程

前言

今天突然回想起來以前在GitHub上創建的一個倉庫,本來是想着以後寫博客的時候都把數據同步上去,但是,今天嘗試了一次,發現步驟稍顯複雜,
1. 我先把項目clone到了本地
2. 創建了一個新的文件夾,在新的文件夾中,我新建了一個HTML文件
3. 修改了項目中的index.html文件,新建一個a標籤,地址鏈接到該目錄下新建文件夾中的html文件上。
4. 運行,發現一堆亂碼(原來,我使用的是markdown語法,然後寫在了html文件中。。實力腦殘了一波。。)
5. 因此,我就修改了index.html中a標籤鏈接的地址(本來爲xxx.html,然後改成了xxx.md)
6. 然後,還是一堆亂碼(等我測試瞭解了一圈之後,重新刷新,其實已經可以看見markdown語法已經有點效果了,但是,還是顯示的不太好。)

這裏寫圖片描述

對策
然後,我在網上找了一些方法,可以直接在同一時間上傳內容,然後修改首頁index上的索引。也就是那種用戶可以專注於寫博客,不用再費心於首頁的樣式,GitHub上傳同步上的問題了
想想是不是很開心呢?

這麼以來,

大致來說,就有兩種方法實現:

jekyll+Github
Hexo+Github

那麼這兩種都有什麼特點呢?
1. Jekyll
採用ruby實現,所以速度上沒有JS快
可以直接使用markdown來編輯文本,
但是據說不支持本地預覽(據說,是據說各位。。放下手中的西瓜刀)

  1. Hexo
    採用Javascript實現,
    可以直接使用markdown來編輯文本,
    配置到GitHub之前,可以先在本地預覽

安裝方面來說:其實我感覺對於Mac用戶來說,幾乎都是一樣的,
Mac自帶的有ruby,所以jekyll可以直接安裝。
而Hexo的話,用戶需要先自己安裝Node.js, 對用我這個安裝的有brew的人來說,一行代碼的事情:brew install node

另外一點,hexo對多平臺多設備支持的沒有jekyll好,至於解決方法,我後文再說吧

網上很多人糾結於這兩個的選擇,我感覺,還是仁者見仁智者見智吧!
這裏有一個各種靜態網頁生成器的比較

本文采用的是Hexo來配置的。

安裝步驟

前提:
1. Hexo官網Github
2. Git -> 電腦安裝xcode
3. Github客戶端 -> brew cask install github-desktop
4. Node.js -> brew install node
5. 如果以上都做過了,燃石在執行安裝hexo過程中會報錯:Failed at the [email protected] build:highlight script,那麼還是老老實實去Node.js官網手動下載安裝node.js吧

然後,開始!!

安裝Hexo
  1. 首先安裝hexo

    sudo npm install -g hexo

  2. 然後新建一個文件夾,用來存放以後的博客,當做博客的根目錄。這裏默認爲桌面mkdir Blog

  3. cdBlog文件夾,然後使用hexo init來初始化
  4. 初始化完成之後,這個時候其實就已經創建好index.html文件了,此時我們hexo g (hexo generate)來生成靜態頁面。
  5. hexo s (hexo server)來本地查看頁面。
    如果成功你會看到一個靜態的你的主頁。
    當然,也會失敗,我看別人的,是會有失敗的情況的, 那麼,hexo clean來清理下緩存,重新試下。
新建Github頁面

這個應該不用多說:
1. 登錄Github網址,然後登陸,new repository新建倉庫
2. 項目命名爲你github暱稱+balabala.github.io(最好以.io結尾)
3. 然後創建,點擊當前倉庫的setting選項,拉到倒數第二欄Github Pages,修改source欄爲master branch, 生成網頁
然後你會在倒數第二欄的上端看到你的博客的地址,記下來!!後面要用到的!!!

關聯GitHub,基礎Hexo配置

此時我們在~/xx/Desktop/Blog/目錄下,然後我們打開該目錄下的_config.yml文件進行編輯
翻到最下邊,然後改成如下

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: https://github.com/WooNoah/woodicsdn.github.io.git  ###這裏填寫上面看到的網址.git
  branch: master

注意:
hexo在以前的2.x的版本的時候,type欄寫的是github, 升級成3.0版本之後,如果繼續寫type爲github,那麼會報錯找不到github,因此需要先安裝hexo-deployer-git(vim指令爲:npm install hexo-deployer-git --save),然後將github修改爲git

然後配置博客相關的信息:
_config.yml上面:

# Site
title: Woooodi's Private Zone  ##這個是博客的title
subtitle:
description:
author: Woo Di                 ##你的名字
language: zh-Hans              ##語言
timezone:                      ##時區

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: https://woonoah.github.io/woodicsdn.github.io       ###這裏!!!非!常!重!要!! 寫上你博客的地址,也就是上面setting欄中,讓你記住的那個地址
root: /woodicsdn.github.io                               ###像上面說的,如果你的地址是在子文件夾中,那麼root設置下
permalink: :year/:month/:day/:title/
permalink_defaults:

當然,更詳細的參數配置都可以在hexo官網上找到

當然,肯定有人是奔着Hexo好看的主題來的,所以,肯定會有人來問,哪裏換主題?
首先,給大家一個hexo主題選擇的網址,大家各選其好,選一個出來,我使用的是一個名叫next的主題
下載之:
還是cd到Blog根目錄,
git clone https://github.com/iissnan/hexo-theme-next themes/next
然後,你就會看到一個theme文件夾,裏邊放着一個next主題文件

仍然是_config.yml中,拉到最下邊:

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next    ###這裏,可以選擇你想要換的主題名稱。

當然, 在next文件夾中,也有一個_config.yml文件,我們叫他主題配置文件,而根目錄的那個,我們可以叫hexo配置文件
大家不要搞混了

然後,大家就可以按照上面的步驟,修改完畢,

    hexo clean  #先清理,防止有緩存
    hexo g
    hexo s

我們應該就能看到理想的主題了。

如果沒有問題,我們就可以使用新的指令
hexo deploy來把本地配置部署到GitHub上了。

筆者,因爲沒有配置上面url部分,導致多調試了1天
PS,如果不配置上面的URL
則會顯示如下
這裏寫圖片描述

另外,
Next模板,存在3中主題組合,

Muse        默認就是這個 
Mist    
Pisces      

只有Pisces支持
sideBar在左邊

一些基本路徑

 文章在 source/_posts,編輯器可以用 Sublime,支持 markdown 語法。如果想修改頭像可以直接在主題的 _config.yml 文件裏面修改,友情鏈接,之類的都在這裏,修改名字在 public/index.html 裏修改,開始打理你的博客吧,有什麼問題或者建議,都可以提出來,我會繼續完善。

常用的指令

hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成靜態頁面至public目錄
hexo server #開啓預覽訪問端口(默認端口4000,'ctrl + c'關閉server)
hexo deploy #將.deploy目錄部署到GitHub
hexo help  #查看幫助
hexo version  #查看Hexo的版本
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章