From ead2f79ee41db99a292d763fe41f0613a74ef7b3 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Fri, 25 Sep 2026 20:49:49 -0400 Subject: a blank first text line was being lost MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit An object whose first text line is blank lost it. The parser decided whether to start a new line by asking whether the accumulated text was empty, which is not the same question as whether a text line has been seen: for an object opening on a blank line the first line left the text empty and the second overwrote it rather than appending. Seven documents of the markup document samples have verse opening on a blank line, and in every one of them the blank was dropped, so the html, the plain text and the JSONL chunks all began the verse a line early. Spine's own text output has the blank line; this now matches. Found by loading one document as .ssp and as .ocda.db and comparing the two models object by object, which is what sisudoc-ocda-lib exists to do. The comparison between the two .ssp readers had not caught it, being on section counts, which the defect does not disturb. Also: the repository is named sisudoc-ssp-reader, prefixed as every repository of this project's own is (binary, package and module names are unchanged), and the sources follow the specification directory's name, sisudoc-abstraction-format. And the /+ ↓ +/ comment arrows in ssp_parser.d, double-encoded by the in-place edit that applied the fix, are restored; comment text only. (assisted by Claude-Code) --- dlang/README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'dlang/README.md') diff --git a/dlang/README.md b/dlang/README.md index fa39eab..bb0aefd 100644 --- a/dlang/README.md +++ b/dlang/README.md @@ -1,4 +1,4 @@ -# ssp-reader +# ssp-reader, in D Reader for the **`.ssp` document-abstraction text format** emitted by [sisudoc-spine](https://git.sisudoc.org/projects/sisudoc-spine). @@ -44,7 +44,7 @@ Spine's processing pipeline has three stages: `ssp-reader` picks up the abstraction at the end of stage 2 (the `.ssp` file) and runs alternative stage-3 renderings on top of it. The `.ssp` format itself is documented in -[`doc-abstraction-format`](https://git.sisudoc.org/tools/doc-abstraction-format). +[`sisudoc-abstraction-format`](https://git.sisudoc.org/tools/sisudoc-abstraction-format). ## Quickstart @@ -127,7 +127,7 @@ the HTML, in the plain text, and as an embedding chunk in the JSONL. Fixed, and the reason the report exists. That is deliberate and is what makes the reader usable as a check on the -[format specification](https://git.sisudoc.org/specs/doc-abstraction-format): +[format specification](https://git.sisudoc.org/specs/sisudoc-abstraction-format): a reader that drops what it does not know is conforming, but one that cannot say what it dropped cannot tell you whether the specification it was written from was complete. Silence and understanding look alike otherwise. @@ -135,7 +135,7 @@ written from was complete. Silence and understanding look alike otherwise. ## Documentation - The `.ssp` format itself: see - [doc-abstraction-format](https://git.sisudoc.org/tools/doc-abstraction-format). + [sisudoc-abstraction-format](https://git.sisudoc.org/tools/sisudoc-abstraction-format). - Source: [`src/`](src/) - one module per output format (`output_tree.d`, `output_html.d`, `output_llm_breadcrumbs.d`, `output_llm_jsonl.d`, `output_images.d`, `verify_images.d`), plus @@ -149,14 +149,14 @@ project for full licence text. ## Repository -- **Canonical URL:** https://git.sisudoc.org/tools/ssp-reader -- **Clone:** `git clone --depth=1 git://git.sisudoc.org/tools/ssp-reader` +- **Canonical URL:** https://git.sisudoc.org/tools/sisudoc-ssp-reader +- **Clone:** `git clone --depth=1 git://git.sisudoc.org/tools/sisudoc-ssp-reader` ## Related projects - [sisudoc-spine](https://git.sisudoc.org/projects/sisudoc-spine) - produces the `.ssp` files this tool consumes. -- [doc-abstraction-format](https://git.sisudoc.org/tools/doc-abstraction-format) - +- [sisudoc-abstraction-format](https://git.sisudoc.org/tools/sisudoc-abstraction-format) - specification of the `.ssp` text format. - [tree-sitter-sisu](https://git.sisudoc.org/tools/tree-sitter-sisu) - tree-sitter grammar for the upstream `.sst` / `.ssm` markup. -- cgit v1.2.3