hexo 和 Github 搭建個人博客記錄

所需準備

創(chuàng)建Github個人倉庫

注冊Github賬號,并點擊Github中New repository建立新倉庫,倉庫名為: 用戶名.github.io

安裝并配置Git

在Git官網(wǎng)下載安裝包,安裝后在命令行下輸入git檢測是否安裝成功。

打開Git Bash, 輸入以下命令配置用戶名和郵箱信息


git config --global user.name "Github用戶名"

git config --global user.email "Github注冊郵箱"

生成ssh密鑰文件


ssh-keygen -t rsa -C "Github注冊郵箱"

然后其他選項默認。

設置Github中的密鑰,和電腦上的密鑰配對,即可在電腦上使用Git管理Github.

  1. 打開Github_setting_key頁面,新建 new SSH Key

  2. Title任意, 將密鑰從C:\\users\"your name"\.ssh\id_rsa.pub中復制過來, 點擊Add SSH Key

  3. 在Git bash中輸入ssh git@github.com 檢測是否設置成功

安裝Node.js

直接下載Node.js for windows, 并在安裝時注意將環(huán)境變量和npm裝上.

檢測是否安裝成功, 在命令行輸入node -v以及npm -v即可

安裝hexo

任意位置新建一個名為Blog的文件夾(可以是其他任意的英文), hexo框架以及之后發(fā)布的網(wǎng)頁都將安裝到這個文件夾中。

進入Blog文件夾,啟動命令行,用npm安裝hexo


npm install -g hexo-cli

安裝好后初始化


hexo init blog

隨后即可用hexo的各項命令制作靜態(tài)網(wǎng)頁了.

發(fā)布網(wǎng)站

在blog根目錄中_config.yml文件里修改


deploy:

type: git

repo: 倉庫的完整路徑.git

branch: master

最后在Git中安裝部署插件, 輸入命令


npm install hexo-deployer-git --save

即可使用命令hexo d來發(fā)布網(wǎng)站了。

綁定個人域名

可在域名提供商處購買域名,在國內(nèi)用DNSpod解析。

先在source\post\文件夾下新建文件CNAME,文件名一定要大寫,沒有后綴名. 用編輯器打開該文件后輸入剛申請的域名YourDomain.com.

在DNSpod的操作頁面中添加兩條域名解析記錄


@    CNAME    YourUserID.github.io

www  CNAME    YourUserID.github.io

等候10分鐘,即可用域名YourDomain.com打開個人博客.

一些小問題

不能生成categories和tags

需要用命令hexo new page categories來生成categories頁面.

Hexo 將MathJax中的某些命令渲染錯誤

解決方法是換一個Hexo的引擎, 使用以下命令


npm uninstall hexo-renderer-marked --save

npm install hexo-renderer-pandoc --save

注意,前提是電腦中安裝了Pandoc

中英文之間需要手動打空格

可以用Next的名為pandu的插件自動生成空格,具體使用方法參見pangu_github

如何引用站內(nèi)的博文

可以用hexo3.0引入的Render Pipeline Changed特性在所要引用的地方,輸入以下代碼


{% post_path hello-world %}

// /2015/01/16/hello-world/

{% post_link hello-world %}

// <a href="/2015/01/16/hello-world/">Hello World</a>

{% post_link hello-world Custom Title %}

// <a href="/2015/01/16/hello-world/">Custom Title</a>

{% asset_path example.jpg %}

// /2015/01/16/hello-world/example.jpg

{% asset_link example.jpg %}

// <a href="/2015/01/16/hello-world/example.jpg">example.jpg</a>

{% asset_link example.jpg Example %}

// <a href="/2015/01/16/hello-world/example.jpg">Example</a>

{% asset_img slug %}

// <img src="/2015/01/16/hello-world/example.jpg">

注意引用博文時,若博文的標題中有自動生成的時間,則只需要將hello-world換成博文的title即可,不需要加時間.

創(chuàng)建about頁面

新建一個 about 頁面:


hexo new page "about"

菜單顯示 about 鏈接,在主題的 _configy.yml 設置中將 menuabout 前面的注釋去掉即可。


menu:

  home: /

  archives: /archives

  tags: /tags

  about: /about

用Busuanzi統(tǒng)計訪問量

注意在Next 5.01以上版本中已經(jīng)內(nèi)置有Busuanzi,只需在主題配置文件打開即可。 參看說明

在主題的themes\next\layout\_partial\footer.swig中添加如下代碼


{% if theme.footer.busuanzi.enable %}

  <script async src="http://dn-lbstatics.qbox.me/busuanzi/2.3/busuanzi.pure.mini.js">

</script>

{% endif %}

添加后Busuanzi就可以統(tǒng)計網(wǎng)站流量了.

在網(wǎng)站主頁顯示訪問人數(shù),同樣在剛才的文件中添加如下代碼


{% if theme.footer.busuanzi.enable %}

<span id="busuanzi_container_site_uv">

  曾有<span id="busuanzi_value_site_uv"></span>人大駕光臨

</span>

{% endif %}

這段代碼按pv方式統(tǒng)計,每一次點擊都算一次訪問.若按uv方式統(tǒng)計,即一個用戶不管多少次點擊都算一次訪問,將代碼中pv改成uv即可.

最后若想激活效果,在themes\next\_config.ymlfooter字段中添加代碼


busuanzi:

    # busuanzi analysis

    enable: true

文章字數(shù)統(tǒng)計

使用插件hexo-symbols-count-time來統(tǒng)計文章字數(shù),參見文檔

首先安裝插件


npm install hexo-symbols-count-time --save

隨后在Hexokinase配置文件中添加字段


symbols_count_time:

  symbols: true

  time: true

  total_symbols: true

  total_time: true

最后在NexT主題的配置文件中找到配置


symbols_count_time:

  separated_meta: true

  item_text_post: true

  item_text_total: false

  awl: 4

  wpm: 275

配置好即可.

如何讓Google和Baidu可以搜索到網(wǎng)站

可以參見教程

解決FontAwesome訪問太慢的問題

可以用國內(nèi)的CDN

在Next的Config文件中找到fontawesome:一欄,然后將對應的版本替換就好.

注意,上述的CDN替換可能導致加載圖片出錯的問題。

使用MathJax時,如何讓長公式自動斷行?

themes\next\layout\_third-party\math\mathjax.swig 文件中添加如下代碼


<script type="text/x-mathjax-config">

  MathJax.Hub.Config({

    CommonHTML: { linebreaks: { automatic: true } },

    "HTML-CSS": { linebreaks: { automatic: true } },

    SVG: { linebreaks: { automatic: true } }

  });

</script>

具體參見官方文檔

Hexo s 的妙用

在調(diào)整hexo網(wǎng)站時,可以在終端運行hexo s命令。此時hexo會自動將你所作的更改顯示到http://localhost:4000/之上,省卻了重復生成并部署網(wǎng)站的操作.

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

推薦閱讀更多精彩內(nèi)容