Previous and Next Links#

Copy as MarkdownView Markdown

When ssg.pagination is enabled, each article gets previous and next links after the body and before the last-updated line. The order comes from the sidebar: groups are flattened depth-first, and items without an in-site href are skipped.

The feature is off unless you turn it on.

import { oxContent } from "@ox-content/vite-plugin";

export default {
  plugins: [
    oxContent({
      ssg: {
        pagination: true,
      },
    }),
  ],
};

false or omitted keeps the pager off. true enables the defaults. An object also enables the feature.

The first page has no previous link. The last page has no next link. A single-page sidebar emits nothing. Entry pages skip the pager. Bare mode never emits pager chrome.

Frontmatter#

Override one side, or hide it:

---
title: Guide
prev:
  text: Back to intro
  link: /intro/
next: false
---

Override hrefs that use javascript: or data: are dropped.