Hexo next主題搭建靜態博客埋坑記錄

一直想着在github上建一個自己的博客網站,剛好這個週末有空就開始實施了,經過兩天努力博客終於是建好了,也達到了想要的效果,但是其中一系列的坑讓人不舒服,爲此專門記錄下來給那些需要的人一些參考。

首先關於如何建站參考以下幾篇文章:
1、手把手教你建github技術博客
2、如何在 GitHub 上寫博客?
3、手把手教你用Hexo+Github 搭建屬於自己的博客

1、文章左側的目錄如何弄出來

如圖文章左側的目錄是如何弄出來的:
1、首先在你的markdown文件裏面要有標題,所謂標題就是例如這種一級標題(#),二級標題(##),三級標題(###)的。
2、在主題的_config文件裏面,將toc的enable設置爲true就ok了,默認的目錄是有序號的,如果你不想要序號,你需要把number置爲false
文章目錄圖

2、hexo生成博文插入圖片顯示不出來

顯示圖片是一個大坑,步驟如下:
1、把主頁配置文件_config.yml 裏的post_asset_folder:這個選項設置爲true
2、在你的hexo目錄下執行這樣一句話npm install hexo-asset-image –save,這是下載安裝一個可以上傳本地圖片的插件
3、等待一小段時間後,再運行hexo n “xxxx”來生成md博文時,/source/_posts文件夾內除了xxxx.md文件還有一個同名的文件夾
4、最後在xxxx.md中想引入圖片時,先把圖片複製到xxxx這個文件夾中,然後只需要在xxxx.md中按照markdown的格式引入圖片:![你想輸入的替代文字](xxxx/圖片名.jpg)
5、最後檢查一下,hexo g生成頁面後,進入public\2017\09\10\index.html文件中查看相關字段,可以發現,html標籤內的語句是<img src="2017/09/10/xxxx/圖片名.jpg">,而不是<img src="xxxx/圖片名.jpg>。這很重要,關乎你的網頁是否可以真正加載你想插入的圖片。

3、文字顯示成了德文

在根目錄下的_config文件裏面,默認語言是空的,本以爲默認會顯示英文。但是經過hexo g ,hexo d 後,生成的本地網頁上有時候顯示的是德文(剛開始還以爲是亂碼),有時候顯示的是卻是英文,這就很蛋疼,顯示英文很好理解,因爲國際語言就是英語,但是顯示德文就有點坑了,後來才發現,在next主題的語言包文件夾下德語的配置文件de.yml是排在第一位的,估計是這原因導致它顯示德語,所以最好的辦法就是明確指出語言爲英語或者漢語,不要默認讓它空着。

title: Charles
subtitle: 有人說我是假程序員
description:
author: Charles
language: en
timezone:

4、hexo中next主題代碼高亮無法正常顯示

我們知道在markdown裏面代碼塊使用兩個反三點包起來的,一般的md編譯器都會顯示高亮的,但是在next主題裏面就不會,解決辦法就是在第一個反三點的右邊加上你所用的語言,例如java,C++,jsx等等
代碼高亮

5、部署代碼到github上時提示 deloyer not found:git

解決辦法:
注意需要提前安裝一個擴展:
npm install hexo-deployer-git –save

6、每次deploy都要配置域名

因爲我配置的自己的域名,所以在我的github庫裏面有一個CNAME文件,如下圖所示:
域名文件github位置
但是我每次執行hexo deploy之後,CNAME文件都沒有了,搞得每次都要去Settings—>GitHub Pages—>Custom domain下面去重新配置域名,解決辦法爲,將你的CNAME文件放到本地的source文件夾下,如下圖:
域名文件本地位置

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章