Issues
Break can group posts into issues, the way a magazine groups articles into editions. An issue is an ordinary public tag whose slug starts with issue-. Once a tag has such a slug, Break treats every post that carries it as part of that issue.
Setup Instructions#
- Navigate to ⛭ Settings → Tags
- Click New tag
- Enter a Name, for example
Issue 01: Chokepoints - Set the Slug to
issue-01. The slug has to start withissue- - Optionally add a Description. It appears under the issue's name
- Click Save
- Open each post that belongs to the issue, go to Post settings → Tags, and add the issue tag
An issue tag is a normal public tag, not an internal one, so do not type a
leading #. The slug is what makes a tag an issue. A tag named Issue 01
with the slug issue-01 works, while the same name with the slug
first-issue does not.
The /issues/ page needs the routes.yaml file that ships with the theme. If you have not uploaded it yet, follow the Getting Started guide, otherwise the URL returns a 404.
Where Issues Appear#
| Place | What it shows |
|---|---|
/issues/ | Every issue, one block per issue, with up to 6 of its posts |
| Bottom of a post | More from Issue 01, up to 8 other posts from the same issue |
/tag/issue-01/ | The issue's own archive with all of its posts |
The issues page#
The page opens with an Issues heading and the line Browse every issue of the publication. Below it, every issue gets a block, newest first. The order follows the date each tag was created, not the number in its name, so create your issue tags in publication order.
Each block shows:
- the tag name as the heading
- the tag description under it
- a View All link to the issue's archive
- up to 6 of the issue's posts as cards, newest first
An issue with no published posts is skipped, so a tag created in advance stays hidden until you publish into it. The page lists up to 50 issues.
Add the page to ⛭ Settings → Navigation with the URL /issues/ so readers can find it.
More from an issue#
At the bottom of a post that belongs to an issue, after You might also like, Break adds a More from Issue 01 section with up to 8 other posts from that issue. The heading uses the tag's name. The post being read is left out, and a View issue link leads to the issue's archive.
A post that belongs to two issues gets one section for each.
The issue archive#
An issue tag has a normal tag archive at /tag/issue-01/, with the tag's name and description at the top and every post of the issue below.
Issues Stay Out of Tag Lists#
Issue tags would crowd out your topics, so Break leaves every issue- tag out of the lists it builds from tags:
- the Tags page
- the desks on the front page
- the What do we cover? section of the front page
- the trending tags under Most read
- the topics block in the navigation menu
This happens on its own. You do not need to change the filters to exclude them, and naming an issue slug in a filter does not bring it back.
Small post cards label a post with its first public tag, and the tag list at the end of a post shows every public tag, issues included. Keep the topic tag first in Post settings → Tags and the issue tag after it, so cards keep showing the topic.
Notes#
- The tag has to be public. A tag whose name starts with
#is internal in Ghost and never becomes an issue. - An issue is still a tag. Its posts keep their place on the front page, in
/blog/and on their topic archives.