<feed xmlns='http://www.w3.org/2005/Atom'>
<title>sisudoc-spine/src/sisudoc/outputs/io_out/source_pod.d, branch main</title>
<subtitle>SiSU Spine: document publishing and search (in D) 2015</subtitle>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/'/>
<entry>
<title>org files mostly headers</title>
<updated>2026-10-25T00:45:37+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-10-24T22:41:41+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=2a55a61d10739e782a82fcb438607e552148fbd9'/>
<id>2a55a61d10739e782a82fcb438607e552148fbd9</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>cleanup: misc. (previously deferred)</title>
<updated>2026-09-22T21:16:20+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T18:29:48+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=9f93ed4ced8e7434b89e93b50c3464e34e4767fb'/>
<id>9f93ed4ced8e7434b89e93b50c3464e34e4767fb</id>
<content type='text'>
dr_document_make in three identifier spellings becomes document_make,
which is what the file has been called since the rename.

The mixin import audit, a template declares its imports at template
scope and they are then visible in every scope it is mixed into (which
is how a template-level split once hijacked a UFCS lookup in code that
had not been touched). Disabling htmlSnippet's imports and rebuilding
names the consumers that were relying on them rather than on their own:
across twelve mixin sites, exactly one. metadata.d now imports the `to`
it uses. The templates keep their imports, their own functions needing
them, and narrowing those is a change of its own rather than a cleanup.

And the standing FIX in source_pod.d: the insert digest line for a non
pod source recorded the insert's path, where every other line in
digests.txt is a filename and a digest naming a file that is not in
the pod under that name cannot be checked against it.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
dr_document_make in three identifier spellings becomes document_make,
which is what the file has been called since the rename.

The mixin import audit, a template declares its imports at template
scope and they are then visible in every scope it is mixed into (which
is how a template-level split once hijacked a UFCS lookup in code that
had not been touched). Disabling htmlSnippet's imports and rebuilding
names the consumers that were relying on them rather than on their own:
across twelve mixin sites, exactly one. metadata.d now imports the `to`
it uses. The templates keep their imports, their own functions needing
them, and narrowing those is a change of its own rather than a cleanup.

And the standing FIX in source_pod.d: the insert digest line for a non
pod source recorded the insert's path, where every other line in
digests.txt is a filename and a digest naming a file that is not in
the pod under that name cannot be checked against it.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>digests: db digest taken once on file completion</title>
<updated>2026-09-22T18:54:35+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T15:52:52+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=b0084e0d55595b1d1cc93a088ae3c841220cddc6'/>
<id>b0084e0d55595b1d1cc93a088ae3c841220cddc6</id>
<content type='text'>
One file for the document (including all languages) with digest of the
document. digests.txt lists it once, beside the shared images, taken
when the last language has been written.

digests.txt carries all digests.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
One file for the document (including all languages) with digest of the
document. digests.txt lists it once, beside the shared images, taken
when the last language has been written.

digests.txt carries all digests.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>pod: carry tools/po4a, the translation working set</title>
<updated>2026-09-22T18:08:10+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T14:04:40+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=a32230d9ede2cf3a4f85547e6793b8918c72af30'/>
<id>a32230d9ede2cf3a4f85547e6793b8918c72af30</id>
<content type='text'>
A pod now carries its catalogues, so a translation can be updated
rather than only retyped: providing the .pot and .po (the means of
maintaining it).

A directory walk, where every other thing the pod writer carries is
named. A catalogue set is whatever the translator has, and enumerating
.pot and .po files would mean the writer deriving the document's
languages a second time, from a second place, to say what it already
reads from the manifest.

Done once, on the last language, as the markup blocks are. The tree is
not language specific, so a pass for each language would re-read all of
it, 5.5 MB ten times over for live-manual, into an archive the next pass
overwrites.

Every name is checked before it is carried, by the rule the pod reader
applies to an archive it is handed. The writer is reading a directory
someone else may have filled, which is the reason the reader checks.

The cost is small, and it is the whole argument for compressing the
archive as a stream rather than per member:

  uncompressed content   6972418 -&gt; 13167489   +89%
  the .sisupod            692942 -&gt;   891388   +28.6%

5.5 MB of catalogues cost 198 KB, because the .po files largely repeat
markup already in the archive and whole-stream compression sees it.
Per-member deflate could not.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
A pod now carries its catalogues, so a translation can be updated
rather than only retyped: providing the .pot and .po (the means of
maintaining it).

