Skip to content

Bread-crumbs  #355

@peekxc

Description

@peekxc

I'm having trouble generating bread-crumbs on a quartodoc-based site I'm working on.

Namely, setting the following option in the _quarto.yml file does nothing for me:

website:
  bread-crumbs: true

Interestingly, manually adding the option to the attribute at the top of each qmd page seems to work so long as the title is also included, e.g.

---
title: cover.set_cover_greedy
bread-crumbs: true
---
... // Note: normal H1 header needs to be removed here

According to the quarto docs, bread-crumb generation should be default behavior, yet they don't show in e.g. the vetiver docs even though they aren't specified. This leads to me to believe that maybe it's a quartodoc issue (it might be a quarto one though).

According to the docs:

By default, navigational breadcrumbs are displayed above the page title on each page that is nested deeper than one level in the sidebar navigation.

My sidebar.yml is quite uniform and meets the requirements I believe:

website:
  sidebar:
  - contents:
    - name: Geomcover
      href: ./index.qmd
    - section: Set Cover (`cover`)
      contents:
        - ./cover.coverage.qmd
        - ./cover.valid_cover.qmd
        - ./cover.set_cover_greedy.qmd
        - ./cover.set_cover_rr.qmd
        - ./cover.set_cover_ilp.qmd
        - ./cover.set_cover_sat.qmd
    - section: Linear Algebra (`linalg`)
      contents:
        - ./linalg.pca.qmd
        - ./linalg.cmds.qmd      
    - section: Geometry (`geometry`)
      contents:
        - ./geometry.tangent_bundle.qmd
        - ./geometry.bundle_weights.qmd
    - section: I/O (`io`)
      contents:
        - ./io.load_set_cover.qmd
        - ./io.to_canonical.qmd
        - ./io.sets_to_sparse.qmd
        - ./io.sparse_to_sets.qmd
        - ./io.reindex_sparse.qmd
    id: .
  - id: dummy-sidebar

(Here's my source code)

Expected behavior

For reference, here's what breadcrumbs look like when they show up

Screenshot 2024-08-05 at 4 44 31 PM

vs they don't:

Screenshot 2024-08-05 at 4 44 42 PM

Metadata

Metadata

Assignees

No one assigned

    Labels

    .questionFurther information is requestedquarto

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions