Changeset 812fea9 in Klonkt for docs

Timestamp:

08/06/2026 02:20:19 PM (5 weeks ago)

Author:

roboburr <roboburr@…>

Branches:

main

Children:

7aa3140

Parents:

58cfe5f

git-author:

Robin <roboburr@…> (08/06/2026 02:20:09 PM)

git-committer:

roboburr <roboburr@…> (08/06/2026 02:20:19 PM)

Message:

Elke bijlage zegt waar hij voor was (shaer-pmr, vervolg)

Gevonden bij een oefenherstel: ik vergeleek dertien kolommen, noemde het een
schone rondgang, en vergeleek daarna ALLE kolommen. Toen bleken er drie dingen
weg te vallen.

COVER de bytes zaten in het archief, maar nergens stond dat ze de

cover waren. cover_image_url kwam als null terug, dus de post
stond zonder cover.

C2S-BIJLAGE idem: het audiobestand en zijn poster zaten erin, maar

c2s_attachments werd niet hersteld, dus de speler verdween.

SUB-SECONDE de import zette tijdstempels om naar SQL-notatie en verloor de

milliseconden. Twee posts in dezelfde seconde staan dan in
willekeurige volgorde.

Elke bijlage draagt nu een shaer:role -- cover, coverVideo, inline, c2s, poster,
track -- en een poster wijst met shaer:posterFor naar de bijlage waar hij bij
hoort. De importer bouwt cover_image_url, cover_video_url en c2s_attachments
daaruit terug. Een rol is geen versiering: zonder rol heeft het archief wel de
bytes maar niet het feit dat ze de cover WAREN, en dat zie je pas als je alle
kolommen vergelijkt.

Tijdstempels gaan nu ongewijzigd de database in. Klonkt schrijft zelf in twee
spellingen; het archief normaliseert naar ISO. Het MOMENT overleeft de rondgang,
de spelling niet -- nu ook zo gedocumenteerd in plaats van stilzwijgend.

Rondgang op echte beta-data: geen verschil meer over 29 kolommen, met de tijden
op moment vergeleken in plaats van op tekst. 21 tests. Suite 514/514.

File:

• docs/EXPORT-FORMAT.md (modified) (2 diffs)

docs/EXPORT-FORMAT.md

@@ -99 +99 @@
 | `summary` | `posts.content_warning` | AS2 summary is the content warning |
 | `sensitive` | `posts.nsfw` | |
-| `published` | `posts.published_at` ?? `created_at` | ISO 8601, UTC |
+| `published` | `posts.published_at` ?? `created_at` | ISO 8601, UTC. Klonkt stores timestamps in two spellings (`YYYY-MM-DD HH:MM:SS` and full ISO); the archive normalises to ISO. The **instant** survives a round trip, the spelling does not. |
 | `updated` | `posts.updated_at` | omitted when equal to `published` |
 | `url` | `<origin>/<slug>` | the human permalink |
-| `attachment` | cover, inline `<img>`, `c2s_attachments` **and their `poster`**, hosted audio tracks | see [Media](#media) |
+| `attachment` | cover, inline `<img>`, `c2s_attachments` **and their `poster`**, hosted audio tracks | see [Media](#media); each carries a `shaer:role` |
 | `tag` | `posts.tags`, mentions, custom emoji | `Hashtag`, `Mention`, `toot:Emoji` |
 | `oneOf` / `anyOf` / `endTime` | `posts.poll_json` | a poll exports as a `Question` |
@@ -170 +170 @@
 | `missing` | it existed, we know where, we do not have it | the original absolute URL |
 
+Every attachment also carries **`shaer:role`**, saying what it was for:
+
+| role | restored to |
+|---|---|
+| `cover` / `coverVideo` | `posts.cover_image_url` / `cover_video_url` |
+| `inline` | already referenced from `content` |
+| `c2s` | an entry in `posts.c2s_attachments` |
+| `poster` | the `poster` of the `c2s` entry named in `shaer:posterFor` |
+| `track` | the file behind a `[[track:id]]`, linked from `shaer:audio` |
+
+The role is not decoration. Without it the archive holds the bytes but not the
+fact that they *were the cover*, and the post comes back without one — which is
+invisible until you compare every column, not a handful.
+
 `url` for an included attachment is a **container-relative path**, not a URL. An
 importer must rewrite it. This is the one place where the archive deviates from