quarto-dev / quarto-dev/quarto-cli

Support `page-navigation` for blog listings

Open
#3,795 6 comments 36 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement listings website-navigation websites
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Discussed in https://github.com/quarto-dev/quarto-cli/discussions/3775

Currently page-navigation can only navigate between pages in a sidebar, but not between pages in a blog or listing. It would be a great improvement if it was possible to use page-navigation in these cases too.

This is generally nice for blogs, as it might encourage readers to check other posts. But it also opens up the possibility to write a series of related posts under their own listing which users can navigate between, like in Hugo Apero.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the discussion at https://github.com/quarto-dev/quarto-cli/discussions/3775 and trace the existing page-navigation behavior for sidebar pages. Identify the blog and listing navigation entry points, then verify that page-navigation works between related posts and listing pages without regressing sidebar navigation.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
content
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.