Breadcrumbs not working for grand-child pages

[Tom-H2oThermo]

I've noticed the breadcrumb links aren't working for grandchild pages. They are visible on these pages, but the links don't do anything. They do work for child pages. I've filled in the children, parent and grand-parent fields as applicable. Is this a known bug?

[mattxwang]

Hi @TomMcAuliffe, thanks for submitting a discussion. Can you provide us a link to your repository and site so we can debug better? With the current information, it'd be hard for us to help. Thanks!

[Tom-H2oThermo]

https://github.com/TomMcAuliffe/H2oThermoSite

[Tom-H2oThermo]

Thanks for the quick response Matt! I’ve been just running locally, but I’ll put my website project out on GitHub and share it. BTW, I’m mechanical engineer, not a programmer by profession, so still figuring things out. Regards, Tom From: Matt Wang ***@***.***> Sent: Wednesday, February 21, 2024 5:07 PM To: just-the-docs/just-the-docs ***@***.***> Cc: TomMcAuliffe ***@***.***>; Mention ***@***.***> Subject: Re: [just-the-docs/just-the-docs] Breadcrumbs not working for grand-child pages (Discussion #1429) Hi @TomMcAuliffe <https://github.com/TomMcAuliffe> , thanks for submitting a discussion. Can you provide us a link to your repository and site so we can debug better? With the current information, it'd be hard for us to help. Thanks! — Reply to this email directly, view it on GitHub <#1429 (comment)> , or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGEBWKX3MLSMIDRZN3ROKSDYU2DY3AVCNFSM6AAAAABDT6ZJBKVHI2DSMVQWIX3LMV43SRDJONRXK43TNFXW4Q3PNVWWK3TUHM4DKNJQGE2DK> . You are receiving this because you were mentioned. <https://github.com/notifications/beacon/AGEBWKQ6JQ3JLYTMEVIQWILYU2DY3A5CNFSM6AAAAABDT6ZJBKWGG33NNVSW45C7OR4XAZNRIRUXGY3VONZWS33OINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAQJ3QC.gif> Message ID: < ***@***.***> ***@***.***>

[Tom-H2oThermo]

I also just noticed that the parent pages have a TOC at the bottom with links. The next level, child pages that have children, show "Table of Contents" at the bottom but it does not automatically generate links below that to its children. I don't need this feature, just thought I'd mention it. I just turned off the TOC for these pages.

[pdmosses]

@TomMcAuliffe Please check that all the parent and grand_parent fields in your source files refer to page titles, rather than file names. See the theme docs for examples of how to specify such fields.

Currently, home-page.md has:¹

title: 'Home Page'

In examples/evaporative-cooling.md you currently have:

grand_parent: home-page

Try replacing the latter by:

grand_parent: Home Page

If you do that for all grandchild pages, their breadcrumbs and TOCs should work. Just the Docs Tests has quite extensive regression tests for these features.

Footnotes

1. The home page for a site is usually at /index.md. ↩

[Tom-H2oThermo]

Peter, thank you for your response. I think that I found my error, which is that I failed to enclose the titles of the parent and grandparent is single quote. Stupid mistake. Thank you so much, I greatly appreciate the Just the Docs theme, its very useful and will maintained.

[Tom-H2oThermo]

well maintained