古典文学探索器是信科院智能助手的文学方向课程项目。学习者从一个简洁的静态网页模板开始,理解数据怎样变成列表、详情与统计,再把内容替换成自己关心的作品或主题。
它不要求先搭建后端或配置模型API,适合先通过可见作品学习网页与数据的基本分工。本文介绍课程模板与学习目标,不代表已有学生的公开成果。
模板包含什么
现有模板使用HTML、CSS与JavaScript组织页面,从本地数据文件读取作品,提供关键词搜索、朝代筛选、点击查看详情和统计展示。课程材料按直接打开本地HTML的方式组织,不要求先部署网站。
数据放在data/poems.js,页面结构、样式和交互逻辑分别放在相应文件中。数据字段包括编号、标题、作者、朝代、正文与标签。将数据与显示逻辑分开后,替换作品时通常不需要重写全部页面。
为什么从现成模板开始
起始模板让你先观察一个完整的数据到页面的过程:修改一条数据,看看列表怎样变化;改变筛选条件,看看统计是否同步;打开一首作品,确认详情与所选条目对应。
课程不把“页面能打开”当作全部学习目标。你还需要理解自己修改了哪里、数据来自哪里,以及怎样检查修改没有影响原有功能。
可以怎样扩展
- 换成自己感兴趣的作品、作家或文学主题,保持字段与数据结构一致。
- 将搜索从标题和作者扩展到标签或正文,并检查无结果情况。
- 丰富详情信息,注明新增资料来源,避免把推测写成事实。
- 增加适合当前数据的统计,并解释统计单位与缺失数据。
- 改善空状态、筛选重置和阅读体验,再检查原有交互。
先选一个范围明确的改动,比同时增加大量未经验证的功能更容易说明和验收。
数据来源怎样说明
现有课程的DATA_SOURCE.md说明样例参考公开项目chinese-poetry,并进行了小规模抽取和字段整理。它不是完整的上游数据集,课程整理后的结构也不代表上游原始格式。
替换数据时,应同步写明来源名称、链接、使用条件、抽取范围、所做整理与限制。不要因为作品年代较早,就忽略现代整理、注释、译文或数据集的权利说明;也不要把课程样例规模写成整个上游项目的规模。
怎样检查自己的作品
先核对数据,再检查搜索、筛选、详情和统计。可以选择一个确实存在的标题、一个没有结果的关键词和不同朝代,记录实际操作与显示结果。新增或删除数据后,再检查列表和统计是否一致。
提交时提供本次代码或仓库、运行方式、具体改动和操作结果。截图可以补充界面现象,但不能代替数据与逻辑说明。不要上传无权公开的电子书全文、私人读书记录或无关个人信息。
最后交付什么
交付一个可以运行的文学探索器、与作品一致的数据来源说明,以及对本人改动和验证结果的解释。使用课程模板不影响学习价值,但介绍作品时应诚实说明复用部分与本人完成的部分。
作品是静态网页示例,不自动具备完整文献检索、权威学术标注或在线协作能力。需要这些能力时,应作为新的任务明确设计与验证。