古今中外各领域女性资料整理
基于我们之前讨论的方案——Hugo静态生成器 + 两栏参考文献布局 + GitHub托管，下面是你需要创建的核心文件结构。
我会用树形图展示，并标注每个文件/文件夹的作用。你可以直接在你的电脑上按此结构创建，然后推送到GitHub。
your-site/
├── config.toml
├── content/
│ ├── reality/ # 现实人物
│ │ ├── china/
│ │ │ ├── ancient/
│ │ │ │ └── wangzhenyi.md
│ │ │ ├── modern/
│ │ │ │ └── qiujin.md
│ │ │ └── contemporary/
│ │ │ └── tuyouyou.md
│ │ ├── asia/
│ │ ├── europe/
│ │ ├── americas/
│ │ └── africa-oceania/
│ ├── myth/ # 神话人物
│ │ ├── china-myth/
│ │ │ └── xiwangmu.md
│ │ ├── greek-myth/
│ │ └── other-myth/
│ └── topics/ # 专题页面（独立内容）
│ ├── shanhaijing/ # 《山海经》专题
│ │ └── index.md # 专题正文
│ ├── nobel-women/ # 诺贝尔奖女性专题
│ │ └── index.md
│ └── first-women/ # 中国第一人专题
│ └── index.md
├── layouts/
│ ├── _default/
│ │ ├── baseof.html # 基础骨架
│ │ ├── single.html # 人物详情页（左文右证）
│ │ └── list.html # 分类列表页（人物卡片网格）
│ ├── index.html # 首页（英杰区+最新+随机+专题入口+数据统计）
│ ├── topics/ # 专题页专用模板
│ │ └── single.html # 专题页模板（引言+特色内容+人物列表+额外资料）
│ └── partials/ # 可复用组件
│ ├── header.html
│ ├── footer.html
│ ├── hero.html # 英杰区
│ ├── latest.html # 最新添加人物
│ ├── random.html # 随机推荐
│ ├── topics-grid.html # 热门专题入口
│ ├── stats.html # 数据统计
│ ├── card.html # 人物卡片（复用）
│ └── references.html # 右侧参考文献栏
├── static/
│ ├── css/
│ │ └── custom.css
│ ├── js/
│ │ ├── references.js # 脚注高亮
│ │ ├── random.js # 随机推荐逻辑（前端实现）
│ │ └── d3.js # 关系网络可视化（可选）
│ └── images/
├── data/ # 可选：存放统计数据（如人物总数）
│ └── stats.json
└── .github/workflows/
└── hugo.yml
config.toml：Hugo站点配置，包括网站标题、语言、主题、菜单、自定义参数等。你需要在这里定义主菜单（现实人物、神话传说、专题），并启用自定义模板路径。content/ – 所有人物文章.md 文件，在文件头部用 Front Matter 填写标签、分类、图片等。[^1] 格式，Hugo会自动生成脚注列表，再由模板提取到右侧栏。layouts/ – 控制页面显示_default/baseof.html：基础骨架，包含 <html>、<head>、<body> 以及 `` 占位符。_default/single.html：人物详情页模板。
.main-content 渲染 ``，右侧 .references 用来显示参考文献。static/js/references.js）。_default/list.html：列表页（如 /reality/china/modern/）模板。展示人物卡片网格，支持分页和排序。partials/：可复用组件，例如：
header.html：包含网站logo、主菜单、搜索框（可用Pagefind）。footer.html：版权、来源声明等。sidebar.html：右侧边栏（标签云、随机推荐）。注意人物详情页右侧已被参考文献占，侧边栏可放在左侧下方或单独处理。static/ – 静态资源/images/china/ancient/wangzhenyi/portrait.jpg。hugo-theme-stack），然后在其基础上修改 single.html 实现两栏布局。.github/workflows/hugo.yml：可选的自动化部署配置，让你每次 git push 后，GitHub自动构建并发布到 GitHub Pages。Hugo官方有现成的工作流模板。themes/ 和 .github/），并创建 config.toml 和一个测试人物（如 content/reality/china/ancient/wangzhenyi.md）。layouts/_default/single.html 中先用最简单的单栏布局输出 ``，确保站点能运行。如果你需要，我可以帮你生成 config.toml 示例、人物Markdown模板、single.html 的关键代码片段，让你直接复制使用。你希望我从哪个文件开始？
让那些被历史淹没的女性故事重新浮出地表。
<拼音标识>-<生卒年或时代>wangzhenyi-1768-1797、xiwangmu-myth-china```yaml — title: “王贞仪” date: 2026-03-21 categories: [“中国”, “古代”] tags: [“天文学家”, “数学家”, “诗人”] params: dynasty: “清代” field: [“天文学”, “数学”, “文学”] identity: [“科学家”, “诗人”] image: “/images/wangzhenyi/portrait.jpg” bio: “清代女科学家，精通天文、数学、地理，著有《月食解》等。” —
| 标签类型 | 可选值 |
|---|---|
| 时代标签 | 上古 / 古代 / 中古 / 近代 / 现代 / 当代 |
| 地域标签 | 中国 / 日本 / 希腊 / 北欧 / 埃及 / 印度 / 凯尔特 等 |
| 领域标签 | 政治 / 科学 / 文学 / 艺术 / 军事 / 体育 / 哲学 / 医学 / 教育 |
| 身份标签 | 统治者 / 革命者 / 作家 / 画家 / 医生 / 航天员 / 学者 / 活动家 |
| 特质标签 | 第一人 / 诺贝尔奖 / 女权先驱 / 传奇 / 殉道 / 被遗忘者 |
| 神话专属 | 神系 / 职能 / 象征物 |
##五、技术实现历程与放弃原因
在本地运行 hugo 命令，输出显示 Total in 92 ms 且统计出 38 个页面，但生成的 public/index.html 实际内容为 0 字节。尝试用 hugo server 预览同样空白。
可能原因：模板中某些 partial 缺失、变量未定义、或配置与 Hugo 版本不兼容。由于排查成本过高，未能修复。
public 内容：将 public 文件夹内所有文件上传到仓库根目录，设置 Pages 源为根目录后，访问网站显示 RSS XML（因 index.html 为空，Pages 自动回退到 index.xml）。多次尝试删除重建均无效。因 GitHub Pages 原生支持 Jekyll，尝试寻找功能接近的 Jekyll 主题。但搜索五六个网站，要么国内访问不了，要么功能过于简陋（无法实现左文右证、复杂标签等）。即使提出可手动创建极简 Jekyll 网站，你也因对“从0到1”模式失去信任而放弃。
选定 cncf/dot-org-hugo-theme 主题，但其安装需要 git clone、npm install、本地构建，且国内访问 GitHub 极不稳定，无法完成。
##六、已完成的资产
完整的网站架构设计（分类体系、标签体系、页面布局）
一篇完整的人物文章（王贞仪，含脚注与参考文献）
一套可运行的 Hugo 源码框架（含 config.toml、layouts、content 等）
详细的部署流程记录与技术教训
相关资料网站清单（见第七节）
##七、相关资料网站（素材与灵感来源）
| 名称 | 地址/访问方式 | 说明 |
|---|---|---|
| 明清妇女著作 | https://digital.library.mcgill.ca/mingqing/ |
收录 5243 名明清女诗人的诗词、生平、古籍书影，可直接访问。 |
| 中研院近代妇女传记数据库 | 需向中研院近代史研究所申请账号 | 近代（1840-1949）女性传记资料，支持社会关系标签检索。 |
| CBDB（中国历代人物传记资料库） | https://projects.iq.harvard.edu/cbdb |
约 65 万人物，女性约 1500 人，可做数据导出和可视化。国内访问需稳定网络。 |
| 引得数字人文平台 | www.inindex.com |
哈佛、北大等合作，约 49 万历史人物，支持拼音、繁体检索，国内可直接访问。 |
| 国家图书馆“民国时期文献保护计划” | 国图官网 → 数字资源 | 含民国妇女期刊、书籍原始文献，需注册（免费）。 |
| 名称 | 地址 | 特点 |
|---|---|---|
| Herstory Ireland | www.herstory.ie |
文化运动、灯光节、纪录片，讲述爱尔兰及全球女性故事。 |
| HerStories EU | herstoryproject.eu |
欧盟资助，聚焦 20 世纪欧洲犹太女性，提供教学纲要、纪录片。 |
| Herstory Law | www.herstorylaw.org |
华裔美国女性法律史口述历史项目，巡回展览。 |
| 名称 | 地址 | 说明 |
|---|---|---|
| 维基百科女性分类 | 各语言维基百科（如 https://zh.wikipedia.org/wiki/Category:女性） |
人物词条丰富，可直接作为人物索引和基础介绍。 |
| 澎湃新闻“女性”专题 | https://www.thepaper.cn/ 搜索“女性” |
近现代女性人物报道，通俗可读。 |
| 《民国女性生命如歌》等书籍 | 图书馆或孔夫子旧书网 | 70 余位民国女性故事，可作深度写作参考。 |
这些网站中，部分国内访问可能受限（如 Herstory Ireland、CBDB 主站），但大部分学术库和国内平台可正常使用。未来重启项目时，可以优先从 明清妇女著作、引得平台、国家图书馆 等稳定源挖掘素材。