You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@community.apache.org by ti...@apache.org on 2026/10/01 03:02:13 UTC

(comdev-events-site) branch codex/fix-asf-rai-images created (now 2aa2c88)

This is an automated email from the ASF dual-hosted git repository.

tisonkun pushed a change to branch codex/fix-asf-rai-images
in repository https://gitbox.apache.org/repos/asf/comdev-events-site.git


      at 2aa2c88  Bundle RAI quick start guide with its images

This branch includes the following new commits:

     new d907201  Fix RAI quick start image publication and layout
     new 2aa2c88  Bundle RAI quick start guide with its images

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



(comdev-events-site) 01/02: Fix RAI quick start image publication and layout

Posted by ti...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

tisonkun pushed a commit to branch codex/fix-asf-rai-images
in repository https://gitbox.apache.org/repos/asf/comdev-events-site.git

commit d907201ef1d6b0276156bb6cd6777dca8c5248e7
Author: tison <wa...@gmail.com>
AuthorDate: Thu Oct 1 10:47:56 2026 +0800

    Fix RAI quick start image publication and layout
---
 README.md                                          |   2 ++
 source/events/2026/community-over-code/asf-rai.md  |  22 ++++++++++-----------
 .../images/asf-rai/asf-oauth-login.png             | Bin
 .../images/asf-rai/llmao-fleet-landing.png         | Bin
 .../images/asf-rai/llmao-key-created.png           | Bin
 .../images/asf-rai/llmao-my-keys.png               | Bin
 .../images/asf-rai/rai-logo-apache.png             | Bin
 static/style/screen.css                            |   5 +++++
 8 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 7f2960d..f57e7c1 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,8 @@ To generate the static website, execute `hugo` to generate the website under tar
 During development, it may be useful to run an incremental build. For this to work, execute `hugo server -D` to
 continuously (re)generate and serve the website on `localhost:1313`.
 
+Store shared images in `static/images/` and reference them as `/images/...` in page content. Hugo copies the root `static/` directory to the site root; a directory named `static` beneath `source/` remains under that content path. After building, check that each image URL corresponds to a file under `target/content/`.
+
 # How-To add a Community Over Code event promotion to your project site
 
 All PMCs are asked to help promote Community Over Code and other major Apache
diff --git a/source/events/2026/community-over-code/asf-rai.md b/source/events/2026/community-over-code/asf-rai.md
index 55ce79a..03b2a94 100644
--- a/source/events/2026/community-over-code/asf-rai.md
+++ b/source/events/2026/community-over-code/asf-rai.md
@@ -2,40 +2,38 @@
 title: "Apache RAI Hackathon: LLMAO Quick Start"
 ---
 
