Avoid displaying just title in breadcrumbs

[nineteendo]

See pradyunsg/furo#843

[pradyunsg]

Hmm... Isn't breadcrumb_include_page sufficient for controlling whether just the page title is shown?

[pradyunsg]

From https://sphinx-basic-ng.readthedocs.io/en/latest/usage/components/breadcrumbs/:

There are 2 values that can be provided via the html-context, which provide control over the components shown in the breadcrumbs:

[snip]

• breadcrumb_include_page: If truthy, the current page is included in the breadcrumb as the final list-item, with only a span (there’s no a[href] in it). The corresponding list-item will have an additional class: breadcrumb-nav-page-item.

[nineteendo]

It's just a bit pointless to show breadcrumbs if there are no links to parent pages. You're just repeating the title for no benefit. By not doing this you can use the style of https://just-the-docs.com.

[pradyunsg]

It's just a bit pointless to show breadcrumbs if there are no links to parent pages.

I agree, but disagree that having it in the DOM is useless.

Scroll on https://pradyunsg-cpython-lutra-testing.readthedocs.io/en/latest/c-api/index.html -- that's an excellent example of why having the current page title in breadcrumbs is useful.

[nineteendo]

I'm afraid you don't understand what I mean, so let me try again with some images:

1. The breadcrumbs here don't add any value, they just repeat the title without linking to a parent:

---

2. They also don't add value if they link to the home page on the home page (that's why we have pagename != 'index'):

---

3. On child pages, they're useful because they link to the parents:

[nineteendo]

Do you think this should be configurable? In the long run I want to delete my fork.