Pagination

Listing pages automatically paginate regular posts when there are more than 20. Featured posts are not paginated — they always appear at the top.

How it works

• Page size: 20 regular posts per page.
• Featured posts: shown in full above the pagination — never paginated regardless of count.
• Sort order: newest first (by date). Posts without a date appear after dated posts.
• URL parameter: ?page=N — page numbers start at 1.

Example URLs:

/blog          → page 1 (default)
/blog?page=2   → page 2
/blog?page=3   → page 3

Out-of-range pages

If ?page=N exceeds the total number of pages, OnyxFolio clamps the value to the last valid page. No 404 for out-of-range page numbers.

Listing template

The listing.html template renders:

1. Featured posts — horizontally highlighted cards (all, no pagination)
2. Regular posts — cards, 20 per page
3. Pagination controls — prev/next page links with current page indicator

Section scope

Pagination covers posts in the section and all sub-sections. A listing at /blog paginates both blog/*.md and blog/series/*.md posts together.

See also

• Post Types — type: listing creates the listing page
• Navigation — how section listing pages appear in the nav