-# Apache RAI Hackathon: LLMAO Quick Start
-
 A short guide for joining the Apache Responsible AI (RAI) hackathon and contributing to **LLMAO** ([apache/tooling-llmao](https://github.com/apache/tooling-llmao)).
 
 ---
 
 ## 1. Connect to llm.apache.org
 
-Go to [https://llm.apache.org/fleet](https://llm.apache.org/fleet) and log in.
+1. Go to [https://llm.apache.org/fleet](https://llm.apache.org/fleet) and log in.
 
-Use your ASF LDAP (committer) username and password on the ASF OAuth page:
+   Use your ASF LDAP (committer) username and password on the ASF OAuth page:
 
-![ASF OAuth login page for llm.apache.org](/images/asf-rai/asf-oauth-login.png)
+   <img src="/images/asf-rai/asf-oauth-login.png" alt="ASF OAuth login page for llm.apache.org" class="screenshot">
 
-Once you log in, the landing page (Fleet) will look like the one below:
+   Once you log in, the landing page (Fleet) will look like the one below:
 
-![LLMAO Fleet landing page showing available models](/images/asf-rai/llmao-fleet-landing.png)
+   <img src="/images/asf-rai/llmao-fleet-landing.png" alt="LLMAO Fleet landing page showing available models" class="screenshot">
 
 2. Create a key.
 
    Go to **My Keys** in the top menu and click **+ Create key**. The secret is shown only once, when you create the key.
 
-   ![LLMAO My Keys page with the Create key button](/images/asf-rai/llmao-my-keys.png)
+   <img src="/images/asf-rai/llmao-my-keys.png" alt="LLMAO My Keys page with the Create key button" class="screenshot">
 
    Once the key is created, you'll see the confirmation below. Click **Copy** right away, because the secret will not be shown again.
 
-   ![Personal API key created confirmation with the Copy button](/images/asf-rai/llmao-key-created.png)
+   <img src="/images/asf-rai/llmao-key-created.png" alt="Personal API key created confirmation with the Copy button" class="screenshot">
 
-3. Copy the key and keep it somewhere safe. You will need it in step 3.2.
+3. Copy the key and keep it somewhere safe. You will need it in step 4.2.
 4. For agents:
    1. Follow the instructions in [Connecting your agent](https://github.com/apache/tooling-llmao#connecting-your-agent).
-   2. Set the environment variables, using the key from step 2.
+   2. Set the environment variables, using the key from step 3.
 
- **Tip:** Treat the key like a password. Don't commit it to a repo or paste it into Slack.
+**Tip:** Treat the key like a password. Don't commit it to a repo or paste it into Slack.
 
 ---
 
diff --git a/source/events/2026/community-over-code/static/images/asf-rai/asf-oauth-login.png b/static/images/asf-rai/asf-oauth-login.png
similarity index 100%
rename from source/events/2026/community-over-code/static/images/asf-rai/asf-oauth-login.png
rename to static/images/asf-rai/asf-oauth-login.png
diff --git a/source/events/2026/community-over-code/static/images/asf-rai/llmao-fleet-landing.png b/static/images/asf-rai/llmao-fleet-landing.png
similarity index 100%
rename from source/events/2026/community-over-code/static/images/asf-rai/llmao-fleet-landing.png
rename to static/images/asf-rai/llmao-fleet-landing.png
diff --git a/source/events/2026/community-over-code/static/images/asf-rai/llmao-key-created.png b/static/images/asf-rai/llmao-key-created.png
similarity index 100%
rename from source/events/2026/community-over-code/static/images/asf-rai/llmao-key-created.png
rename to static/images/asf-rai/llmao-key-created.png
diff --git a/source/events/2026/community-over-code/static/images/asf-rai/llmao-my-keys.png b/static/images/asf-rai/llmao-my-keys.png
similarity index 100%
rename from source/events/2026/community-over-code/static/images/asf-rai/llmao-my-keys.png
rename to static/images/asf-rai/llmao-my-keys.png
diff --git a/source/events/2026/community-over-code/static/images/asf-rai/rai-logo-apache.png b/static/images/asf-rai/rai-logo-apache.png
similarity index 100%
rename from source/events/2026/community-over-code/static/images/asf-rai/rai-logo-apache.png
rename to static/images/asf-rai/rai-logo-apache.png
diff --git a/static/style/screen.css b/static/style/screen.css
index 4a61ecf..b28ea60 100644
--- a/static/style/screen.css
+++ b/static/style/screen.css
@@ -72,6 +72,11 @@ h1,h2,h3,h4,h5,h6 {
   color: #333;
 }
 
+.screenshot {
+  max-width: 100%;
+  height: auto;
+}
+
 #content h1,h2,h3,h4,h5,h6 {
   font-weight: normal;
   margin: 10px 0 15px;


(comdev-events-site) 02/02: Bundle RAI quick start guide with its images

Posted by ti...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

tisonkun pushed a commit to branch codex/fix-asf-rai-images
in repository https://gitbox.apache.org/repos/asf/comdev-events-site.git

commit 2aa2c88deba76425f033554969a9bb0f7361bea6
Author: tison <wa...@gmail.com>
AuthorDate: Thu Oct 1 11:02:06 2026 +0800

    Bundle RAI quick start guide with its images
---
 README.md                                          |  12 ++++++++++-
 layouts/shortcodes/screenshot.html                 |  22 +++++++++++++++++++++
 .../asf-rai/asf-oauth-login.png                    | Bin
 .../{asf-rai.md => asf-rai/index.md}               |   8 ++++----
 .../asf-rai/llmao-fleet-landing.png                | Bin
 .../asf-rai/llmao-key-created.png                  | Bin
 .../community-over-code}/asf-rai/llmao-my-keys.png | Bin
 .../asf-rai/rai-logo-apache.png                    | Bin
 8 files changed, 37 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index f57e7c1..f829718 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,17 @@ To generate the static website, execute `hugo` to generate the website under tar
 During development, it may be useful to run an incremental build. For this to work, execute `hugo server -D` to
 continuously (re)generate and serve the website on `localhost:1313`.
 
-Store shared images in `static/images/` and reference them as `/images/...` in page content. Hugo copies the root `static/` directory to the site root; a directory named `static` beneath `source/` remains under that content path. After building, check that each image URL corresponds to a file under `target/content/`.
+Store images shared across pages in `static/images/` and reference them as `/images/...` in page content.
+
+For images belonging to a single page, use a [Hugo leaf bundle](https://gohugo.io/content-management/page-bundles/) so the content and images can be removed together. For example:
+
+```text
+source/events/2026/community-over-code/asf-rai/
+  index.md
+  asf-oauth-login.png
+```
+
+Reference a bundled screenshot with `{{< screenshot src="asf-oauth-login.png" alt="ASF OAuth login page" >}}`. This shortcode uses the page resource's published URL, including with this site's `uglyURLs = true` setting, and fails the build if the image is missing. After building, check that each image URL corresponds to a file under `target/content/`. Jenkins builds into a fresh directory and replaces the published content, so deleting a bundle removes its page and images from the next d [...]
 
 # How-To add a Community Over Code event promotion to your project site
 
diff --git a/layouts/shortcodes/screenshot.html b/layouts/shortcodes/screenshot.html
new file mode 100644
index 0000000..df4e8a0
--- /dev/null
+++ b/layouts/shortcodes/screenshot.html
@@ -0,0 +1,22 @@
+{{/*
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/}}
+{{- $src := .Get "src" -}}
+{{- with .Page.Resources.Get $src -}}
+<img src="{{ .RelPermalink }}" alt="{{ $.Get "alt" }}" class="screenshot">
+{{- else -}}
+  {{- errorf "Screenshot %q not found in page bundle %q" $src .Page.File.Path -}}
+{{- end -}}
diff --git a/static/images/asf-rai/asf-oauth-login.png b/source/events/2026/community-over-code/asf-rai/asf-oauth-login.png
similarity index 100%
rename from static/images/asf-rai/asf-oauth-login.png
rename to source/events/2026/community-over-code/asf-rai/asf-oauth-login.png
diff --git a/source/events/2026/community-over-code/asf-rai.md b/source/events/2026/community-over-code/asf-rai/index.md
similarity index 79%
rename from source/events/2026/community-over-code/asf-rai.md
rename to source/events/2026/community-over-code/asf-rai/index.md
index 03b2a94..6b6b3fe 100644
--- a/source/events/2026/community-over-code/asf-rai.md
+++ b/source/events/2026/community-over-code/asf-rai/index.md
@@ -12,21 +12,21 @@ A short guide for joining the Apache Responsible AI (RAI) hackathon and contribu
 
    Use your ASF LDAP (committer) username and password on the ASF OAuth page:
 
-   <img src="/images/asf-rai/asf-oauth-login.png" alt="ASF OAuth login page for llm.apache.org" class="screenshot">
+   {{< screenshot src="asf-oauth-login.png" alt="ASF OAuth login page for llm.apache.org" >}}
 
    Once you log in, the landing page (Fleet) will look like the one below:
 
-   <img src="/images/asf-rai/llmao-fleet-landing.png" alt="LLMAO Fleet landing page showing available models" class="screenshot">
+   {{< screenshot src="llmao-fleet-landing.png" alt="LLMAO Fleet landing page showing available models" >}}
 
 2. Create a key.
 
    Go to **My Keys** in the top menu and click **+ Create key**. The secret is shown only once, when you create the key.
 
-   <img src="/images/asf-rai/llmao-my-keys.png" alt="LLMAO My Keys page with the Create key button" class="screenshot">
+   {{< screenshot src="llmao-my-keys.png" alt="LLMAO My Keys page with the Create key button" >}}
 
    Once the key is created, you'll see the confirmation below. Click **Copy** right away, because the secret will not be shown again.
 
-   <img src="/images/asf-rai/llmao-key-created.png" alt="Personal API key created confirmation with the Copy button" class="screenshot">
+   {{< screenshot src="llmao-key-created.png" alt="Personal API key created confirmation with the Copy button" >}}
 
 3. Copy the key and keep it somewhere safe. You will need it in step 4.2.
 4. For agents:
diff --git a/static/images/asf-rai/llmao-fleet-landing.png b/source/events/2026/community-over-code/asf-rai/llmao-fleet-landing.png
similarity index 100%
rename from static/images/asf-rai/llmao-fleet-landing.png
rename to source/events/2026/community-over-code/asf-rai/llmao-fleet-landing.png
diff --git a/static/images/asf-rai/llmao-key-created.png b/source/events/2026/community-over-code/asf-rai/llmao-key-created.png
similarity index 100%
rename from static/images/asf-rai/llmao-key-created.png
rename to source/events/2026/community-over-code/asf-rai/llmao-key-created.png
diff --git a/static/images/asf-rai/llmao-my-keys.png b/source/events/2026/community-over-code/asf-rai/llmao-my-keys.png
similarity index 100%
rename from static/images/asf-rai/llmao-my-keys.png
rename to source/events/2026/community-over-code/asf-rai/llmao-my-keys.png
diff --git a/static/images/asf-rai/rai-logo-apache.png b/source/events/2026/community-over-code/asf-rai/rai-logo-apache.png
similarity index 100%
rename from static/images/asf-rai/rai-logo-apache.png
rename to source/events/2026/community-over-code/asf-rai/rai-logo-apache.png