ABOUT HANWEN

关于汉文诗苑

汉文诗苑希望把中国古典诗词带回日常阅读：每次打开首页，读一首诗，也看见诗人留下的生平与时代痕迹。网站不收集账户资料，开放 API 不要求注册。

馆藏与资料来源

首期馆藏导入 chinese-poetry 数据集中的《全唐诗》和《全宋词》，包括诗词正文、题目、作者与已有的作者介绍。原始数据以 JSON 形式维护，本站将其导入 Cloudflare D1 以支持检索和公共 API。

原始数据集采用 MIT 许可。本站保留数据来源标注；转载、衍生使用或商业使用前，请阅读并遵守原始项目的许可与署名要求。

开放与可发现性

网站提供可抓取的页面元数据、Open Graph 标签、JSON-LD 结构化数据、robots.txt、sitemap.xml 和 llms.txt。这些内容让搜索引擎与生成式检索系统能够准确理解网站主题、数据范围与公开接口。

公共接口仅用于读取，并有每客户端每分钟 60 次的公平使用限制。欢迎用于教学、研究、个人工具和文化传播；请缓存响应并避免高频批量抓取。

Cloudflare 部署

项目位于 website 目录，需先安装 Node.js 依赖并登入 Cloudflare 帐户。创建 D1 后，将命令输出中的数据库 ID 写入 wrangler.toml 的 database_id。

cd website
npm install
npx wrangler login
npx wrangler d1 create hanwen-poetry
npm run db:migrate:remote
npm run db:import:remote
npx wrangler secret put RATE_LIMIT_SALT
npm run deploy

导入脚本默认读取上一级的诗词源目录。需要其他位置时，设置 CHINESE_POETRY_DIR；需要指定 D1 名称时使用 --database。首次导入会写入唐诗、宋词与作者资料，可能需要数分钟。

正式站点使用 https://poetry.fakehistory.top 作为 PUBLIC_SITE_URL，用于生成 canonical、sitemap 和结构化数据 URL。

广告声明

/ads.txt 已由 Worker 提供，并使用 ADSENSE_PUBLISHER_ID 生成 Google AdSense 授权记录。发布商 ID 是公开标识；如需更换，请更新 wrangler.toml 中的该变量后重新部署。