关于本站

本站由 玺朽 使用 Stellar 1.29.1 主题创建。
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。

常用命令

启动

先 cd 到 hexo 文件夹处

前台启动

1
hexo server	#（默认端口 4000）

后台启动

1
nohup hexo server > hexo.log 2>&1 &

不过最好是生成静态文件让Nginx映射！！

1
2
3
# 清空 public 目录和缓存文件（.deploy_git、db.json 等）
hexo clean
hexo generate

启动后用Nginx代理，详细见blog：Nginx重定向

关闭

查看 hexo 运行的进程号

1
ps aux | grep hexo

结束 hexo（将 PID 替换成查到的进程号）

1
kill -9 PID

更新

先 cd 到 hexo 文件夹处

1
npm update hexo-theme-stellar

写一篇博客（Blog）的流程

博客目录夹位于source/_posts/

切记⚠️：创建的文件不能有空格（最好是纯英文+下划线），否则引用会失效。

所有地方引用的图片强烈建议放到``source/assets/{blog/wiki/notes}/(md的名字)/xxx.png，比如下面的assets/img/琴里.jpg`

直接在这个目录下写名字随意.md,示例格式：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
---
title: 第一篇博客
date: 2025-02-23 20:57:47
tags: [test]
type: tech #tech/story
auto_cover: false
cover: assets/img/琴里.jpg  # 必选
#poster: assets/img/琴里.jpg # 海报（可选，全图封面卡片）
#	topic: 标题上方的小字 # 可选
#	headline: 大标题 # 必选
#	caption: 标题下方的小字 # 可选
#     color: white # 可选，默认为跟随主题的动态颜色 # white,red...
---
在心率管家默默无闻地上线了一年多之后，现在终于打算来好好聊聊关于手机摄像头测量心率的那些事。本文参考了很多前辈的文章，将在文末列出。

<!-- more -->

后面是正文部分，在主页看不到。
gjgfdh
---
references:
  - '[心跳之旅—💗—iOS用手机摄像头检测心率(PPG)](https://punmy.cn/2016/07/28/15231176397746.html)'
  - '[PPG光电容积脉搏波描记法技术概况](https://www.jianshu.com/p/695c131abfa5)'
  ...
---

写一篇文档（wiki）的流程

每次写完后记得重启项目！！！这里我卡了很久的原因就是没有重新启动项目。

定义项目

有点特殊，文档界面（wiki）是由一个一个项目组成的。一个项目里有包含分层结构（树）的文档内容。

先定义一个项目，在source/_data/wiki下，创建一个名为项目ID.yml来申明一个项目

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
name: 备忘录
title: 备忘录
icon: https://res.xaox.cc/gh/cdn-x/wiki@main/stellar/icon.svg
cover: https://res.xaox.cc/gh/cdn-x/wiki@main/stellar/icon.svg
description: 记录一下一些我个人经常使用的命令
coverpage: [cover, title, description] # 封面页显示的内容

comments:
  service: giscus # 若你不适用默认的评论方式，需要添加此项
  giscus: # 需要你在主题配置文件_config.stellar.yml中设置好giscus的其他参数，其他评论方式同理
    'data-term': '23'
    'data-mapping': number

base_dir: /wiki/test01/
tree:
  'MacOS相关':
    - macos
  'Ffmpeg命令':
    - ffmpeg

base_dir指向了文档所在的相对路径

编写文档

在之前项目申明的路径base_dir下创建对应的xx.md，比如这里是/wiki/test01/ffmpeg.md(source目录下)

1
2
3
4
5
6
7
8
---
wiki: test01	#需和项目 ID一致！！
title: Ffmpeg 使用经验
menu_id: wiki	#使得侧边栏哪个按钮高亮
date: 2025-12-09 18:50:47
---

···

挂载项目

在source/_data下，创建wiki.yml，将要展示的项目的项目ID写入：

1
2
- test01
- 其他项目

写一篇笔记（notes）的流程

和wiki类似，不过不用挂载note。notes界面由一个一个笔记本（notebook）组成。

定义笔记本

在source/_data/notebooks下定义一个笔记本ID.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
name: Demo
title: Demo Notebook
icon: /images/favicon.png
description: 这是一本用来演示的笔记本
base_dir: /notes/

sort: 1
per_page: 10
order_by: -updated
license: true
share: true

menu_id: notes
# 笔记列表页的左/右侧栏
# leftbar: [tagtree, recent]
# rightbar: []
# 笔记页的左/右侧栏
# note_leftbar: [tagtree, recent]
# note_rightbar: [toc]

编写笔记

按照上面base_dir: /notes/定义的，这里笔记应该在source/notes里编写

命名随意.md：

⚠️这里用notebook字段关联笔记本，不是wiki了

1
2
3
4
5
6
7
---
title: note01
menu_id: notes
tag: [test]
notebook: 笔记本ID
---
正文内容

还需注意的——笔记本列表高亮

可能是设计缺陷，notesbook下的笔记本列表URL并没有自动高亮这个笔记📒 icon，我查阅demo文档后，在hexo下载目录里的_config.stellar.yml配置site_tree搞定，一并附上我整个yaml文件的配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
logo:
  subtitle: '不定期更新学习笔记、日志和精彩生活 | 玺朽好帅，难道不是吗' # '文字1 | 文字2' (鼠标放上去会切换到文字2)
# 侧边栏主功能导航菜单
menubar:
  columns: 4 # 一行多少个
  items: # 可按照自己需求增加，符合以下格式即可
     - id: post # 页面中高亮的 menu_id
       theme: '#1BCDFC' # 高亮时的颜色，仅 svg 中 fill="currentColor" 时有效
       icon: solar:documents-bold-duotone # 支持 svg/img 标签，可以定义在 icons.yml 文件中，也支持外部图片的 URL
       title: 博客 # 标题
       url: / # 跳转链接，支持相对路径和绝对路径
     - id: wiki
       theme: '#3DC550'
       icon: solar:notebook-bookmark-bold-duotone
       title: 文档和项目
       url: /wiki/
     - id: notes
       theme: '#FA6400'
       icon: solar:planet-bold-duotone
       title: 笔记
       url: /notebooks/
     - id: social
       theme: '#F44336'
       icon: solar:chat-square-like-bold-duotone
       title: 社交
       url: /friends/
       
comments:
  service: beaudar
  beaudar:
    repo: lonelymeko/blog

post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

#NEW
site_tree:
  index_notebooks:  # 对应 /notebooks/ 页面
    menu_id: notes  # 关联 menubar 中的 id: notes
  notebooks:  # 对应 notebooks 子页面
    menu_id: notes

增加友链的流程

相信聪明的你，从前面断断续续了解到怎么自定义一个界面了。只要把申明页面的文件放到menu_id对应的URL文件夹下就行了

不过这里还有坑⚠️：文件夹要放到source后面而不是source/_data

使用Stellar 主题自带的卡片组件来展示友链页面。这里我直接放我的示例：

新建数据文件（存放友链信息）

/source/_data/links/partners.yml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
- title: MineAurora
  url: http://ysfx.top/
  icon: https://avatars.githubusercontent.com/u/133890950?v=4
  description: 一个社恐程序员(也许)

- title: 花月的博客
  url: https://kachofugetsu09.github.io/
  icon: https://avatars.githubusercontent.com/u/82231537?v=4
  description: Folding was never an option.

- title: Waves_Man
  url: https://blog.waveyo.cn
  icon: https://cloud.waveyo.cn/Services/websites/blog/images/avatar.jpg
  description: Hello World！

在友链页面使用标签（调用显示卡片）

/myBlog/source/friends/index.md：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
menu_id: social
title: 友情链接
comment_title: 快来交换友链吧～
sidebar: [sociallist, welcome, recent]
---

### 伙伴们

{% sites partners %}

---

### 申请说明

欢迎交换友链...

效果：

image-20251224044808601

后续应该会补充更多组件的使用…

快来参与讨论吧~


新ICP备2025018290号-1
本站总访问量次