引言#
什麼是博客？它是我們的另一片天地，在這裡你可以說你想說的話，分享自己學到的新東西，美好的事，是溫馨的小窩。
它是不被世俗打擾的淨土，沒有人在這裡教你做事，你可以倾心陳述一切。
它是可以記錄你的生活，你的成長，如果你想，甚至是你的一生。
靜態博客引擎允許使用者們以最低成本運行自己的博客，熱愛生活的你，有沒有想過在手機上編寫發布自己的博客？
也許是一場形式上的會議，也許是置身於喧鬧的人群，也許是很長很長的無聊旅途，把那些被毫無意義之事浪費的時間用在總結與分享之上。
你或許已經了解過一些不成熟的方案，但現在這裡提供了更好的方案。
介紹#
WeBlog是一個運行在安卓的靜態博客編寫器，他提供從編寫，構建到預覽預覽博客的能力，同時包含 GIT, 終端，自定義 Shell 腳本等功能。
新建文章，標籤管理，現代化的 UI，可以提供更好博客編寫的體驗。如果你使用 Hexo 或者 Hugo 構建自己的博客，這將會是你很好的選擇。
項目 Github 地址
快速開始#
開始新的博客#
創建一個空文件夾#
文件夾可以位於 SDCARD 目錄或者 WeBlog 私有目錄。
選擇一個博客引擎並創建博客#
當前可選博客引擎有Hexo和Hugo，在 Hexo 創建博客時可能會因為網絡問題卡住，推薦使用終端創建 Hexo 博客。
如果你是一個博客新人，推薦使用 Hugo 搭建自己的博客，因為在安卓上 Hexo 與 Hugo 性能差距被拉大，具體表現在構建博客和實時預覽。
(我們發現 Hexo 在安卓上實時預覽表現不佳，相對於 Hugo 預覽的秒載，Hexo 面臨啟動慢和渲染慢的問題，如果你只使用軟件自帶的 markdownView 預覽大可忽略這些差距)。
實時預覽和腳本管理#
啟動實時預覽並填入預覽端口 (默認為 4000)，啟動成功後實時預覽按鈕將會改變背景，再次點擊按鈕可關閉實時預覽。
我們可以通過http://localhost:4000/ 訪問實時預覽的網頁，此時 Hexo 會監聽 markdown 修改並自動渲染網站頁面。
WeBlog 提供 Busybox 創造一個精簡的 shell 環境，包含 wget,vi,tar 等常用命令。
我們可以通過腳本管理自定義構建和部署的腳本，在項目的.scripts文件夾自建.sh 文件即可添加新的腳本。
單擊右上角運行按鈕即可執行一個或多個腳本 (腳本執行的先後順序為腳本在列表裡排列的順序)
創建新文章#
單擊主頁的加號按鈕以彈出文章創建頁面。
當文章標題為 ascii 字符時，WeBlog 會自動以去除空格，並首字母大寫的後的字符串作為 md 文件名。
如 "Let us start" -> "LetUsStart.md"
當文章標題為非 ascii 字符時 (即非英文字符)，WeBlog 會自動把字符轉化為 md5 碼再作為 md 文件名 (此功能可在設置裡關閉，關閉後以標題為文件名)。
每篇文章可以有一個分類，多個標籤，和一個文章描述。
每次添加新的分類和標籤都會被軟件記錄下來，下次創建文章能夠更方便地使用。
文章描述將作為文章摘要在網站的文章列表顯示。
進行網站部署#
我們推薦使用 Github,Vercel 等網站的自動構建進行網站部署，這樣你可以在任何平台對你的文章進行修改和發布 (通過 git clone,push)。
若是你選擇僅推送渲染文件到托管網站，請也參考一下命令進行操作。
通過訪問令牌部署 (推薦)#
打開 github -> Setting -> Developer settings-> Personal access tokens-> Tokens (classic)-> Generate new token
創建一個權限足以訪問你 Github page 的令牌，並通過以下形式訪問你的 Github 倉庫
git -c http.extraheader="Authorization: Basic $(echo -n 你的令牌: | base64)" push
或
git clone https://x-access-token:你的令牌@github.com/your-username/your-repo.git
將你的令牌替換為剛得到的令牌，適當修改其他信息。
更多用法可以查找關於令牌的資料。
通過 ssh 密鑰部署#
打開 WeBlog 底部終端，按你的 Github 實際信息進行輸入。
git config --global user.name "yourname"
git config --global user.email "youremail"
ssh-keygen -t rsa -C 你的郵箱
連續回車兩次
終端輸出完信息後，再執行
cat /data/data/com.pangbai.weblog/files/home/.ssh/id_rsa.pub
複製輸出的信息 ssh-rsa****** 到剪切板
打開 github 頁面https://github.com/settings/keys 添加 ssh 密鑰
添加完畢後輸入
ssh -T [email protected]
如果輸出問候語，即成功，此後可通過 git 命令訪問倉庫
通過 Vercel 部署#
使用之前請註冊 vercel 賬號
npm i vercel -g
安裝 vercel, 如果出現失敗請更換 npm 鏡像或科學上網。
安裝成功後執行
vc
使用郵箱登錄你的 vercel 賬號
登錄完成後根據喜好配置 vercel 即可
正式部署命令
vc --prod