mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-04-24 20:12:23 -06:00
a4e4e312aa
* Allow unlimited multi-level navigation This PR supersedes #462. The only user-level difference from #462 is that disambiguation of parent pages has to use either `grand_parent` or `ancestor` titles: the somewhat unnatural `section_id` and `in_section` fields are not supported. The implementation has been significantly simplified by the changes introduced in v0.7.0 of the theme. * Detect cyclic parenthood A page should not have a parent or ancestor with the same title. If it does, the location of the repeated link is marked by ∞, to facilitate debugging the navigation (and an unbounded loop leading to a build exception is avoided). * Add nav_error_report warning in main navigation When activated by `nav_error_report: true` in `_config.yml`, displays warnings about pages with the same title as their parent page or an ancestral page. * Cache site-nav with links to all pages The extra cached site-nav is used for determining breadcrumbs and children navigation, which may involve pages that are excluded from the main navigation. * Replace code for determining children by inclusion of components/nav/children.html * Update CHANGELOG.md --------- Co-authored-by: Matt Wang <matt@matthewwang.me>
48 lines
1.6 KiB
HTML
48 lines
1.6 KiB
HTML
---
|
|
layout: table_wrappers
|
|
---
|
|
|
|
<!DOCTYPE html>
|
|
|
|
<html lang="{{ site.lang | default: 'en-US' }}">
|
|
{% include head.html %}
|
|
<body>
|
|
<a class="skip-to-main" href="#main-content">Skip to main content</a>
|
|
{% include icons/icons.html %}
|
|
{% if page.nav_enabled == true %}
|
|
{% include components/sidebar.html %}
|
|
{% elsif layout.nav_enabled == true and page.nav_enabled == nil %}
|
|
{% include components/sidebar.html %}
|
|
{% elsif site.nav_enabled != false and layout.nav_enabled == nil and page.nav_enabled == nil %}
|
|
{% include components/sidebar.html %}
|
|
{% endif %}
|
|
<div class="main" id="top">
|
|
{% include components/header.html %}
|
|
<div class="main-content-wrap">
|
|
{% include components/breadcrumbs.html %}
|
|
<div id="main-content" class="main-content">
|
|
<main>
|
|
{% if site.heading_anchors != false %}
|
|
{% include vendor/anchor_headings.html html=content beforeHeading="true" anchorBody="<svg viewBox=\"0 0 16 16\" aria-hidden=\"true\"><use xlink:href=\"#svg-link\"></use></svg>" anchorClass="anchor-heading" anchorAttrs="aria-labelledby=\"%html_id%\"" %}
|
|
{% else %}
|
|
{{ content }}
|
|
{% endif %}
|
|
|
|
{% if page.has_toc != false %}
|
|
{% include components/children_nav.html %}
|
|
{% endif %}
|
|
</main>
|
|
{% include components/footer.html %}
|
|
</div>
|
|
</div>
|
|
{% if site.search_enabled != false %}
|
|
{% include components/search_footer.html %}
|
|
{% endif %}
|
|
</div>
|
|
|
|
{% if site.mermaid %}
|
|
{% include components/mermaid.html %}
|
|
{% endif %}
|
|
</body>
|
|
</html>
|