Skip to content

Define simple asset pages and flat file names - #177

Merged
codekiln merged 5 commits into
mainfrom
codex/gitp-asset-convention
Oct 4, 2026
Merged

codekiln merged 5 commits into
mainfrom
codex/gitp-asset-convention

Conversation

@codekiln

@codekiln codekiln commented Oct 4, 2026 •

Copy link
Copy Markdown
Owner

Each garden asset now has a small page representing its file. The page name supplies a flat filename using triple underscores between namespace segments and preserving spelling within each segment; B2 stores that filename at the bucket root and local copies use assets/.remote/.

The September 24 MP3 is uploaded under this convention and embedded as an audio player. Its asset page has entity and documented duration frontmatter. DVC owns checksums; feed metadata owns enclosure size and media type. Bucket and storage details are not repeated on the asset page.

The shared definitions and asset-linking skill use this convention. Session links, JSON export, and the DVC plan point to the renamed upload. Uploading makes the audio available; the episode is published only after its Gitpa publication PR is merged and CI updates the site and RSS feed.

Gitpa PR #10 adds the matching episode audio player and URL while keeping the episode unpublished.

Validation: uploaded audio matches the source recording; garden episode tests and commit checks pass. Gitpa importer/feed tests and feed consistency check pass.

The definitions use general examples and validate filename characters so filenames map back to their exact page names. Namespaces imply ownership without duplicate properties. Backblaze/B2 is documented as a software product.

DVC is initialized with the garden B2 remote. The September 24 MP3 has committed .dvc metadata, and restoration from a fresh checkout matched the original recording. The binary remains excluded from Git.

Comment thread pages/GitP___A___Session___26___09___24 Thu___Asset___Episode___mp3.md Outdated
Comment thread pages/Logseq___Entity___Asset.md Outdated
Comment thread pages/Logseq___Entity___Asset.md Outdated
Comment thread pages/Logseq___Entity___Asset.md Outdated
Comment thread pages/Logseq___Entity___Asset___B2.md Outdated
Comment thread pages/Logseq___Entity___Asset___B2.md Outdated
@codekiln codekiln changed the title Define asset pages and matching local/B2 paths Define simple asset pages and flat file names Oct 4, 2026
Comment thread pages/Logseq___Entity___Asset___Frontmatter___duration-seconds.md Outdated
Comment thread pages/Logseq___Entity___Asset___Frontmatter___duration-seconds.md Outdated
Comment thread pages/Backblaze___B2.md Outdated
Comment thread pages/GitP___A___Log___26___10___04 Sun___Dvc for Knowledge Gardens___Plan.md Outdated
@codekiln
codekiln merged commit 63dc884 into main Oct 4, 2026
@codekiln
codekiln deleted the codex/gitp-asset-convention branch October 4, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant