如何生成带可变子页面数的定制静态HTML页面？求工具与指导

1. Eleventy（11ty）：数据驱动的轻量静态生成 #

Eleventy是灵活无框架依赖的静态站点生成器，完美适配你的需求——纯静态输出，支持用JSON/YAML管理参与者参数，模板语法（Nunjucks、Liquid）易上手。

• 核心流程：
  • 维护参与者参数文件：在_data/participants.json中存储每个参与者的子页面数量、配色代码、图片路径等配置。
  • 编写模板文件：比如participant.njk，用模板变量插入配色（如给body绑定对应CSS类），用循环语法生成子页面导航；再写子页面模板，根据参数自动生成对应数量的页面。
  • 配置Eleventy规则，让它根据每个参与者的数据批量生成独立主页及子页面，支持增量构建，修改参数后自动更新输出文件。

2. Python + Jinja2：适配已有Python基础的升级方案 #

既然你用过Python脚本，直接用Jinja2模板引擎无缝升级，它是Python生态成熟的模板工具，能快速实现参数化页面渲染。

• 核心流程：
  • 编写HTML模板：在main_template.html中用{{ participant.color_scheme }}、{{ participant.name }}做变量占位，用{% for _ in range(subpage_count) %}循环生成子页面链接。
  • 准备参数数据：用JSON或Python字典存储所有参与者的配置信息。
  • 编写Python脚本：加载模板、读取参数，循环渲染每个参与者的主页和对应数量的子页面，保存到指定输出目录。
• 极简代码示例：

from jinja2 import Environment, FileSystemLoader
import json
import os

# 初始化模板环境
env = Environment(loader=FileSystemLoader('templates'))
main_tpl = env.get_template('main.html')
subpage_tpl = env.get_template('subpage.html')

# 读取参与者配置
with open('participants.json', 'r', encoding='utf-8') as f:
    participants = json.load(f)

# 批量生成页面
for p in participants:
    # 创建参与者目录
    user_dir = f'output/{p["id"]}'
    os.makedirs(user_dir, exist_ok=True)
    # 生成主页
    with open(f'{user_dir}/index.html', 'w', encoding='utf-8') as f:
        f.write(main_tpl.render(participant=p))
    # 生成子页面
    for i in range(1, p['subpage_count']+1):
        with open(f'{user_dir}/page{i}.html', 'w', encoding='utf-8') as f:
            f.write(subpage_tpl.render(participant=p, page_num=i))

3. Node.js + Handlebars：前端友好的生成方案 #

如果更熟悉前端工具链，用Handlebars.js结合Node.js实现批量生成，模板语法和前端常用逻辑一致，学习成本低。

• 核心流程：
  • 安装依赖：npm install handlebars
  • 编写Handlebars模板，用{{this.color}}、{{#each subpages}}等语法定义页面结构。
  • 编写Node脚本，读取JSON格式的参与者参数，编译模板后批量生成所有HTML文件。

以上方案生成的都是纯静态HTML文件，直接上传到Neocities即可。所有方案都完全避开网站builder，且都是开发者通用技能，学会后可复用在其他项目中。

内容的提问来源于stack exchange，提问作者nefelegy