Below you will find pages that utilize the taxonomy term “Hexo”
Posts
Termux - Setup Hexo blog
在 Termux 使用 Hexo 並沒什麼特別之處。
一樣是要先將 Hexo CLI 安裝到全域。
npm install hexo-cli -g 接著初始化 Blog。
hexo init <Folder> 進入剛初始化產出的目錄
運行 Hexo 服務。
hexo s 訪問 http://127.0.0.1:4000 即可看到 Blog 運行的結果。
read morePosts
vscode-hexo - VSCode extension to manage hexo commands
vscode-hexo 是 VSCode 的擴充套件,能讓我們在 VSCode 內簡易的調用 Hexo 命令。
按下熱鍵 Ctrl-Shift-P / Cmd-Shift-P 開啟 command palette,輸入 Extensions:Install Extensions,輸入 hexo 找到 vscode-hexo 擴充套件進行安裝。
安裝完後重啟 VSCode。
點選 [File | Open…] 將 Hexo 部落格目錄開啟。
按下熱鍵 Ctrl-Shift-P / Cmd-Shift-P,輸入 Hexo 即可看到可用的 Hexo 命令。
- hexo init # Initializes a website - hexo new # Creates a new article - hexo generate # Generates static files - hexo publish # Publishes a draft - hexo server # Starts a local server - hexo stop # stop a local server(Ctrl-C) - hexo deploy # Deploys your website - hexo clean # Cleans the cache file (db.
read morePosts
Hexo - Optimize with hexo-console-optimize
hexo-console-optimize 是 Hexo 的套件,可讓 Hexo 對 HTML、CSS、JS、Image 進行壓縮優化。
可透過 npm 進行安裝。
npm install hexo-console-optimize --save 要使用時調用 Hexo 的 Optimize 命令,即會對 HTML、CSS、JS、Image 檔案進行壓縮優化。
hexo optimize hexo o 如有需要,也可加帶 -d 參數在壓縮優化後直接進行佈署。
hexo o -d Link FlashSoft/hexo-console-optimize: Hexo输出内容优化 hexo-console-optimize
read morePosts
Hexo - Speed up with InstantClick
要用 InstantClick 加速 Hexo 部落格,可先下載 InstantClick 放至 source\js 下。
然後開啟 _config.yml 設定檔,加入 skip_render 設定,將 js 檔排除 render。
接著修改 Hexo 的 theme 讓 InstantClick 得以啟動。以 next theme 為例,可開啟 next theme 的 layout_layout.swig,將 InstantClick 啟動的程式插入即可。
<script type="text/javascript" src= "js/instantclick.js" data-no-instant></script> <script data-no-instant>InstantClick.init();</script> 設定完可開啟部落格網站,打開開發人員工具,切換到 Network 頁籤,然後將滑鼠移至連結,就可以看到當滑鼠移至連結時就已經在進行預載的動作了。
最後提醒一下,InstantClick 的預載行為可能會造成其它套件的異常,可能要自行視情況修正將問題排除。
Link InstantClick — JS library to make your website instant
read morePosts
Hexo - Auto deploy with Travis CI
要使用 Travis CI 自動幫我們發佈 Hexo 部落格,先參閱筆者 Travis CI - Free Hosted Continuous Integration Platform for the Open Source Community | Level Up 這篇,登入 Travis CI ,給予授權,並為 Repository 啟用 Travis CI。
接著要準備一組 Personal access token 給 Travis CI。先將 GitHub 的 Settings 開啟。
切到 Personal access tokens 頁面。
按下 Generate new token 按鈕建立一組 token。
為這組 Token 設定一個名稱,並給予它 repo 的權限。
Token 產生後複製留存以供後續使用。
再來要準備 Travis CI 的設定檔 .travis.yml,放置於 Repository 的根目錄,內容大概像這樣 (branches 位置、使用者名稱、與電子郵件位置請自行替換):
language: node_js node_js: - '0.
read morePosts
Hexo - Title SEO
要為 Hexo 部落格做 Title SEO,可以將主題的 index layout 檔開啟做些調整。
themes/[Theme]/layout/index.swig 在 Title 的區塊這邊除了 title 外,我們還可以將部落格的描述之類的額外資訊附加上去。
read morePosts
Hexo - Setup robots.txt
要為 Hexo 部落格加上 robots.txt,我們可以安裝 hexo-generator-robotstxt 套件。
npm install hexo-generator-robotstxt --save 安裝完後開啟站台設定檔,設定啟用 hexo-generator-robotstxt plugins。
然後加入 robots.txt 的設定。
設定完後存擋,接著產生靜態檔案,就可以看到 robots.txt 會順帶被產生出來。
Link GitHub - leecrossley/hexo-generator-robotstxt: Basic robots.txt generator plugin for Hexo
read morePosts
Hexo - Post asset folder
要使用 Asset folder,我們可以開啟 Hexo 的設定檔,將 post_asset_folder 設定設為 true。
當使用 Hexo 建立一篇文章時。
就會連帶幫我們建一個與文章同名的 Asset folder。
我們可以將文章以外所有的檔案放置在這目錄下,然後使用下列語法將之引用。
{% asset_path slug %} {% asset_img slug [title] %} {% asset_link slug [title] %} 像是這邊筆者將圖片放置在 Asset folder 內。
在文章中使用就會像下面這樣:
Link 資產資料夾 | Hexo
read morePosts
Hexo - Disable NexT theme's motion
Hexo 的 NexT 主題預設會有些動畫過場,如果這些動畫不是覺得那麼必要,想將之關閉以提升顯示上的速度,可以開啟 Theme 的設定檔將 use_motion 的設定設為 false。
read morePosts
Hexo - Change NexT theme's scheme
NexT 支援三種不同的 Scheme,可開啟 Theme 的設定檔設定。
Muse scheme…
Mist scheme…
Pisces scheme…
read morePosts
Hexo - Set social link with NexT theme
要設定 NexT 主題的 Social Link,只要開啟 Theme 的設定檔,設定 social link 的位置以及 social icon 即可。
read morePosts
Hexo - Set avatar with NexT theme
要設定 NexT 主題的 avatar,我們可以開啟 Theme 的設定檔,設定 avatar 檔案的位置。
然後將 avatar 的圖檔放置設定的位置就可以了。
read morePosts
Hexo - Add tag page
要為 Hexo 部落格建立標籤頁面,首先要建立 tag 的頁面。
hexo n page tags 開啟剛產生的標籤頁面,設定 type 為 tags。如果不希望能在標籤頁面上留言的話,這邊也可以順便將 comments 為 false。
再來開啟 Hexo 的設定檔,確定 tag_map 設定是否需要更動。
如果 theme 有支援設定,這邊也要確認是否有需要更動,像是是否要加選單之類的。
並在文章上方設定 tags,指定文章的分類。
將服務運行起來就可以在 /tags 看到標籤頁面了。
read morePosts
Hexo - Generate sitemap
要為 Hexo 部落格放置 Sitemap 檔,可以安裝 hexo-generator-sitemap 套件。
npm install hexo-generator-sitemap --save 開啟 Hexo 設定檔,設定 sitemap 檔案。
sitemap: path: sitemap.xml 當建立靜態檔案就會產生指定的 sitemap 檔案。
Link
read morePosts
Hexo - Migrate from octopress
要將 Octopress 部落格移至 Hexo 部落格,首先要將 Octopress source/_posts 下的文章移至 Hexo source/_posts 下。若有圖檔也依樣移過去,像是如果 Octopress 的圖檔放置在 source/images 目錄下,這邊就將它移至 source/images 下。
再來因為 Octopress 的文章的副檔名是 markdown,所以要將它取代為 md 副檔名。
然後使用 RenameRegex 將檔名前面的日期部分拔除。
rr *.md "(\d+-\d+-\d+-)(.*)" "$2" 最後因為 Octopress 文章內的時間資料只顯示到分,所以要用 Regular Expression Search and Replace Command Line Tool 將日期部分修正到秒。
rxrepl -D "C:\Users\larry.nunglog\source\_posts" -I *.md -a --no-backup --no-bom -e utf8 --output-encoding utf8 -s "(\d+-\d+-\d+\s+\d+:\d+)" -r "\1:00" 將服務跑起來看看,如果 Octopress 文章內沒用太特別的符號,這時應該已經可以看到文章了。
如果有 Error 發生,那就是要自己想辦法把出問題的文章抓出來了。
Link
read morePosts
Hexo - Add category page
要為 Hexo 部落格建立分類頁面,首先要建立 categories 的頁面。
hexo n page categories 開啟剛產生的分類頁面,設定 type 為 categories。如果不希望能在分類頁面上留言的話,這邊也可以順便將 comments 為 false。
再來開啟 Hexo 的設定檔,確定 default_category/category_map 設定是否需要更動。
並在文章上方設定 categories,指定文章的分類。
將服務運行起來就可以在 /categories 看到分類頁面了。
Link
read morePosts
Hexo - Local search support
要為 Hexo 架設的部落格加上搜尋,但卻不想依賴外部服務,可以為 Hexo 部落格加裝 hexo-generator-search 套件。
npm install hexo-generator-search --save 套件安裝完需開啟 Hexo 的設定檔,加上 search 的設定。path 的部分指到的是該套件產生的索引檔案,也就是 search.xml,field 則是指定搜尋的範圍,可帶入 post/page/all。
search: path: search.xml field: post 如果使用的主題支援的話,設完後將服務跑起就可以開始使用搜尋的功能。
Link
read morePosts
Hexo - RSS support
要為部落格加入 RSS,我們需先安裝 hexo-generator-feed。
npm install hexo-generator-feed --save 然後開啟 Hexo 的設定檔做些設定,像是 RSS feed 的數量等。
feed: type: atom path: atom.xml limit: 20 hub: 這樣在產生靜態檔案時就會一併產生出 RSS 的 xml 檔。
部落格發佈上去 RSS 就可以使用了。
這邊要注意的是,有的主題也支援 RSS 的整合,像是筆者用的 Next 主題就有支援,設定方式要參閱主題的使用文件,像是 Next 這邊的設定方式就是將主題設定黨內的 rss 設定留空。
主題就會在預期的地方顯示 RSS 訂閱的連結。
Link
read morePosts
Hexo - Apply blog themes
Hexo 支援主題的更換,Themes | Hexo 網站上也提供許多不同的主題可供我們選用,看到有興趣的主題可以直接點擊主題的圖片開啟 Demo Site 瀏覽。
若確定選用該主題,可以點選圖片下方主題的名字連結到下載頁面。
以筆者用的 Next 主題為例,我們可以直接用 GitHub 下載 Zip 檔,或是用 Git Clone 將主題下載下來。這邊只要將下載下來的主題放置在 themes 目錄下就可以了。
接著開啟 Hexo 的設定檔,將 theme 設定指到剛下載的主題目錄。
主題套用就完成了。
Link
read morePosts
Hexo - Deploy blog post
要發佈文章至遠端 repository,第一次使用之前,需要先安裝 Hexo 的 Deployer 套件。Hexo 支援多種 Deployer,這邊可視需要安裝。
像是筆者用的是 GitHub page 去 host 部落格,因此安裝的是 hexo-deployer-git。
npm install hexo-deployer-git --save Deployer 套件安裝完後,要開啟部落格的設定檔設定 Deploy 的參數,像是 Deployer 的型態以及 repository 的位置等。
設定完後我們就可以開始進行發佈的動作。
先產生發佈需要的靜態檔案。
hexo generate hexo g 再用 hexo deploy 進行發佈即可。
hexo deploy hexo d 這兩個命令可以合併起來一次叫用。
hexo g -d 如果發佈後網站無正常更新,可以嘗試清除快取後再次產生靜態檔案發佈。
hexo clean hexo g hexo d Link
read morePosts
Hexo - Write a blog post
使用 Hexo 撰寫 blog 文章,可以先用 hexo new 建立一個 post。
hexo new <title> hexo n <title> 這個指令會幫我們建立一個 post 的 md 檔,開啟該檔用 markdown 撰寫 blog 文章。
撰寫完後存檔,用 hexo server 將 Hexo 服務跑起來。
hexo server hexo s 跑起來後開啟瀏覽器瀏覽 http://localhost:4000 即可看到剛撰寫的部落格文章。
Link
read morePosts
Hexo - Restore blog envirement from remote repository
要從遠端 repository 還原 blog 撰寫的環境,我們需先確定 Hexo 需要的環境是否已經準備妥當(是否有安裝 git?是否有安裝 Node.js?是否有安裝 hexo-cli?)。
Hexo 需要的環境準備好後,可將 repository 的資料 clone 下來。
git clone [repository url] [folder] 接著進到 clone 下來的目錄。
cd [folder] 切換 branch 至 source 放置的 branch。
git checkout [branch] 再還原 npm 的套件即可。
npm install 後續如果有需要,都可從 remote repository 更新 source。
git pull origin [branch]
read morePosts
Hexo - Upload blog source
Hexo 架設完畢後,我們除了要將 blog deploy 上去外,source 的部分也要記得放到版控上面。
首先需進到部落格的目錄,初始 git。
git init 接著設定遠端的 git 位置,這邊如果是用 GitHub,位置的部分就是 GitHub page 的 repository 位置。
git remote add origin [repository url] 接著開啟一個新的 branch 去放置 source。
git checkout -b [branch] 如果需要,這邊可以放置 .gitignore 檔在部落格目錄,用以告知 git 要忽略版控的檔案與目錄。檔案內容如下:
.DS_Store Thumbs.db db.json *.log node_modules/ public/ .deploy*/ 再來要將未版控的檔案加入版控。
git add . commit 這次修改。
git commit -a -m "[comments]" 最後將部落格的 source 送到遠端 repository 即可。
git push origin [branch] 後續每次加文章時,記得也都要將 source 上到遠端 repository。
git add .
read morePosts
Hexo - Getting started
要使用 Hexo,我們需先確定已有安裝 Git & Node.js。
接著安裝 Hexo 的命令列程式。
npm install hexo-cli -g 與初始化部落格。
hexo init [Folder] 初始的動作會產生對應的目錄,並下載需要的檔案。
整個目錄結構會像下面這樣。_config.yml 是 Hexo 站台的設定檔,package.json 是 Node.js 的套件設定檔,scaffoids 目錄內存放的是部落格會用到的樣板,source 目錄內存放的是部落格文章等未經加工建立的來源擋,themes 目錄內放置的是部落格的主題。
再來要開啟 _config.yml 設定部落格。
設定完後存擋。
進到部落格目錄,還原 npm 套件,即可將之運行起來。
cd [Folder] npm install hexo server 運行起來後,用瀏覽器瀏覽 http://localhost:4000 即可看到部落格運行起來的樣子。
Link
read more