Skip to content

Commit 51afbdd

Browse files
authored
docs: fix announcement post image display (a2aproject#1104)
- Add blank line before AsciiDoc image:: block macros in 1.2.0 and 1.3.0 posts (required for block-level rendering) - Compress 1.3.0 announce.png (4.9MB → 1.8MB) - Use {#roq/postCard} for latest announcement on index page - Replace custom banner CSS with .article-page .page-cover-image { display: none } - Document image placement convention in AGENTS.md Signed-off-by: Emmanuel Hugonnet <ehugonne@redhat.com>
1 parent 34dd858 commit 51afbdd

6 files changed

Lines changed: 9 additions & 77 deletions

File tree

‎AGENTS.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,9 @@ The docs site (`docs/`) is built with [Roq](https://docs.quarkiverse.io/quarkus-
8686
- `index.adoc` (or `index.md`) — the post content, with `image: announce.png` in the YAML frontmatter
8787
- `announce.png` — the announcement banner image (PNG format, named exactly `announce.png`)
8888

89-
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.
89+
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:
90+
- AsciiDoc: blank line after `---`, then `image::announce.png[<alt text>]` (blank line required for block macro recognition)
91+
- Markdown: blank line after `---`, then `![<alt text>](announce.png)`
9092

9193
**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.
9294

‎docs/content/index.html‎

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -50,16 +50,7 @@ <h2>Latest Announcement</h2>
5050
{#if site.collections.get('posts')}
5151
{#for post in site.collections.get('posts')}
5252
{#if post_index == 0}
53-
<a href="{post.url}" class="latest-post-banner">
54-
<img src="{post.image}" alt="{post.title}" class="latest-post-banner-image">
55-
<div class="latest-post-banner-content">
56-
<h3 class="latest-post-banner-title">{post.title}</h3>
57-
{#if post.data.synopsis??}
58-
<p class="latest-post-banner-synopsis">{post.data.synopsis}</p>
59-
{/if}
60-
<span class="latest-post-banner-cta">Read announcement <i class="fa-solid fa-arrow-right"></i></span>
61-
</div>
62-
</a>
53+
{#roq/postCard post /}
6354
{/if}
6455
{/for}
6556
{/if}

‎docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.2.0.Final is now available -- with authorization harde
77
author: kkhan
88
image: announce.png
99
---
10+
1011
image::announce.png[A2A Java SDK 1.2.0.Final announcement]
1112

1213
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.
-2.89 MB
Loading

‎docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.3.0.Final is now available -- with multi-tenancy suppo
77
author: ehsavoie
88
image: announce.png
99
---
10+
1011
image::announce.png[A2A Java SDK 1.3.0.Final announcement]
1112

1213
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.

‎docs/web/_custom.css‎

Lines changed: 3 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -213,73 +213,10 @@
213213
text-align: left;
214214
}
215215

216-
/* ── Latest Announcement banner ──────────────────────────────────────────── */
216+
/* ── Post page: hide theme cover image (image is inline in content instead) ── */
217217

218-
.latest-post-banner {
219-
display: flex;
220-
border: 1px solid rgba(255, 255, 255, 0.12);
221-
border-radius: 0.75rem;
222-
overflow: hidden;
223-
text-decoration: none;
224-
background: rgba(255, 255, 255, 0.03);
225-
transition: border-color 0.2s ease, box-shadow 0.2s ease;
226-
}
227-
228-
.latest-post-banner:hover {
229-
border-color: var(--color-accent-400);
230-
box-shadow: 0 4px 20px rgba(63, 81, 181, 0.2);
231-
text-decoration: none;
232-
}
233-
234-
.latest-post-banner-image {
235-
width: 45%;
236-
object-fit: cover;
237-
flex-shrink: 0;
238-
display: block;
239-
}
240-
241-
.latest-post-banner-content {
242-
display: flex;
243-
flex-direction: column;
244-
justify-content: center;
245-
padding: 2rem;
246-
gap: 1rem;
247-
flex: 1;
248-
}
249-
250-
.latest-post-banner-title {
251-
font-size: 1.5rem;
252-
font-weight: 700;
253-
margin: 0;
254-
line-height: 1.3;
255-
}
256-
257-
.latest-post-banner-synopsis {
258-
font-size: 0.95rem;
259-
opacity: 0.8;
260-
margin: 0;
261-
line-height: 1.6;
262-
}
263-
264-
.latest-post-banner-cta {
265-
font-size: 0.9rem;
266-
font-weight: 600;
267-
color: var(--color-accent-300);
268-
}
269-
270-
@media (max-width: 640px) {
271-
.latest-post-banner {
272-
flex-direction: column;
273-
}
274-
275-
.latest-post-banner-image {
276-
width: 100%;
277-
max-height: 220px;
278-
}
279-
280-
.latest-post-banner-content {
281-
padding: 1.25rem;
282-
}
218+
.article-page .page-cover-image {
219+
display: none;
283220
}
284221

285222
/* ── Syntax Highlighting (highlight.js) ───────────────────────────────────── */

0 commit comments

Comments
 (0)