A directory walk, where every other thing the pod writer carries is
named. A catalogue set is whatever the translator has, and enumerating
.pot and .po files would mean the writer deriving the document's
languages a second time, from a second place, to say what it already
reads from the manifest.

Done once, on the last language, as the markup blocks are. The tree is
not language specific, so a pass for each language would re-read all of
it, 5.5 MB ten times over for live-manual, into an archive the next pass
overwrites.

Every name is checked before it is carried, by the rule the pod reader
applies to an archive it is handed. The writer is reading a directory
someone else may have filled, which is the reason the reader checks.

The cost is small, and it is the whole argument for compressing the
archive as a stream rather than per member:

  uncompressed content   6972418 -&gt; 13167489   +89%
  the .sisupod            692942 -&gt;   891388   +28.6%

5.5 MB of catalogues cost 198 KB, because the .po files largely repeat
markup already in the archive and whole-stream compression sees it.
Per-member deflate could not.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>pod: set entry limit for the writer and reader</title>
<updated>2026-09-22T18:03:39+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T13:46:26+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=373a5a267cfe849e184fda0f9baac3bf81f77223'/>
<id>373a5a267cfe849e184fda0f9baac3bf81f77223</id>
<content type='text'>
Both now take the number from one constant now set at 10,000, the writer
checks it before the archive is written.

Previously the number set for the pod reader was less than 500 members.
The writer had no limit, (so spine could write a pod it would then
refuse to read, reporting too many entries: a good file that looks
corrupt, and only for a document with enough parts).

500 was set when a pod held markup and images. A pod carrying
translation catalogues has a different arithmetic, and the count follows
from how many files a document is made of times how many languages it
has, not from how large the document is:

  the_wealth_of_networks  213,405 words, 1 file per language
                          12 languages -&gt;   49 entries
  live-manual              24,724 words, 20 files per language
                          12 languages -&gt;  506 entries

The big book is not what runs into this; the modular manual is.
live-manual stood two languages from an unreadable artefact.

10,000 covers a hundred-insert manual in thirty languages, about 6,200
entries, with room. It is deliberately well clear of any real document
rather than snug above the largest one known: the two errors are not
comparable, since too low refuses a legitimate document with a message
that reads as corruption, while too high defers to a size cap a moment
later. The count is the weakest of the three guards and is not what
bounds resource use; the per entry and total size caps do that, both
before a byte is written.

Refusing also removes any archive an earlier language left. The writer
runs once per language and only the last pass holds every language, so
it is the last that goes over, and the passes before it wrote smaller
archives that passed. Without this, refusal left a pod missing a
language: an artefact that reads perfectly well and is wrong. A missing
file is an error someone notices.

The arithmetic is recorded beside the constant so the next person can
re-derive the number rather than guess at it.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Both now take the number from one constant now set at 10,000, the writer
checks it before the archive is written.

Previously the number set for the pod reader was less than 500 members.
The writer had no limit, (so spine could write a pod it would then
refuse to read, reporting too many entries: a good file that looks
corrupt, and only for a document with enough parts).

500 was set when a pod held markup and images. A pod carrying
translation catalogues has a different arithmetic, and the count follows
from how many files a document is made of times how many languages it
has, not from how large the document is:

  the_wealth_of_networks  213,405 words, 1 file per language
                          12 languages -&gt;   49 entries
  live-manual              24,724 words, 20 files per language
                          12 languages -&gt;  506 entries

The big book is not what runs into this; the modular manual is.
live-manual stood two languages from an unreadable artefact.

10,000 covers a hundred-insert manual in thirty languages, about 6,200
entries, with room. It is deliberately well clear of any real document
rather than snug above the largest one known: the two errors are not
comparable, since too low refuses a legitimate document with a message
that reads as corruption, while too high defers to a size cap a moment
later. The count is the weakest of the three guards and is not what
bounds resource use; the per entry and total size caps do that, both
before a byte is written.

Refusing also removes any archive an earlier language left. The writer
runs once per language and only the last pass holds every language, so
it is the last that goes over, and the passes before it wrote smaller
archives that passed. Without this, refusal left a pod missing a
language: an artefact that reads perfectly well and is wrong. A missing
file is an error someone notices.

