引言#
博客是什么？它是我们的另一片天地，在这里你可以说你想说的话，分享自己学到的新东西，美好的事，是温馨的小窝。
它是不被世俗打扰的净土，没有人在这里教你做事，你可以倾心陈述一切。
它是可以记录你的生活，你的成长，如果你想，甚至是你的一生。
静态博客引擎允许使用者们以最低成本运行自己的博客，热爱生活的你，有没有想过在手机上编写发布自己的博客？
也许是一场形式上的会议，也许是置身于喧闹的人群，也许是很长很长的无聊旅途，把那些被毫无意义之事浪费的时间用在总结与分享之上。
你或许已经了解过一些不成熟的方案，但现在这里提供了更好的方案。
介绍#
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