Clickable categories not working on github pages - only in local `quarto preview`

[jamespeapen]

I've set up a quarto book on github pages with a category listing: https://jamespeapen.github.io/journals/. The category labels are created and are clickable from the home index.html page, but not from their individual tags in each book page(like on this page) on the github website. But if I use quarto preview locally the tags are clickable. It looks like they have links only with quarto preview:

Github pages:

<div class="quarto-categories">
    <div class="quarto-category">cancer genomics</div>
    <div class="quarto-category">epigenetics</div>
    <div class="quarto-category">intro</div>
  </div>

With quarto-preview:

<div class="quarto-categories">
    <div class="quarto-category"><a href="/index.html#category=cancer%20genomics">cancer genomics</a></div>
    <div class="quarto-category"><a href="/index.html#category=epigenetics">epigenetics</a></div>
    <div class="quarto-category"><a href="/index.html#category=intro">intro</a></div>
</div>

The listings.json file is created by the github action.

Here is the workflow I use:

on:
  push:
    branches: main
  pull_request:
    branches: main
  # to be able to trigger a manual build
  workflow_dispatch:

name: Render and deploy Book

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Install Quarto
        uses: quarto-dev/quarto-actions/install-quarto@v1

      - name: Build book
        run: |
          git config --global user.name "${GITHUB_ACTOR}"
          git config --global user.email "${GITHUB_ACTOR}@users.noreply.github.com"
          git checkout -b gh-pages
          quarto render --to html
          git add docs
          cid=$(git rev-parse --short "$GITHUB_SHA")
          git commit -am "Deploy $cid to gh-pages"
          git push origin HEAD:gh-pages --force

[dragonstyle]

I'm still looking into this, but I bet the issue is related to the final URL that is being used. Category links are activated on the client when the page loads by trying to find the nearest listing that contains this document (we'll then activate the category link to point to that page). I'm guessing that we're failing to match the path as deployed, though I still haven't figured out the best way to reproduce this so I can confirm and fix. Will keep you updated here.

[dragonstyle]

This was a little difficult for me to replicate exactly (as it has to do with the fact that the listing page when running in using preview is at the root level of the site while when deployed it is in a subdirectory), but I believe that the commit above fixed this issue. Would appreciate it if you could take a look and confirm whether things appear to be working now.

Appreciate you reporting this!

[dragonstyle]

(We're building a fresh release with this change that should be ready in a few minutes).

[jamespeapen]

I just reran the workflow twice and unfortunately the category labels are still not links. I also used the example workflow with no luck.
The tags do work as links when running python -m http.server in the gh-pages branch docs folder locally. Could this be a github issue since the quarto blog also has category links that work?

[dragonstyle]

Ok thanks for checking, I guess I have a bit more work to do here. I definitely think I understand the issue, but perhaps not quite well enough to have fixed it. I'll try again getting a local simulation of the issue and get that resolved, then post an update here... thx for your patience...

[dragonstyle]

Ok apologies for the delay. I've managed to reproduce the issue and feel pretty confident that I have the fix ready. It is available now here:

https://github.com/quarto-dev/quarto-cli/releases/tag/v0.9.464

Can you give it one more try for me? Thank you!

[jamespeapen]

It's working - thank you for the fix!