The arithmetic is recorded beside the constant so the next person can
re-derive the number rather than guess at it.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>pod: write &lt;doc&gt;.sisupod (single zstd frame)</title>
<updated>2026-09-22T17:48:19+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T13:35:37+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=4c766a8455d05bdf6a9793946f7839a01f179b65'/>
<id>4c766a8455d05bdf6a9793946f7839a01f179b65</id>
<content type='text'>
The pod archive spine writes is now named .sisupod and carries the
same archive inside one zstd frame. The reader has accepted both
since the previous commit, so every pod already published stays
readable and this changes only what is written.

  free_culture           2863504 -&gt; 1100180
  live-manual            6972418 -&gt;  692942   10.06x

The wrap is at the pod call site and not in createZipFile, which
also writes every epub and every odt.

Best compression from whole-stream (rather than per-member compression).
(for live-manual per-member deflate manages about 3x compared to 10x for
whole pod content compression).

The suffix is named as pod_archive_suffix.

--pod-compression sets the level, 19 by default: a pod is written once
and fetched many times (692942 bytes at 19, 837703 at 9, 2054365 at 1).
(A value that is not a number warns and the default is used).

Output built from a written .sisupod is byte identical to output built
from the markup it came from.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The pod archive spine writes is now named .sisupod and carries the
same archive inside one zstd frame. The reader has accepted both
since the previous commit, so every pod already published stays
readable and this changes only what is written.

  free_culture           2863504 -&gt; 1100180
  live-manual            6972418 -&gt;  692942   10.06x

The wrap is at the pod call site and not in createZipFile, which
also writes every epub and every odt.

Best compression from whole-stream (rather than per-member compression).
(for live-manual per-member deflate manages about 3x compared to 10x for
whole pod content compression).

The suffix is named as pod_archive_suffix.

--pod-compression sets the level, 19 by default: a pod is written once
and fetched many times (692942 bytes at 19, 837703 at 9, 2054365 at 1).
(A value that is not a number warns and the default is used).

Output built from a written .sisupod is byte identical to output built
from the markup it came from.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>conf: read conf/document_make, drop the dr_ prefix</title>
<updated>2026-09-22T16:50:33+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T03:50:58+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=84f4c4c963e4b3edc04300f8c5b931028e028c6c'/>
<id>84f4c4c963e4b3edc04300f8c5b931028e028c6c</id>
<content type='text'>
Spine now looks for conf/document_make, and bundles that name.
(the dr_ prefix was a sisu-era name to distinguish it)

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Spine now looks for conf/document_make, and bundles that name.
(the dr_ prefix was a sisu-era name to distinguish it)

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>pod digests: multilingual document digests sorted</title>
<updated>2026-09-22T16:44:37+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-21T03:41:28+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=271bca112afd357a3002d169b961b03a7b48364c'/>
<id>271bca112afd357a3002d169b961b03a7b48364c</id>
<content type='text'>
Fixes for three faults in the insert (.ssi) digests.
The key was the language captured from whichever path resolved the
insert. It did not change across the loop over languages, so
every language's inserts were filed under one language. The key is now
the language being digested, as the digest of the primary file above it
already did.
- digest is taken after the check that the file exists.
- digest is now taken inside the guard.
- non-pod path now correctly keyed on the document's own language.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Fixes for three faults in the insert (.ssi) digests.
The key was the language captured from whichever path resolved the
insert. It did not change across the loop over languages, so
every language's inserts were filed under one language. The key is now
the language being digested, as the digest of the primary file above it
already did.
- digest is taken after the check that the file exists.
- digest is now taken inside the guard.
- non-pod path now correctly keyed on the document's own language.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>some file renames</title>
<updated>2026-09-12T16:39:08+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-12T02:01:51+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=bf605ac48b231c5852986be2b9a91838c617bfb7'/>
<id>bf605ac48b231c5852986be2b9a91838c617bfb7</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>--ocda-db replaces --show-abstraction-db</title>
<updated>2026-09-09T23:03:54+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-08T21:30:00+00:00</published>
<link rel='alternate' type='text/html' href='https://amissah.com/projects/sisudoc-spine/commit/?id=557810df54fb5411c362528b459648611e8267ba'/>
<id>557810df54fb5411c362528b459648611e8267ba</id>
<content type='text'>
ocda (object centric document abstraction)

flag --ocda-db (or --abstraction-db)
replaces --show-abstraction-db

rename results in consequently large diff
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
ocda (object centric document abstraction)

flag --ocda-db (or --abstraction-db)
replaces --show-abstraction-db

rename results in consequently large diff
</pre>
</div>
</content>
</entry>
</feed>
