diff --git a/AGENTS.md b/AGENTS.md index baaf16f9a..aed63a2fd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -86,7 +86,9 @@ The docs site (`docs/`) is built with [Roq](https://docs.quarkiverse.io/quarkus- - `index.adoc` (or `index.md`) — the post content, with `image: announce.png` in the YAML frontmatter - `announce.png` — the announcement banner image (PNG format, named exactly `announce.png`) -The `announce.png` filename is required: the home page (`docs/content/index.html`) renders the latest post's image using the `post.image` field resolved from this frontmatter entry, and the Roq site theme uses it as the post cover. +The `announce.png` filename is required. The `image: announce.png` frontmatter field is used by the post card component (on the home page and announces listing) to show the thumbnail. The theme's cover image block is hidden via CSS on post pages, so the image must also be added as the **first line of the post content** (after an empty line following the closing `---`) so it appears after the title: +- AsciiDoc: blank line after `---`, then `image::announce.png[]` (blank line required for block macro recognition) +- Markdown: blank line after `---`, then `![](announce.png)` **Version metadata:** Each version has a YAML file in `docs/data/versions/` (e.g. `dev.yml`, `1.1.0.Final.yml`) that defines the label, URL path, sort order, default/dev flags, and sidebar menu. When adding or removing a documentation page, update the `menu` list in `docs/data/versions/dev.yml` accordingly. diff --git a/docs/content/index.html b/docs/content/index.html index 4d49a6846..8bc831eb0 100644 --- a/docs/content/index.html +++ b/docs/content/index.html @@ -50,16 +50,7 @@

Latest Announcement

{#if site.collections.get('posts')} {#for post in site.collections.get('posts')} {#if post_index == 0} - - {post.title} -
-

{post.title}

- {#if post.data.synopsis??} -

{post.data.synopsis}

- {/if} - Read announcement -
- + {#roq/postCard post /} {/if} {/for} {/if} diff --git a/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc b/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc index b78c1ec10..361fb1fb0 100644 --- a/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc +++ b/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc @@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.2.0.Final is now available -- with authorization harde author: kkhan image: announce.png --- + image::announce.png[A2A Java SDK 1.2.0.Final announcement] I am happy to announce the release of link:https://github.com/a2aproject/a2a-java/releases/tag/v1.2.0.Final[A2A Java SDK 1.2.0.Final]. This release hardens the authorization model, adds stream lifecycle management, and fixes several protocol compliance issues. diff --git a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png index 55a28edfc..20a0585bc 100644 Binary files a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png and b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png differ diff --git a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc index 1c536390b..3a09387e2 100644 --- a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc +++ b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc @@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.3.0.Final is now available -- with multi-tenancy suppo author: ehsavoie image: announce.png --- + image::announce.png[A2A Java SDK 1.3.0.Final announcement] I am happy to announce the release of link:https://github.com/a2aproject/a2a-java/releases/tag/v1.3.0.Final[A2A Java SDK 1.3.0.Final]. This release introduces multi-tenancy support, switches the authorization model to fail-closed by default, delivers a wave of security hardening, and improves protocol compliance across all transports. diff --git a/docs/web/_custom.css b/docs/web/_custom.css index e7dee1fc9..a04b3b79b 100644 --- a/docs/web/_custom.css +++ b/docs/web/_custom.css @@ -213,73 +213,10 @@ text-align: left; } -/* ── Latest Announcement banner ──────────────────────────────────────────── */ +/* ── Post page: hide theme cover image (image is inline in content instead) ── */ -.latest-post-banner { - display: flex; - border: 1px solid rgba(255, 255, 255, 0.12); - border-radius: 0.75rem; - overflow: hidden; - text-decoration: none; - background: rgba(255, 255, 255, 0.03); - transition: border-color 0.2s ease, box-shadow 0.2s ease; -} - -.latest-post-banner:hover { - border-color: var(--color-accent-400); - box-shadow: 0 4px 20px rgba(63, 81, 181, 0.2); - text-decoration: none; -} - -.latest-post-banner-image { - width: 45%; - object-fit: cover; - flex-shrink: 0; - display: block; -} - -.latest-post-banner-content { - display: flex; - flex-direction: column; - justify-content: center; - padding: 2rem; - gap: 1rem; - flex: 1; -} - -.latest-post-banner-title { - font-size: 1.5rem; - font-weight: 700; - margin: 0; - line-height: 1.3; -} - -.latest-post-banner-synopsis { - font-size: 0.95rem; - opacity: 0.8; - margin: 0; - line-height: 1.6; -} - -.latest-post-banner-cta { - font-size: 0.9rem; - font-weight: 600; - color: var(--color-accent-300); -} - -@media (max-width: 640px) { - .latest-post-banner { - flex-direction: column; - } - - .latest-post-banner-image { - width: 100%; - max-height: 220px; - } - - .latest-post-banner-content { - padding: 1.25rem; - } +.article-page .page-cover-image { + display: none; } /* ── Syntax Highlighting (highlight.js) ───────────────────────────────────── */