| name | hub-news-posts |
| description | This skill should be used when creating Galaxy Hub news posts, writing content for galaxyproject.org/news, or converting content to Galaxy Hub markdown format. |
Galaxy Hub News Posts
Create news posts for the Galaxy Project website (galaxyproject.org).
Directory Structure
Posts live in /content/news/YYYY-MM-DD-slug-name/:
content/news/2025-01-15-my-announcement/
├── index.md # Main content file
├── hero.png # Images in same directory
└── images/ # OR in images/ subdirectory
└── figure1.png
Required Frontmatter
---
title: "Post Title"
date: "YYYY-MM-DD"
tease: "Short description for listing pages"
authors: "Author Name"
tags: [galaxy, training, tools]
subsites: [all]
---
Optional Frontmatter Fields
| Field | Description |
|---|---|
main_subsite |
Primary subsite (eu, freiburg, global) |
supporters |
Funding/support logos [elixir, denbi, eosc] |
location.name |
Event location |
hide_tease |
Set false to show tease on listing |
autotoc |
Enable/disable table of contents |
Image Handling
Option A - Same directory (simpler):
Option B - images/ subdirectory (for many images):
<img src="./images/figure1.png" />
CRITICAL: HTML img tags MUST use ./ prefix:
<img src="./images/x.png">✓<img src="images/x.png">❌ (build fails!)
Vega Charts
Use external URLs only (gists work well):
<vega-embed spec="https://gist.githubusercontent.com/user/id/raw/hash/chart.json" />
Create gist: gh gist create chart.json --public
Local file paths do NOT work with vega-embed.
Styled HTML Tables
<table class="table">
<tr>
<td style="background: linear-gradient(135deg, #667eea, #764ba2); color: white; padding: 15px;">
<strong>Value</strong><br/>label
</td>
</tr>
</table>
Supported styles:
background-color: #xxxbackground: linear-gradient(...)color,padding,border-radius- Emojis work (flags: 🇪🇺 🇺🇸 🇦🇺)
Workflow
- Create branch:
git checkout -b news/post-slug - Create directory:
mkdir -p content/news/YYYY-MM-DD-slug-name - Add index.md with frontmatter
- Add images (resize large ones first)
- For Vega charts: create gist, use raw URL
- Test locally:
yarn develop - Commit and push
Common Issues
| Problem | Solution |
|---|---|
| Build fails on images | Use ./ prefix in HTML img src |
| Vega chart blank | Must use external URL (gist), not local file |
| Large images slow build | Resize with PIL before committing |
References
- See
references/formatting.mdfor detailed formatting guide - See
examples/sample-post.mdfor complete template