内容生成模块

📋 模块概述

内容生成模块负责将数据库中的文章数据渲染成静态HTML网站，包括主页、日摘要页面、归档页面和搜索页面。

🎯 生成的页面

1. 主页 (index.html)

2. 日摘要页面 (digest/YYYY-MM-DD.html)

3. 归档页面 (archive.html)

4. 搜索页面 (search.html)

🔧 技术实现

Jinja2 模板渲染

from jinja2 import Environment

env = Environment()
template = env.from_string(template_content)
html = template.render(
    site_name=config['site_name'],
    groups=groups,
    current_year=datetime.now().year
)

Markdown 转 HTML

import markdown

html = markdown.markdown(
    md_text,
    extensions=['extra', 'nl2br']
)

关键要点处理

自动将摘要中的"关键要点"转换为标签样式：

<div class="key-tags">
  <span class="key-tag">要点1</span>
  <span class="key-tag">要点2</span>
</div>

📂 输出目录结构

output/
├── index.html              # 主页
├── archive.html            # 归档页
├── search.html             # 搜索页
├── digest/                 # 日摘要目录
│   ├── 2026-05-21.html
│   ├── 2026-05-20.html
│   └── ...
├── pagefind/              # 搜索索引
│   └── ...
└── static/                # 静态资源
    └── style.css

⚡ 功能特性