EpiDoc WorkshopEpiDoc 编码教学工坊 · 双语版

A bilingual workshop in EpiDoc encoding — the TEI/XML standard for digital epigraphy. The deck moves from EpiDoc's foundations and four-view philosophy, through two flagship case studies (the Cyrene Edicts of Augustus and the Aphrodisias archive wall), into a ten-text ladder of hand-encoded inscriptions ranging from a Latin funerary tag to a Greek elegiac quatrain. Every difficult tag is glossed in English and beginner-friendly simplified Chinese. The whole pack is static HTML — no server, no login, no database. 本工坊以双语讲授 EpiDoc 编码,数字铭文学使用的 TEI/XML 国际标准。整套幻灯片由 EpiDoc 之根基与“四视图”哲学讲起, 穿过两件旗舰案例(奥古斯都之昔兰尼诏令 C.101、阿芙罗狄西亚斯之档案墙 iAph 8), 落入十铭三阶的实操梯阶,从短篇拉丁墓志至完整希腊哀歌四行体。凡疑难标签皆以英文与初学者友好型简体中文双语注释。整个工坊为纯静态 HTML,无服务器、无登录、无数据库。

🎞 Open the slides · 打开幻灯片 ⌨ Enter the playground · 进入试验场 👁 Four views · 四视图
128slides · 幻灯片 · 2case studies · 案例 · 10exercises · 练习 · 5tools · 工具 · 4corpora · 语料 · EN + 简体中文

The arc of the workshop 工坊脉络

A Foundations 根基 slides 1–15 CS Case 1 · Cyrene 案例一 · 昔兰尼 slides 16–35 CS2 Case 2 · Aphrodisias 案例二 · 阿芙罗狄西亚斯 slides 36–48 BR Bridge 两案小结 slides 49–51 B–K Ten exercises 十铭三阶 slides 52–122 L Synthesis 综合回顾 slides 123–128

Two case studies 两案对照

Case study 1 · 案例一 · 20 slides

C.101 · The Edicts of Augustus, Cyrene 奥古斯都之昔兰尼诏令

Monument-as-corpus. One stele, six imperial documents on a single root. 碑刻即语料。一石承六文, 同根成树。

Origin
Cyrene (Cyrenaica), 7/6 BCE & 4 BCE · IRCyr 2020
Encoding
nested <textpart> hierarchy · multi-level dating · godot.date
Tokens
1,346 words lemmatised · 6,820 letters · 584 supplied
Skill arc
line breaks, supplied letters, persName typology, named-entity linking
Begin the case study进入案例一
Case study 2 · 案例二 · 13 slides · next level

iAph 8 · The Archive Wall at Aphrodisias 阿芙罗狄西亚斯之档案墙

Corpus-as-monument. One wall, 21 documents, 280 years, 21 separate XML roots. 语料即碑刻。一墙、21 文、280 年, 21 棵独立的 XML 根。

Origin
Aphrodisias theatre, north parodos · IAph 2007
Encoding
cross-document @corresp · block-level <history> · ancient <del>
Transmission
17-witness stemma, 1705 → 2007 (Sherard → IAph)
Skill arc
relations between files, palaeographic specimens, titulature evolution, erasures
Begin the case study进入案例二
Bridge. Three slides synthesise what each case study teaches — and identify research questions and database-building tasks that one inscription, encoded well, opens up. 两案小结。三页综合两案所示, 并标出由"一铭善编"所开启的研究问题与数据库建设课题。
Open the bridge · 进入小结 →

Tools 工具

🎞
Slides幻灯片
128 bilingual slides — foundations, two case studies, ten exercises, synthesis. The main classroom artefact.128 张双语幻灯片,根基、两案、十铭、综合回顾。工坊主件。
👁
Four views四视图
One XML, four readings — Leiden / Web / Database / XML rendered side by side, for any of the ten inscriptions.一份 XML、四种视图,Leiden / Web / Database / XML 同屏并陈, 十铭皆可切换观看。
Playground试验场
Four panels — convention reference, live Leiden ⇄ XML conversion, document editor, multilingual editor. The hands-on tool.四个面板,规约速查、莱顿即时转 XML、文档编辑器、多语编辑器。动手编码就在此处。
📖
Lexicon词汇
A bilingual glossary of every EpiDoc element used in the workshop, with one-line role descriptions.本工坊所用 EpiDoc 元素的双语术语表, 每条一行角色说明。
🧩
Resolver解析器
Turn a plain-language description of an inscription into structured EpiDoc XML, field by field.把一段对铭文的白话描述, 逐字段解析为结构化的 EpiDoc XML。

