hexo-theme-signal — Hexo Blog Template

SHA-256: 3206e21c8d48136c8eb97369e87d92379d82065fc8078ede0d50d9c0bf53341f

2026-10-01T03:13:15.946Z

# Signal

一个面向安全研究博客的 Hexo 主题。以终端与技术档案为视觉语言，同时保留清晰、
克制的文章阅读体验。

![Signal 首页预览](screenshots/home.png)

## 特性

- 响应式首页、文章、独立页面与分页
- 归档、分类和标签索引
- 本地生成 `search.json`，支持键盘快捷搜索
- 文章目录、阅读进度与代码复制
- 兼容 Hexo 高亮表格和普通 fenced code block
- 支持 `layout: links` 的友链页面
- 标题可在常规字体与像素字体之间切换
- Disqus、Google Analytics 与百度统计配置入口

## 安装

在 Hexo 站点根目录执行：

```bash
git clone https://github.com/WinMin/hexo-theme-signal.git themes/signal
```

然后修改站点 `_config.yml`：

```yaml
theme: signal
```

本主题目前在 Hexo `5.4.2` 上完成构建验证。

### 页面与 RSS

导航中的以下页面需要在站点中建立对应内容：

| 路径 | Front matter |
| --- | --- |
| `source/tags/index.md` | `type: tags` |
| `source/categories/index.md` | `type: categories` |
| `source/search/index.md` | `layout: search` |
| `source/link/index.md` | `layout: links` |
| `source/about/index.md` | 普通页面 |

如需启用默认的 `/atom.xml` 链接，请安装：

```bash
npm install --save hexo-generator-feed
```

## 配置

主题默认配置位于 `_config.yml`。导航、社交链接、首页文字、搜索、评论、统计和页脚
均可在这里调整。也可以在站点根目录建立 `_config.signal.yml` 覆盖主题配置，避免在
更新主题时处理配置冲突。

标题默认使用常规无衬线字体：

```yaml
typography:
  title_style: clean
```

将 `clean` 改为 `pixel` 可以恢复像素风标题。首页的可选说明栏已作为注释保留，
取消 `hero.panel_*` 三项的注释即可启用。

评论与统计默认关闭。需要时可在配置中的 `comments` 和 `analytics` 部分填写
Disqus shortname、Google Analytics ID 或百度统计 ID。

Disqus 的推荐文章模块默认隐藏，避免第三方 iframe 的浅色背景破坏暗色主题。如需
恢复，可设置：

```yaml
comments:
  disqus_recommendations: true
```

### 外部发表与作者归档

为文章添加 `origin` 后，首页卡片和文章页会显示低对比度的原始出处与原文链接：

```yaml
origin:
  site: STAR Labs
  url: "https://example.com/original-post/"
  published_at: "2026-05-29"
  authors:
    - Author One
    - Author Two
  read_time: 26
  note: 本文首发于外部站点，本站为作者同步归档版本。
  canonical: true
```

`site` 和 `url` 是必填项，其余字段均可省略。只有全文或近似镜像确实需要以原文为
权威页面时才设置 `canonical: true`；翻译、摘要或本站持续维护的版本建议保持本站
canonical。

![外部发表来源栏预览](screenshots/external-publication.png)

## 本地预览

```bash
hexo clean
hexo server
```

## 字体与许可

主题代码以 [MIT License](LICENSE) 发布。

内置的 `Fusion Pixel 12px Monospaced` 字体由 TakWolf 及其贡献者维护，以
SIL Open Font License 1.1 发布。原始许可位于 `source/fonts/OFL.txt`，上游组件
声明保留在 `source/fonts/licenses/`。