Advanced

The archive

Your article archive at /articles/: posts filed under month headings, a filter row of your five most-used tags, twelve posts a page, and where your RSS feeds live.

Quiet's archive is a reading index rather than a wall of cards: no pictures anywhere, posts filed under the month they were published, one line each. On a site with a few hundred essays that is the difference between a page you can scan and a page you scroll past.

The archive - Editor

The archive

The archive

The archive

Set it up

The archive lives at /articles/, which needs the routes file and a page slugged articles. Both are covered in Installation, steps 4 and 5.

Publish a page with the slug articles. The title becomes the archive's heading.

Add an Excerpt to that page: it becomes the line under the heading. Without one, Quiet falls back to your site description.

Upload the routes file at Settings → Labs → Beta features → Upload routes file.

Add Articles to your menu at Settings → Navigation, pointing at /articles/.

Without the routes file

The archive still works, it just has no first page of its own: Ghost puts your posts on the homepage and the archive layout starts at /page/2/. That is why the routes file exists, and it is the one part of setup worth doing even on a small site.

What is on the page

  • The heading and the count. "Articles · 47 posts", taken from the page's title and Ghost's own total.
  • The filter row. Pills for your five most-used public tags, most used first, plus an All pill. It hides itself on a site with no public tags.
  • Month sections. A month and year on the left, that month's posts on the right.
  • Each row: the post's category, its title, its date, its reading time, and a padlock if it is members-only.
  • Pagination, at twelve posts a page.

Twelve posts a page, fixed

The archive's page size is set by the theme and is not a setting in Ghost Admin. Home latest count in Homepage settings changes the homepage band, not this page.

The filter row is automatic

There is nothing to curate. Quiet asks Ghost for your five most-used public tags and shows them in that order, so the row follows what you actually write about. Clicking a pill goes to Ghost's own tag page, which lists that tag's posts in two columns.

To send readers somewhere richer than a tag page, build the topic tiles band on your homepage instead: the tiles use each tag's own picture and description.

What is not in the archive

Podcast episodes and films. Both are posts, but the routes file keeps them in their own collections, so /articles/ lists your writing only. Their homes are /podcast/ and /videos/.

Your feeds

Installing the routes file moves your feed. Worth knowing exactly where things end up:

FeedAddressNotes
Your writing/articles/rss/This is your main feed once the routes file is installed, and the one Quiet's footer icon links to
Films/videos/rss/On, and useful if you want a feed of films
Episodes/podcast/rss/Deliberately off. A theme cannot produce a valid podcast feed (there is no place for audio files, episode numbers or duration), and a broken one in a podcast directory is worse than none
/rss/goneWith the routes file installed, this address no longer exists

Update anything pointing at /rss/

A newsletter service, an aggregator or a link in someone's bio that points at /rss/ will break. Point them at /articles/rss/. Quiet's own links follow the change automatically.

Publishing a podcast properly

Use a podcast host (Transistor, Buzzsprout, Captivate and so on) for the feed the directories consume, and embed its player in the body of your /podcast/ page. See The podcast.

The empty state

A brand new site with no posts shows a short "nothing here yet" panel rather than an empty page.