The ten-text ladder 十铭三阶 · 由浅入深

Tier 1 · warmup 第一阶 · 入门
Tier 1–2 · crossing 过渡阶
Tier 2 · standard 第二阶 · 标准
Tier 3 · capstone 第三阶 · 毕业作品

Resources 参考与教学材料

📋
Instructor pack讲师包
Timing notes, classroom routes, peer-review pairings, submission templates, and answer keys.课堂时序、教学路线、互评配对、提交模板与答案钥。
📖
Element lexicon元素词汇
Every EpiDoc element used in the workshop with role and example — searchable, bilingual.工坊所用每一个 EpiDoc 元素附角色与示例,可检索, 双语对照。
📚
EpiDoc GuideEpiDoc 指南
The full Matrix Hub reference guide — Leiden conventions, P5 differences, all 363 elements.Matrix Hub 完整参考手册,莱顿规约、与 P5 之异、全部 363 元素。
Matrix Hub矩阵中枢
Return to the magalia.wiki Matrix Hub for adjacent corpora, editors, and case-study briefs.回到 magalia.wiki 矩阵中枢,邻近语料、编辑器与案例简报。

Lecture & further reading 讲座与延伸阅读

🎓
Boschetti & the ItAnt DSL领域专用语言讲座
A 48-slide bilingual lecture on domain-specific languages for epigraphy: the ItAnt case, the six risks, the five-condition gate, the agentic turn.关于铭文学领域专用语言的 48 页双语讲座: ItAnt 个案、六项风险、五条件之门、智能体转向。
🤖
EpiDoc XML or a DSL for AI?为 AI: XML 还是 DSL?
A companion assessment: which encoding layer best serves AI agents, retrieval pipelines, and model-in-the-loop scholarship.配套评估: 哪一编码层最适合 AI 智能体、检索流水线与模型在环的学术工作。
💬
Week 12 · interactive Q&A第 12 周互动问答
A bilingual question-and-answer set on the Boschetti paper and the ItAnt DSL, illustrated from the corpus.围绕 Boschetti 论文与 ItAnt DSL 的双语问答, 以语料库为例。
🧩
Week 13 · formulaic prediction第 13 周 · 公式化语言与预测
Nine interactive challenges on the limits of predictive restoration: abbreviation entropy, the D M flagship, circularity, and the Greek stoichedon grid.九项互动挑战, 检验预测性修复的限度: 缩写熵、D M 旗舰范例、循环论证与希腊方阵网格。
📑
Six papers on EpiDocEpiDoc 六篇论文
Notes on six papers in digital epigraphy and EpiDoc encoding: preserve, do not discard.数字铭文学与 EpiDoc 编码六篇论文的导读: 保存, 而非弃置。

Getting started 如何开始

Walk the slide deck end-to-end先把幻灯片从头看一遍
Open the slides and follow the arc — what EpiDoc is, the two case studies (Cyrene + Aphrodisias), what each of the ten inscriptions teaches, and the synthesis at the end.打开 幻灯片, 沿脉络走一遍:EpiDoc 是什么、两件案例 (昔兰尼 + 阿芙罗狄西亚斯)、十铭逐一所教、卷末综合回顾。
See one inscription from four sides从四个角度看一铭
Open four-views.html to see how one XML file simultaneously becomes Leiden / Web / Database / XML. Switch between any of the ten inscriptions.打开 four-views.html, 看同一份 XML 如何同时变为 Leiden / Web / Database / XML 四种视图; 十铭间可切换。
Pick an exercise and encode选一篇练习, 动手编码
Start with 01 Zethus (the simplest) and climb the ladder. Each exercise's title slide links straight into the playground with that inscription's stub pre-loaded.从最简的 01 Zethus 起步, 沿梯逐级而上。每篇练习的标题幻灯片即可直跳试验场, 并已为你预载该铭骨架。
Use the playground + lexicon together试验场配词汇表一起用
Type Leiden in the playground and watch XML emerge in real time; keep the lexicon in a second tab for tag glosses. Submit your work via the in-page submission widget.试验场 中输入莱顿, 看 XML 实时浮现; 另开一个 词汇表 标签随时查阅标签释义。可经页内提交件提交作业。