zink/trilium_share_gruvbox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: thumb.<ext> child-note thumbnail pattern, auto-hide from menu, inline image attachments (/image/ path) convention

Browse Source
This commit is contained in:
trilium-share-gruvbox
2026-08-28 20:54:43 +02:00
parent e224dea9aa
commit 5eacadd574
2 changed files with 8 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+5
View File
@@ -57,6 +57,11 @@ CSS file (Gruvbox, light + dark, theme toggle without reload).
`max-height:256px`, lazy-loaded. The generator auto-sets `shareHiddenFromTree` on matching `max-height:256px`, lazy-loaded. The generator auto-sets `shareHiddenFromTree` on matching
thumb child notes so they never appear in the blog menu. **There is no server-side resizing** – thumb child notes so they never appear in the blog menu. **There is no server-side resizing** –
see "Limitations". see "Limitations".
- **Inline images in article content**: pasted image attachments render as
`<img src="api/attachments/<attachmentId>/image/<filename>">`. The share only serves
attachments through that `/image/` path segment – without it the request 404s. Use image
**attachments** for inline images (no child note, no menu clutter) and keep the `thumb.<ext>`
child note as the only image child.
- Regenerates `feed.xml`, `sitemap.xml`, `state_map` (garden states) and `blog_data` - Regenerates `feed.xml`, `sitemap.xml`, `state_map` (garden states) and `blog_data`
(search index: id/title/url/summary/tags/category). Sets `shareDescription` from `summary`. (search index: id/title/url/summary/tags/category). Sets `shareDescription` from `summary`.
README.md
+3 -2
View File
@@ -31,8 +31,9 @@ no external dependencies (except `highlight.js`, vendored in `lib/`).
(post cards, garden table, menu) include the weekday (`dateText` from the generator). (post cards, garden table, menu) include the weekday (`dateText` from the generator).
- **Article thumbnails**: each post card shows the first image of the article on the left - **Article thumbnails**: each post card shows the first image of the article on the left
(bounded by the teaser height), summary on the right, lazy-loaded. If an article has a child (bounded by the teaser height), summary on the right, lazy-loaded. If an article has a child
note named `*_thumb.*` (e.g. `ngc281_thumb.jpg`), that image is used instead – ideal for note named `thumb.<ext>` **or** `*_thumb.<ext>` (e.g. `thumb.png`, `ngc281_thumb.jpg`), that
serving small pre-made thumbnails. image is used instead – ideal for serving small pre-made thumbnails. Thumb child notes are
auto-hidden from the blog menu (`shareHiddenFromTree`).
- **Pagination**: 10 posts per page on the index and category pages, with prev/next - **Pagination**: 10 posts per page on the index and category pages, with prev/next
navigation between the pages; article prev/next links stay within the article's category. navigation between the pages; article prev/next links stay within the article's category.
- Article metadata: date, category, summary, tags, prev/next navigation, reading time. - Article metadata: date, category, summary, tags, prev/next navigation, reading time.