wiki-graph-core 0.3.1

package/data/help/topics/recipe.jinja

@@ -0,0 +1,151 @@
+Help Type: topic
+Topic: recipe
+
+Workflow Recipe
+
+Purpose:
+  Read this after root help. It is the practical workflow guide for Agents operating `.wikg` archives.
+  Use it to choose a starting point, interpret inspect output, answer questions from archive objects, and decide which topic to read next.
+
+Operating rules:
+  - Never unzip a `.wikg` archive, rewrite internal files, or bypass this CLI. Use CLI commands for archive edits.
+  - Use Wiki Graph URIs as stable object handles.
+  - Use `--json` when you want stable Agent-readable fields instead of human text. Whole `source` and `summary` objects are text streams, while ranged fragments such as `/source#20..30` support `--json`.
+  - If you have a URI and need valid operations, run `{{ commandName }} <uri> --help`.
+  - If you need concrete predicate usage for that URI type, run `{{ commandName }} <uri> <predicate> --help`.
+  - Never pass a bare filesystem path to URI-targeted commands.
+    /Users/me/book.wikg -> wikg:///Users/me/book.wikg
+    ./book.wikg -> wikg://book.wikg
+  - Treat returned short URIs as archive-relative handles. Add the archive locator before passing them back:
+    wikg://entity/Q8018 -> wikg:///absolute/path/book.wikg/entity/Q8018
+
+Choose your starting point:
+  - User gave you an existing `.wikg` archive:
+    Inspect before querying, generating, or editing.
+      {{ commandName }} wikg://book.wikg inspect
+
+  - User gave you source content and needs a reusable knowledge-base archive:
+    Create an empty `.wikg` archive, or create one while importing an EPUB.
+      {{ commandName }} wikg://book.wikg create
+      {{ commandName }} wikg://book.wikg create --import ./book.epub
+
+  - User needs one-shot conversion without keeping an archive:
+    Use transform. Source input usually requires LLM configuration.
+      cat chapter.txt | {{ commandName }} transform --input-format txt --output-format markdown
+
+  - User needs a chapter-level file:
+    Read the chapter object and use Unix pipes or redirection. `/source` prints original source text; `/summary` prints the chapter summary.
+      {{ commandName }} wikg://book.wikg/chapter/3/source > chapter-3-source.md
+      {{ commandName }} wikg://book.wikg/chapter/3/summary > chapter-3-summary.md
+
+After inspect:
+  - If the archive is ready for retrieval, use `--query` on a scope or open the URI that inspect suggests.
+    {{ commandName }} wikg:///Users/me/book.wikg --query "attention memory"
+    {{ commandName }} wikg:///Users/me/book.wikg/chapter/3 --query "attention"
+
+  - If inspect reports missing or unavailable index support, inspect the index target before enabling anything.
+    {{ commandName }} <archive-uri>/index --help
+    {{ commandName }} <archive-uri>/index enable --help
+    Read readiness before deciding whether to keep the index local or embed it:
+      {{ commandName }} help readiness
+
+  - If Reading Graph data is missing, chunk `--query`, related expansion, and pack may be unavailable or incomplete.
+    Inspect job help before starting generated work.
+      {{ commandName }} wikg://local/job --help
+      {{ commandName }} wikg://local/job add --help
+      {{ commandName }} help readiness
+
+  - If Knowledge Graph data is missing, entity and triple retrieval may be unavailable or incomplete.
+    Knowledge Graph generation needs configuration and may require WikiSpine provider setup.
+      {{ commandName }} help config
+      {{ commandName }} help readiness
+
+  - If summaries are missing, summary reads and summary-based exports may be incomplete.
+    Check the chapter or archive readiness before relying on summaries.
+
+Finding material:
+  `--query` uses indexed full-text retrieval. Treat it like grep/find with Google-like keyword input.
+
+  - Need document structure, chapter readiness, or chapter-local scope:
+    {{ commandName }} wikg://book.wikg/chapter
+    {{ commandName }} wikg://book.wikg/chapter/3
+
+  - Need to understand a concept, person, place, term, or object:
+    Use `--query` on entity scopes with source evidence, then ground, expand, or pack from the entity URI.
+      {{ commandName }} wikg://book.wikg/entity --query "attention" --evidence 2
+      {{ commandName }} wikg://book.wikg/chapter/3/entity --query "attention" --evidence 2
+      {{ commandName }} wikg://book.wikg/entity/Q8018
+      {{ commandName }} wikg://book.wikg/entity/Q8018 evidence
+      {{ commandName }} wikg://book.wikg/entity/Q8018 related --query "memory"
+      {{ commandName }} wikg://book.wikg/entity/Q8018 pack --budget 5000
+    Do not rely on label-only matching as the primary path for known entities; aliases, translations, and variants may not match the label.
+    Entity scopes can be archive-wide (`<archive-uri>/entity`) or chapter-limited (`<chapter-uri>/entity`).
+
+  - Need to trace a relation, claim, or subject-predicate-object connection:
+    Use `--query` on triple scopes with source evidence, then open or ground the triple object.
+      {{ commandName }} wikg://book.wikg/triple --query "attention memory" --evidence 2
+      {{ commandName }} wikg://book.wikg/chapter/3/triple --query "attention memory" --evidence 2
+      {{ commandName }} wikg://book.wikg/triple/Q8018/discusses/Q123
+      {{ commandName }} wikg://book.wikg/triple/Q8018/discusses/Q123 evidence
+    Triple scopes can be archive-wide (`<archive-uri>/triple`) or chapter-limited (`<chapter-uri>/triple`).
+    Related expansion is available from chunk and entity objects; for a triple, expand through its subject or object entity.
+      {{ commandName }} wikg://book.wikg/entity/Q8018 related --query "memory" --evidence 2
+
+  - Need literal source wording:
+    Use `--query` on the narrowest useful scope.
+      {{ commandName }} wikg:///Users/me/book.wikg --query "attention memory"
+      {{ commandName }} wikg:///Users/me/book.wikg/chapter/3 --query "attention"
+      {{ commandName }} wikg://book.wikg/chapter/3/source#20..30
+      {{ commandName }} wikg://book.wikg/chapter/3/source#23..45
+
+  - Need the latest source evidence for a known object:
+    Use `--reverse` without `--query`; read `{{ commandName }} help uri` for Document Flow order.
+      {{ commandName }} wikg://book.wikg/entity/Q8018 evidence --reverse --limit 1
+
+  - Need summary wording:
+    Read summary objects or summary ranges, then verify important claims through related chunk, entity, or triple evidence.
+      {{ commandName }} wikg://book.wikg/chapter/3/summary
+      {{ commandName }} wikg://book.wikg/chapter/3/summary#23..45
+      {{ commandName }} wikg://book.wikg/chapter/3/chunk --query "attention" --evidence 2
+
+  - Need Reading Graph chunks:
+    Use `--query` on chunk scopes with source evidence, then open or expand from useful chunk objects.
+      {{ commandName }} wikg://book.wikg/chunk --query "attention memory" --evidence 2
+      {{ commandName }} wikg://book.wikg/chapter/3/chunk --query "attention" --evidence 2
+      {{ commandName }} wikg://book.wikg/chunk
+      {{ commandName }} wikg://book.wikg/chunk/123 evidence
+      {{ commandName }} wikg://book.wikg/chunk/123 related --query "attention" --evidence 2
+
+  - Need quick compressed understanding before returning to source evidence:
+    Read summaries, then verify important claims with evidence.
+      {{ commandName }} wikg://book.wikg/chapter/3/summary
+
+  - Need an inventory for a script or Unix pipeline:
+    Use `--all --jsonl` to export the selected scope as line-delimited records, then filter with standard stream tools.
+    Prefer the narrowest useful scope before full export.
+      {{ commandName }} wikg://book.wikg/entity --all --jsonl
+      {{ commandName }} wikg://book.wikg/triple --all --jsonl
+      {{ commandName }} wikg://book.wikg/chunk --all --jsonl
+      {{ commandName }} wikg://book.wikg/chapter/3/entity --all --jsonl
+      {{ commandName }} wikg://book.wikg/chapter/3/triple --all --jsonl
+      {{ commandName }} wikg://book.wikg/chapter/3/chunk --all --jsonl
+
+  - Need bounded Agent-readable context around an object:
+    Use pack only after choosing a located chunk or entity URI.
+      {{ commandName }} wikg:///Users/me/book.wikg/entity/Q8018 pack --budget 5000
+
+  - Need more results from a paged response:
+    Continue with the cursor returned by the previous command.
+      {{ commandName }} next <cursor>
+
+When to read deeper:
+  - URI details, scope/object routing, pagination, and short URI handling:
+    {{ commandName }} help uri
+  - Format inference, stdin/stdout, create/import, export, transform, JSON, JSONL, and pipe output:
+    {{ commandName }} help format
+  - LLM, concurrency, and WikiSpine provider setup:
+    {{ commandName }} help config
+  - FTS index, LLM, WikiSpine, and generated-data prerequisites:
+    {{ commandName }} help readiness
+  - Workers, cache, logs, workspaces, failures, and JSONL progress:
+    {{ commandName }} help runtime

