Hve——一個你可能喜歡的靜態博客客戶端工具

04-19

這是一個開源的，基於 electron-vue、iview 開發的一個靜態博客客戶端工具，正在開發和內測中，目前只有 Mac 版，目前只有 Mac 版，目前只有 Mac 版

快速上手

歡迎使用 Hve，本文檔將幫助你快速上手。如果使用過程中遇到問題，請加群或提 Issues，我會儘力幫你解答。

項目地址：

hellohve/hve?

github.com

博客預覽地址：

海島心hey?

fehey.com

Hve 是什麼？

Hve 是一個快速、易用、交互友好的靜態博客客戶端工具。基於 Markdown 渲染文章，依託 Github Pages 進行靜態博客部署。目前只有 Mac 版，Windows版敬請期待。

安裝

首先確保您已經安裝了Git，Hve 使用 Git 進行版本控制和博客發布。

下載 Hve，並進行安裝即可。

準備：生成 Personal access tokens

登錄自己的 GitHub 依次進入到 Settings -> Developer settings -> Personal access tokens, 然後點擊 Generate new token 按鈕進行 token 生成，只需勾選上 repo 相關許可權即可。生成後複製保存到本地，以備後用。

準備：註冊 Oauth application

此步用於評論系統——Gitment 相關配置信息，如果不需要評論系統，可跳過此步，不過我們還是建議你配置一下，我們認為利用評論來交朋友或對自己文章進行反饋，是個不錯的體驗。

開始使用

打開 Hve，按照歡迎頁的提示，進行一、二、三步操作。

第一步：進行 Github 相關配置

1. 設置源文件目錄，點擊更改目錄，進入系統文檔（Documents）文件夾，選擇 hve-blog 文件夾，這個文件夾是首次打開 Hve 時自動生成的，裡面包含了博客的初始化相關文件夾和文件；

2. 輸入 Domain，例如：//eryouhao.github.io/hve-blog, 即網站對應的域名，若是初次使用 Github Pages，可直接新建一個 用戶名.github.io 的倉庫，直接使用 Github Pages 服務，或開通任意倉庫的 Pages 服務；

3. 輸入 Repository，例如：hve-blog 或 eryouhao.github.io, 即網站發布後靜態文件存放的倉庫；

4. 輸入 Branch，例如：master, 即 Github Pages 對應的分支；

5. Username, 例如：EryouHao, 即 Git 提交時使用的用戶名；

6. Email, 例如：haoeryou@qq.com, 即 Git 提交時使用的郵箱；

7. Token, 即準備時生成的 Personal access tokens；

8. 點擊保存。

第二步：進行博客和 Gitment 相關配置

1. 設置網站頭像，可以選擇一張心儀的圖片來作為網站的頭像；

2. 輸入網站標題；

3. 輸入每頁文章數;

4. 輸入 Gitment Owner，例如：EryouHao

5. 輸入 Gitment Repo，例如：hve-blog, 即評論 Isssue 存放的倉庫

6. 輸入 Gitment Client ID，即準備時註冊 Oauth application 時的 Client ID；

7. 輸入 Gitment Client Secret，即準備時註冊 Oauth application 時的 Client Secret；

8. 點擊保存。

第三步：創作、預覽、發布

現在你可以用 Hve 來進行文章創作，也可以直接點擊 Publish 進行測試，因為我們已經為您準備了一篇測試文章。

發布後，可直接打開瀏覽器訪問你的博客啦，例如：http://fehey.com/hve-blog

說明

此項目還在開發中，目前只是一個內測版本，勉強可以使用了，誠邀內測，並歡迎各種 Star、Issues、PR，也歡迎小夥伴一起開發