# Eulogikon

> Free, open-source digital library of ancient Greek texts. 1,343 authors and
> 4,030 works, all public domain (Public Domain Mark 1.0). Covers Homer through
> late antiquity. Texts are addressed by stable identifiers (`eul_aid` for
> authors, `eul_wid` for works) and citable to passage level via the TLA
> system: SID/RID in citation strings, RID-shaped URL fragments (`#{rid}`).

This site is built for agent consumption. The primary entry point for
programmatic access is the Agent Skills Discovery surface described below.
Public-domain content — no attribution required, no authentication, no rate
limits beyond ordinary courtesy.

## Citing the corpus

The archived Eulogikon corpus has a Zenodo concept DOI (resolves to the latest
archived version): https://doi.org/10.5281/zenodo.20335422

## Agent Skills (start here)

- [Discovery index](https://eulogikon.org/.well-known/agent-skills/index.json) — Cloudflare Agent Skills Discovery RFC v0.2.0
- [SKILL.md](https://eulogikon.org/.well-known/agent-skills/eulogikon-corpus/SKILL.md) — full instructions: identifiers, workflows, citation format, the data files and what's in each

## Structured data

- [Top-level corpus index](https://eulogikon.org/data/index.json) — counts and unified author + work listing
- [Authors](https://eulogikon.org/data/authors.json) — 1,343 authors keyed by `eul_aid`, with `author_display_string`, period, dialect, affiliation, era, floruit dates
- [Works](https://eulogikon.org/data/works.json) — 4,030 works keyed by `eul_wid`, with titles (English + Greek), classification denormalized from author for single-pass filtering, the work's `work_display_string`, and the composed universal `name` for each work
- [SEO metadata](https://eulogikon.org/data/seo_metadata.json) — per-page title/description/canonical URL/language

## Fetching Greek text

1. Resolve the work by **`eul_wid`** in `/data/works.json` (never by display string or title alone).
2. Read the row's `name` field. The `name` is the universal artefact stem `{work_display_string}-{eul_wid}` — same string as the URL and the file name.
3. Fetch Markdown at `https://eulogikon.org/works/{name}.md` (preferred for agents) or HTML at `https://eulogikon.org/works/{name}`.

Canonical work JSON is backend-only and is not published on the public site.

Bulk download of PDF, Markdown, plain text, and JSON exports lives in the separate
**`eulogikon/ancient-greek-texts`** GitHub repository — see SKILL.md for manifest
files keyed by `eul_wid`.

## Conventions

- **Identifiers:** `eul_aid` (author, opaque three-letter code) and `eul_wid` (work, `{eul_aid}-{suffix}`) are the sole reference keys. `sid` (within-work point, 3-segment TLA) and `rid` (within-work range, 4-segment TLA) address passages. All are stable and never reissued.
- **Display strings are not identifiers.** `author_display_string` and `work_display_string` are mutable URL attributes. Do not construct URLs by hand from names or titles — always look up `eul_aid` / `eul_wid` in the JSON indexes first.
- **One universal name per artefact.** Every artefact for a work (URL, HTML file, Markdown file, JSON record) uses the same string `{work_display_string}-{eul_wid}`, exposed in `works.json` as the `name` field. Authors follow the same pattern: `{author_display_string}-{eul_aid}`.
- **URL grammar (Greek corpus on eulogikon.org):**
  - Author page: `https://eulogikon.org/authors/{author_display_string}-{eul_aid}`
  - Work HTML: `https://eulogikon.org/works/{work_display_string}-{eul_wid}[#{rid}]`
  - Work Markdown: `https://eulogikon.org/works/{work_display_string}-{eul_wid}.md`
- **Markdown variants:** every work page has an agent-facing markdown variant at the same path with a `.md` extension. YAML frontmatter carries `eul_wid`, canonical URLs, classification, and license; the body has the full Greek text with each unit ref as an H3 citation anchor. Agents that send `Accept: text/markdown` against the clean URL get a 308 redirect to the `.md`. Markdown is typically ~40% the size of the HTML for the same content.
- **Rights:** Public Domain Mark 1.0 on all corpus content. Eulogikon publishes public-domain Greek texts in cleaned, structured, readable form and makes no copyright claim over that preparation.

## Optional

- [Full corpus census](https://eulogikon.org/llms-full.txt) — every author + work enumerated in one markdown file (~900 KB). Use this for one-shot ingestion when you want a complete map of the corpus shape without fetching every JSON. Metadata only — resolve each work by `eul_wid`, then fetch Markdown for the Greek text.
- [Sitemap](https://eulogikon.org/sitemap.xml) — every author and work page
- [Homepage](https://eulogikon.org/) — for humans
- [Landing page for agent developers](https://eulogikon.org/for-agents) — install command, worked example, and conventions in plain English

## Attribution

When citing, use: **Eulogikon** (https://eulogikon.org) or the Zenodo DOI: https://doi.org/10.5281/zenodo.20335422

Sitemap: https://eulogikon.org/sitemap.xml
Contact: https://eulogikon.org/contact
Behavioral guidance for AI systems: https://eulogikon.org/ai.txt
AI Discovery Files specification: https://www.ai-visibility.org.uk/specifications/