package/data/help/topics/runtime.jinja

@@ -0,0 +1,62 @@
+Help Type: topic
+Topic: runtime
+
+Runtime and Debug Behavior
+
+Purpose:
+  This is a low-frequency advanced topic. Read it when a command fails, a job appears stuck, JSON/JSONL behavior matters, or you need to understand workers, cache, logs, and workspaces.
+
+Archive-first streams:
+  - `{{ commandName }} <archive-uri> create` creates an empty archive; it does not read stdin.
+  - `{{ commandName }} <archive-uri> create --import <epub-path>` imports EPUB source into a new archive.
+  - `{{ commandName }} <archive-uri> export --output-format markdown|txt` can write text projections to stdout.
+  - `{{ commandName }} transform --input-format markdown|txt --output-format markdown|txt` runs direct one-shot stream digest/export and usually requires LLM configuration.
+  - Retrieval commands print human-readable text by default and support `--json` where documented.
+  - A bare `{{ commandName }}` in an interactive terminal prints root help.
+  - A bare non-interactive `{{ commandName }}` invocation is not a transform shortcut; use `{{ commandName }} transform`.
+
+Exit behavior:
+  - Success returns exit code 0.
+  - Failures return non-zero.
+  - Commands that accept `--json` or `--jsonl` emit machine-readable error objects when those flags are present.
+  - Commands without machine-readable output support print plain-text errors.
+
+Generation job behavior:
+  - Reading Graph, Reading Summary, and Knowledge Graph generation run as device-local jobs.
+  - Generation jobs consume LLM tokens, may incur provider charges, and can run for minutes to hours on large archives.
+  - `wikg://local/job add` requires `--accept-cost` as an explicit cost/time acknowledgement.
+  - Job records live under `~/.{{ commandName }}/jobs`.
+  - `wikg://local/job add`, `wikg://local/job/<job-id> resume`, `wikg://local/job/<job-id> boost`, and `wikg://local/job/<job-id>/target set` try to start a transient worker.
+  - The worker exits after idle time; it is not intended to be a permanent daemon.
+  - `wikg://local/job/<job-id> watch --jsonl` is the stable agent-facing progress stream.
+  - `wikg://local/config/concurrent` controls job and LLM request concurrency.
+
+Progress and diagnostics:
+  - Job progress is recorded as durable events and exposed by `wikg://local/job/<job-id> watch`.
+  - `status_snapshot` events include counters and token usage when the LLM provider reports it.
+  - `transform --verbose` writes diagnostic logs to stderr.
+  - Use `{{ commandName }} <archive-uri> inspect` before starting or debugging generation work.
+  - Use `{{ commandName }} <archive-uri>/index --help` when `--query`, evidence, or related appears unavailable.
+
+Workspace behavior:
+  - Archive creation and EPUB import use temporary workspaces.
+  - `transform --digest-dir <path>` uses the provided digest workspace for source digest runs.
+  - Generation jobs use per-job directories under `~/.{{ commandName }}/jobs/work`, `~/.{{ commandName }}/jobs/cache`, and `~/.{{ commandName }}/jobs/logs`.
+  - Succeeded jobs delete their workspace by default.
+  - Failed and canceled jobs keep their workspace for debugging until cleanup.
+  - Job events, logs, and LLM cache are kept until the job record is cleaned.
+
+In-place archive edits:
+  - Mutating `.wikg` commands go through the archive coordinator.
+  - Active generation jobs block destructive chapter maintenance edits for the same chapter.
+  - Archive writes are coordinated through `~/.{{ commandName }}/staging`.
+
+Where to go next:
+  - Need the normal workflow before debugging:
+    {{ commandName }} help recipe
+  - Need FTS/generation prerequisites before debugging:
+    {{ commandName }} help readiness
+  - Need legal format combinations:
+    {{ commandName }} help format
+  - Need URI command routing:
+    {{ commandName }} help uri

