3.2 KiB
3.2 KiB
原始史料进入 Code4History 的文件分流表
| 读到的内容 | 去往何处 | 严格条件 |
|---|---|---|
| PDF/图片/照片等原件 | 01_sources/originals/{primary,secondary}/ |
默认只读,保存文件实际字节与来源;别覆盖 |
| 一手身份、日期、版权、作者立场、版本 | 01_sources/records/primary/SRC-P-* |
不确定项写 unknown;后出刊本与事件原件区分 |
| 二手研究书目信息与阅读记录 | 01_sources/records/secondary/SRC-S-* |
不因提及史料就算已阅读史料 |
| 转录、机器识读、校订本文、翻译 | 01_sources/transcripts/... |
分块标注源页与校核;译文不可覆盖原文 |
| 关键的可核查陈述、引语、数字 | 02_evidence/EV-* |
独立的 source_ids、source_locator、上下文、校核状态 |
| 文中提及但尚未找到的其他材料 | 03_inquiry/leads/L-* |
不虚构馆藏号与下载成功 |
| 需要解释的反常现象、冲突 | 03_inquiry/questions/Q-* |
问句应允许被证据回答或否定 |
| 文献作者的解释或项目可能解释 | 03_inquiry/hypotheses/H-* |
标记谁提出的;保留竞争性假说 |
| 人物、地理、机构、观念 | 04_context/ 下对应主题文件 |
记录适用时间、原义与 SRC/EV 关联 |
| 日期及不同版本之间的时间差 | 04_context/chronology.md |
冲突并列,不偷换“事件时间”和“写作时间” |
| 二手研究的研究问题及主张 | 05_historiography/works/W-* |
区分研究者观点与其引用的史料 |
| 不一致、有偏向或未校对的证据 | 08_review/ |
记录对核验与论证的影响 |
| 已充分论证的论点或草稿 | 06_arguments/ / 07_manuscript/ |
不在摄入阶段自动生成;待研究者另行授权 |
一个中性示例(不预设研究主题)
假设用户上传一份1910年发表的市议会调查报告 PDF,报告引述了1907年的会议、标注某项工程预算,且提到另一个委员会的未刊记录。
- 保存
SRC-P-0001及其 1910 年报告原件;写明1907年是所述事件年代,不是报告出版年代。 - 在
transcripts/primary/保存用户关心页的原文,注明扫描识读状态及实际覆盖页码。 - 「报告称预算为 X」→
EV-0001,只有核对原页后才能当逐字引文;不是自动等于真实成本为 X。 - 「1907年会议」→
chronology.md,若未取得1907年议事录须标记仅据1910年回顾。 - 「未刊委员会记录」→
L-0001,不要虚构其馆藏号。 - 若报告前后数字矛盾 →
08_review/contradictions.md并生成研究问题Q-0001。 - 是否上升为某种制度形成的结论,应等候其他来源交叉验证与研究者决定。
v0.8 upload 操作
用户可将 原始文件.pdf 与 原始文件.pdf.source.md 成对存入仓库根目录 upload/。每轮通过 python tools/interaction.py scan 发现待摄入材料;完成基本识别后 python tools/interaction.py intake --file "原始文件.pdf" --kind primary --slug short-name 归档原件、保留说明原文、写入校验收据及来源卡;此后再执行上表的 EV、Q/H、背景分流。处理成功且校验通过后上传区附件才移出;禁止无差别清空。