Hexo Stellar Development Guide

记录 Stellar 常规语法以及 Hexo 博客的常用命令、GitHub 自动化部署方式～

博客常见语法

$$\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}$$

使用 iPhone 12 Pro Max 拍摄。

支持多彩标记，包括：默认红橙黄绿青蓝紫亮暗警告错误一共 12 种颜色。

Stellar Hexo GitHub

适合居中且醒目的引用：

Stellar 是迄今为止最好用的主题

支持自定义引号：

热门话题

特别引用

这是一个 icons.yml 配置的示例

这是一个 url 的示例

游山西村

陆游

莫笑农家腊酒浑，丰年留客足鸡豚。
山重水复疑无路，柳暗花明又一村。
箫鼓追随春社近，衣冠简朴古风存。
从今若许闲乘月，拄杖无时夜叩门。

文言文

出师表

先帝创业未半而中道崩殂，今天下三分，益州疲弊，此诚危急存亡之秋也。然侍卫之臣不懈于内，忠志之士忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气，不宜妄自菲薄，引喻失义，以塞忠谏之路也。

后出师表

先帝深虑汉、贼不两立，王业不偏安，故托臣以讨贼也。以先帝之明，量臣之才，固知臣伐贼，才弱敌强也。然不伐贼，王业亦亡。惟坐而待亡，孰与伐之？是故托臣而弗疑也。

滕王阁序

王勃

时维九月，序属三秋。
潦水尽而寒潭清，烟光凝而暮山紫。
俨骖騑于上路，访风景于崇阿。
临帝子之长洲，得天人之旧馆。
层峦耸翠，上出重霄；
飞阁流丹，下临无地。
鹤汀凫渚，穷岛屿之萦回；
桂殿兰宫，即冈峦之体势。

重九日

这是标题

这是正文哈哈。

一共支持12种颜色，可以满足几乎所有的需求了。

color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。

一共支持12种颜色，可以满足几乎所有的需求了。

color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。

不带摘要的样式：

https://xaoxuu.com/blog/20221029/https://xaoxuu.com/blog/20221029/

带摘要的样式：

https://xaoxuu.com/blog/20221029/

2024年的小目标：完成 Volantis 6.0 并发布上线

来自2025年的复盘：已《基本》实现目标

正常 44%

KR1

重构 tag-plugins 和 wiki 系统

当 KR 进度为 100% 时，标签默认显示为已完成
当 KR 未设置进度时，默认为 0%
当 O 未设置进度时，则显示所有 KR 进度平均值

已完成 100%

KR2

完成主要页面设计稿

小提示1

小提示2

您可以在 _config.yml 文件中修改标签的颜色和文案

您可以在 _config.yml 文件中增加任意的标签配置

延期 90%

KR3

完成前置准备工作（如果你知道答案，请在留言区帮帮我！🥹）

在咸水和海滩之间找一亩地

求出圆周率后15位

找出宇宙的终极逻辑

去地狱里走两步

未完成 -12%

KR-4

开发、测试和发布

支持嵌套插入图片等其它简单组件

风险 0%

没有勾选的单选框

已勾选的单选框

普通的没有勾选的复选框

普通的已勾选的复选框

显示为加号的绿色的已勾选的复选框

显示为减号的黄色的已勾选的复选框

显示为乘号的红色的已勾选的复选框

这是密码标签
这是下划线标签
这是着重号标签
这是波浪线标签
这是 ~~删除线~~ 标签
这是 ^上角标标签
这是 _下角标标签
这是 键盘样式 标签，试一试：⌘ + D

主要部分功能已经开发的差不多了。

今天除夕，也是生日，一个人在外地过年+过生日，熬夜开发新主题，尽量在假期结束前放出公测版。

动态数据是从 GitHub Issues 中拉取的，使用方法为：

建一个仓库
创建一个 issue 并添加一个 label 进行测试
写 timeline 标签时加上 api:https://api.github.com/repos/your-name/your-repo/issues

这条内容为静态数据，静态数据在 deploy 时就已经确定了。

推荐的写法

1
2
3

func test() {
    // ...
}

不推荐的写法

1
2
3

func test() -> () {
    // ...
}

图文混排

示例代码

个人电脑作为办公设备时，我们该如何保护隐私？

公司一般都会强制安装安防软件，这些软件要求开机自启动，要求有屏幕录制权限、完全的磁盘访问权限包括相册图库。因此如果使用自己的 MacBook 作为办公设备，必须要把生活区和工作区完全独立开，安装在两个磁盘分区，并且对磁盘分区进行加密。

默认打开的代码折叠框

代码块

Unsplash Photo

The Galactic Center is the rotational center of the Milky Way galaxy. Its central massive object is a supermassive black hole of about 4 million solar masses, which is called Sagittarius A*. Its mass is equal to four million suns. The center is located 25,800 light years away from Earth.

Ōwhiro Bay, Wellington, New Zealand
Published on May 31, 2022
SONY, ILCE-6000
Free to use under the Unsplash License

普通 Box 样式：

cell 1

cell 2

cell 3

cell 4

可浮起的卡片样式：

cell 1

cell 2

cell 3

cell 4

@tianhao_wang

@eberhard

@vklemen

Hexo 常用指令

# 启动本地服务器
$ hexo s

# 清理缓存文件
$ hexo clean

# 生成静态文件 public/
$ hexo g

# 部署网站
$ hexo d

# 新建文章 _posts/
$ hexo new [layout] "<title>"

# 新建页面 source/xxx/index.md
$ hexo new page "<page>"

# 新建草稿 _drafts/
$ hexo new draft "<title>"

# 发布草稿 _drafts/ -> _posts/
$ hexo publish draft ""

自动化部署

可以参考「配置 Hexo 的自动推送」

也可以参考官方方法：在 GitHub Pages 上部署 Hexo

还在用 hexo d 来推送你的 Blog 到 GitHub 上吗？应该使用 Github Actions 自动推送！具体细节参考文章！

当每次要删除文章时（新建文章同理，但最好使用 hexo new "title"），直接把文章从 📂*_post* 文件夹中删除，再执行 add、commit、push 三连 source repo，会自动触发 Action 部署 public 文件夹到 target repo !

强烈建议：❌不要使用 hexo 自带的命令进行手动部署！