SpaceClub!

Posts

Posts are blog-style content - articles, updates, announcements, recaps. Each post is a Markdown file in the src/posts/ folder.

Creating a Post

  1. Copy src/posts/template.md (an example post) and rename it (e.g. src/posts/my-first-post.md).
  2. Edit the front matter and content:
---
title: My First Post
description: A quick update on what we've been up to.
postDate: 2026-02-24
author: Jane Smith
---
 
Write your post content here using Markdown.
 
## A Subheading
 
More content, **bold text**, [links](https://example.com), images, whatever you need.
  1. Save the file. The post will appear automatically on the posts listing page and on the homepage.

Or skip the files entirely: in SpaceDash, go to Posts and click New.

Front Matter Properties

PropertyRequiredDescription
titleYesThe post title.
descriptionRecommendedA short summary shown on post cards and in search results. It also appears in search result previews and in SEO meta tags.
postDateYesThe publication date in YYYY-MM-DD format (e.g. 2026-02-24). Used for sorting - newest posts appear first.
authorNoThe author name, shown on the post page.
imageNoPath to a header image shown on the post card (e.g. /assets/images/my-photo.jpg).
preview_imageNoA separate image used in search result previews. Falls back to image if not set.
featuredNoSet to true to mark as featured. Featured posts appear in the featured section (if enabled on the homepage).
galleryNoPath to a folder of images to display as a gallery on the post. See Gallery.
eventPageNoThe event this post is about - its file name (e.g. open-day) or its address (e.g. /events/open-day/). Displays a link to the event after the post.

Title and description matter. The title is what appears in browser tabs, search results, and when someone shares your post. The description appears in search result previews and SEO meta tags. Writing a clear, specific title and description for every post makes your site much more useful and findable. See Search for how the search system uses these fields.

How Posts Are Displayed

Posts Listing Page

SpaceClub! makes the /posts/ page for you, showing all posts sorted by date (newest first). There’s no file to edit.

Homepage

The homepage shows your latest posts and events through the feed. See The Feed to change what it shows.

News Feed

Your posts also have a news feed at /feed.xml, so people can follow them in a feed reader. Turn it off with "rss": false in spaceclub.json (see Features).

Individual Post Pages

Each post gets its own page at /posts/your-filename/. The URL is derived from the filename - my-first-post.md becomes /posts/my-first-post/.

Posts use the post.njk layout, which is set automatically by the posts.json directory data file. You don’t need to specify a layout in each post.

To feature a post, add featured: true to its front matter:

---
title: Big Announcement
postDate: 2026-02-24
featured: true
---

To show only featured posts and events somewhere, use the feed with feedFeatured:

{% set feedTitle = "Featured" %}
{% set feedFeatured = "yes" %}
{% include "partials/feed.njk" %}

Linking Posts to Events

If a post is a recap of an event, you can link them together:

In the post, add eventPage pointing to the event:

---
title: Game Night Recap
postDate: 2026-02-25
eventPage: /events/game-night/
---

In the event, add recapPost pointing to the post:

---
title: Game Night
eventDate: 2026-02-24
recapPost: /posts/game-night-recap/
---

Both pages will show a link to the other.

Tips

  • The example post - src/posts/template.md is a real post, dated far in the future so it stays at the top. Change it into your first post, or delete it.
  • Filenames matter - The filename becomes the URL. Use lowercase with hyphens: my-post-title.md → /posts/my-post-title/.
  • Date format - Always use YYYY-MM-DD for postDate. The display format is controlled by site.json’s dateFormat setting.
  • Images - Place post images in src/assets/images/ and reference them as /assets/images/filename.jpg.
  • Markdown is flexible - You can use HTML within Markdown files when needed, including Bootstrap classes.

Graph View

Backlinks