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

main_subsite

supporters

location.name

hide_tease

autotoc

Image Handling

Option A - Same directory (simpler):

![Description](./image.png)
![Description](image.png)

Option B - images/ subdirectory (for many images):

<img src="./images/figure1.png" />

CRITICAL: HTML img tags MUST use

./

• <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: #xxx

• background: linear-gradient(...)

• color

  ,

  padding

  ,

  border-radius

• Emojis work (flags: 🇪🇺 🇺🇸 🇦🇺)

Workflow

1. Create branch:

   git checkout -b news/post-slug

2. Create directory:

   mkdir -p content/news/YYYY-MM-DD-slug-name

3. Add index.md with frontmatter
4. Add images (resize large ones first)
5. For Vega charts: create gist, use raw URL
6. Test locally:

   yarn develop

7. Commit and push

Common Issues

./

References

• See

  references/formatting.md

  for detailed formatting guide
• See

  examples/sample-post.md

  for complete template