package/data/help/topics/uri.jinja

@@ -0,0 +1,178 @@
+Help Type: topic
+Topic: uri
+
+Wiki Graph URIs
+
+Purpose:
+  URI targets are the address and routing layer for Wiki Graph commands.
+  Use this page to choose a target, understand scope/object behavior, and select retrieval shape.
+
+Archive locator:
+  - Archive/object command URIs must contain a `.wikg` locator.
+  - Do not pass a bare filesystem path as a command target.
+    /Users/me/book.wikg -> wikg:///Users/me/book.wikg
+    ./book.wikg -> wikg://book.wikg
+    C:\Users\me\book.wikg -> wikg://C:/Users/me/book.wikg
+  - URI paths use `/` separators, including on Windows.
+  - Absolute archive locators use `wikg:///`, for example `wikg:///books/book.wikg`.
+  - Relative archive locators use `wikg://`, for example `wikg://book.wikg`.
+  - Home archive locators may start with `wikg://~/`; `~` is expanded only in that leading form.
+  - The first path segment ending in `.wikg` is the archive/object boundary.
+
+Short and located URIs:
+  Commands may return short object URIs without local file paths:
+    wikg://chapter/3/title
+    wikg://chapter/3/source#4..8
+    wikg://chunk/12
+    wikg://entity/Q8018
+    wikg://triple/Q8018/discusses/Q123
+  Returned short URIs are archive-relative handles, not complete command targets.
+  Add the archive locator before passing them back to commands:
+    wikg://book.wikg/entity/Q8018
+    wikg:///books/book.wikg/chapter/3/source#4..8
+
+Command routing:
+  - `{{ commandName }} <scope-uri>` enumerates objects.
+  - `{{ commandName }} <scope-uri> --query <query>` applies keyword retrieval within that scope.
+  - `{{ commandName }} <object-uri>` reads one object.
+  - `{{ commandName }} <uri> --help` explains that URI target and its supported predicates.
+  - `{{ commandName }} <uri> <predicate> --help` explains a URI-bound predicate.
+
+Common command shapes:
+  {{ commandName }} <scope-uri>
+  {{ commandName }} <scope-uri> --query <query>
+  {{ commandName }} <object-uri>
+  {{ commandName }} <chunk-uri|entity-uri> related
+  {{ commandName }} <entity|triple|chunk-uri> evidence
+  {{ commandName }} <located-chunk-uri|located-entity-uri> pack
+  {{ commandName }} next <cursor>
+  {{ commandName }} <archive-uri> create [--import <epub-path>]
+  {{ commandName }} <archive-uri> export --output-format <format>
+  {{ commandName }} <archive-uri> inspect
+  {{ commandName }} transform [options]
+  {{ commandName }} wikg://local/job
+  {{ commandName }} wikg://local/job add --input <archive-uri|chapter-uri> --task <reading-graph|reading-summary|knowledge-graph> --accept-cost
+  {{ commandName }} wikg://local/job/<job-id>
+  {{ commandName }} <object-uri> related
+  {{ commandName }} <object-uri> evidence
+  {{ commandName }} <object-uri> pack --budget 5000
+
+Scope URIs:
+  Scope URIs enumerate objects by default. With `--query <query>`, they apply keyword retrieval within that scope.
+    wikg://book.wikg
+    wikg://book.wikg/chapter
+    wikg://book.wikg/chapter/3
+    wikg://book.wikg/chapter/3/chunk
+    wikg://book.wikg/chapter/3/entity
+    wikg://book.wikg/chapter/3/triple
+    wikg://book.wikg/chunk
+    wikg://book.wikg/entity
+    wikg://book.wikg/triple
+    wikg://book.wikg/triple/Q8018
+    wikg://book.wikg/triple/Q8018/discusses
+    wikg://book.wikg/triple/Q8018/_/Q123
+
+Object URIs:
+  Object URIs read one object by default.
+    wikg://book.wikg/chapter/3/title
+    wikg://book.wikg/chapter/3/state
+    wikg://book.wikg/chapter/3/source
+    wikg://book.wikg/chapter/3/source#4..8
+    wikg://book.wikg/chapter/3/summary
+    wikg://book.wikg/chapter/3/summary#4..8
+    wikg://book.wikg/chapter/3/chunk/12
+    wikg://book.wikg/chapter/3/entity/Q8018
+    wikg://book.wikg/chapter/3/triple/Q8018/discusses/Q123
+    wikg://book.wikg/chunk/12
+    wikg://book.wikg/entity/Q8018
+    wikg://book.wikg/entity/Q8018/wikipage
+    wikg://book.wikg/triple/Q8018/discusses/Q123
+
+Triple pattern scopes:
+  Use `_` as an any-value placeholder for subject, predicate, or object:
+    wikg://book.wikg/triple/Q8018/_/Q123
+    wikg://book.wikg/triple/_/_/Q123
+  Trailing placeholders may be omitted:
+    wikg://book.wikg/triple/Q8018
+    wikg://book.wikg/triple/Q8018/discusses
+  Any triple URI with `_` or omitted trailing subject/predicate/object parts is a scope URI.
+  A complete triple URI with concrete subject, predicate, and object is an object URI.
+
+Object boundaries:
+  - `chapter/<id>` is a scope, not an object.
+  - `chapter/<id>/title` is the queryable chapter title object.
+  - Whole `source` and `summary` objects are readable text streams, not collection scopes.
+  - Ranged fragments such as `/source#4..8` and `/summary#4..8` are structured range objects.
+  - Source and summary range numbers are 1-based and inclusive. `/source#1..2` means the first two source sentences.
+  - Source text is the grounding material. `evidence` is not available for source, summary, or chapter scope URIs.
+  - `chunk`, `entity`, and `triple` can return source-backed evidence.
+
+Retrieval strategy:
+  1. Choose the narrowest URI scope that can answer the task.
+  2. Choose the object lens that matches the question.
+  3. Start with a bounded page.
+  4. Use `--all` only for an intentional full export or bounded inventory.
+
+Document Flow order:
+  Without `--query`, multi-object results and source/summary evidence follow Document Flow order.
+  Document Flow order means `/chapter/tree` preorder chapter traversal, then source or summary ranges from the start of each chapter to the end.
+  Use `--reverse` when you need the same flow backward, for example to find the latest source occurrence of a known object.
+  `--reverse` cannot be combined with `--query`; query results use indexed match ranking instead.
+
+Lens selection:
+  - Use `<archive-uri>` when the whole archive is the right retrieval scope.
+  - Use `<chapter-uri>` when a known chapter is enough.
+  - Use `<chapter-uri>/<lens>` when both chapter and object kind are known.
+  - `/chunk` targets Reading Graph chunks.
+  - `/entity` targets grounded entities.
+  - `/triple` targets Knowledge Graph relations.
+  - `chapter/<id>` is a scope; `--query` over chapter titles returns `chapter/<id>/title` objects.
+
+Literal source passages:
+  Use `--query` on the narrowest useful scope when the task is to find source wording or passages mentioning a literal term:
+    {{ commandName }} <archive-uri> --query "term"
+    {{ commandName }} <archive-uri>/chapter/<id> --query "term"
+    {{ commandName }} <archive-uri>/chapter/<id>/source#20..30
+
+Entity-grounded evidence:
+  Use entity evidence when you already have an entity URI or QID and need grounded mentions, aliases, translations, variants, or source-backed support:
+    {{ commandName }} <archive-uri>/entity/<qid> evidence
+    {{ commandName }} <archive-uri>/entity/<qid> related --query "aspect" --evidence 2
+    {{ commandName }} <archive-uri>/entity/<qid> evidence --reverse --limit 1
+
+Pagination:
+  - Use default paging or `--limit <n>` while exploring.
+  - Use `{{ commandName }} next <cursor>` to continue a paged result.
+  - Use `--all` only when you intentionally need every item from the selected scope.
+  - Prefer the narrowest scope before using `--all`.
+  - Read `{{ commandName }} help format` before choosing text, `--json`, `--jsonl`, or `--all --jsonl` for machine consumption.
+
+Recovery hints:
+  - No `--query` results: try fewer keywords, use a broader scope URI, or inspect chapter readiness and structure.
+    {{ commandName }} <archive-uri>/chapter
+    {{ commandName }} <archive-uri>/chapter/tree
+    {{ commandName }} help readiness
+  - Missing generated objects: start the relevant generation job for the chapter.
+    {{ commandName }} wikg://local/job add --input <archive-uri|chapter-uri> --task reading-graph --accept-cost
+    {{ commandName }} wikg://local/job add --input <archive-uri|chapter-uri> --task reading-summary --accept-cost
+    {{ commandName }} help readiness
+    {{ commandName }} help runtime
+  - URI rejected: convert bare filesystem paths to Wiki Graph URIs, and prepend the archive locator to short object URIs.
+  - Help did not appear: append `--help` to the URI or URI-bound predicate you are trying to inspect.
+
+Job URIs:
+  Local jobs use the `wikg://local/job/` scheme and do not contain `.wikg` locators:
+    {{ commandName }} wikg://local/job
+    {{ commandName }} wikg://local/job/<job-id> --json
+    {{ commandName }} wikg://local/job/<job-id> watch --jsonl
+
+Archive internals:
+  Do not unzip `.wikg` or read internal SQLite for routine retrieval. Use URI commands.
+
+Related help:
+  - Search index, generated data, and provider prerequisites:
+    {{ commandName }} help readiness
+  - Stdin/stdout, create/import, export, transform, JSON, JSONL, and pipe-oriented output:
+    {{ commandName }} help format
+  - Local jobs, cache, logs, and runtime debugging:
+    {{ commandName }} help runtime

package/data/output/epub/cover.xhtml.jinja

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{{ language }}" lang="{{ language }}">
+  <head>
+    <title>{{ title }}</title>
+    <style>
+      body { margin: 0; padding: 0; }
+      img { display: block; height: auto; width: 100%; }
+    </style>
+  </head>
+  <body>
+    <img src="../{{ coverImageHref }}" alt="{{ title }}"/>
+  </body>
+</html>

package/data/output/epub/nav.xhtml.jinja

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" xml:lang="{{ language }}" lang="{{ language }}">
+  <head>
+    <title>{{ title }}</title>
+  </head>
+  <body>
+    <nav epub:type="toc" id="toc">
+      <h1>{{ title }}</h1>
+      {{ itemsMarkup | safe }}
+    </nav>
+  </body>
+</html>

package/data/output/epub/package.opf.xml.jinja

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<package version="{{ version }}" unique-identifier="book-id" xmlns="http://www.idpf.org/2007/opf">
+  <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
+    <dc:identifier id="book-id">{{ identifier }}</dc:identifier>
+    <dc:title>{{ title }}</dc:title>
+    <dc:language>{{ language }}</dc:language>
+{% for author in authors %}
+    <dc:creator>{{ author }}</dc:creator>
+{% endfor %}
+{% if publisher %}
+    <dc:publisher>{{ publisher }}</dc:publisher>
+{% endif %}
+{% if publishedAt %}
+    <dc:date>{{ publishedAt }}</dc:date>
+{% endif %}
+{% if description %}
+    <dc:description>{{ description }}</dc:description>
+{% endif %}
+    <meta property="dcterms:modified">{{ modifiedAt }}</meta>
+  </metadata>
+  <manifest>
+    <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/>
+{% for section in sections %}
+    <item id="{{ section.id }}" href="{{ section.href }}" media-type="application/xhtml+xml"/>
+{% endfor %}
+{% if coverImageHref %}
+    <item id="cover-image" href="{{ coverImageHref }}" media-type="{{ coverMediaType or "application/octet-stream" }}" properties="cover-image"/>
+    <item id="cover-page" href="{{ coverPageHref or "text/cover.xhtml" }}" media-type="application/xhtml+xml"/>
+{% endif %}
+  </manifest>
+  <spine>
+{% if coverPageHref %}
+    <itemref idref="cover-page"/>
+{% endif %}
+{% for section in sections %}
+    <itemref idref="{{ section.id }}"/>
+{% endfor %}
+  </spine>
+</package>

package/data/output/epub/section.xhtml.jinja

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{{ language }}" lang="{{ language }}">
+  <head>
+    <title>{{ title }}</title>
+  </head>
+  <body>
+    <h1>{{ title }}</h1>
+{% for paragraph in paragraphs %}
+    <p>{{ paragraph }}</p>
+{% endfor %}
+  </body>
+</html>