[Anchor Link Request] Main Navigation override with custom links about just-the-docs HOT 4 CLOSED

@Corey-Albright-OnTheClock I absolutely had to have the ability to navigate between markdown anchor links from child navigation items in the main menu as well. After a lot of trial and error, I figured out a way to do this without reloading the current parent view. I have twice as many anchor sections under Core Concepts than listed here. So, naturally, I wanted to improve navigation to each section without separating each section into its own markdown file OR having to reload the page to link to these section in the child menu navigation. (just as you have described)

My menu structure looks like this:

• About
  • Core Concepts
    • Data Flow
    • Object Types
    • Authentication
    • Pagination
    • Error Handling
    • Data Flow
    • Configurations
    • Filters

My Solution

Given the above structure, my solution was to create a folder sectionAnchors in the same file location of the parent navigation page coreConcepts.md. Then, I created the empty (except config) markdown files with for each of the sections inside the sectionAnchors folder. The key here is to NOT provide a layout in the placeholder empty config child sectionAnchors markdown files as shown below in the dataFlow.md example.

coreConcepts.md (Parent)

---
layout: page
title: Core Concepts
permalink: /about/concepts
parent: About
nav_order: 2
has_children: true
---

## Data Flow
A ton of text and explanations of how to understand the data flow.

dataFlow.md (coreConcepts's child anchor link)

---
title: Data Flow
permalink: /about/concepts#data-flow
parent: Core Concepts
nav_order: 1
---

Note

Local and published anchor permalinks seem to behave slightly differently for some reason and require an extra / before the # when running things locally for this to work? (see below).

Published: Github Pages

/about/concepts#data-flow

Local: bundle exec jekyll serve.

/about/concepts/#data-flow

from just-the-docs.

I am considering the following alternatives:

• refresh page after 1 second and goes to permalink (long handed and tedious)
  -- parent page to include page with refresh to 1 second on running page that would link to the insertion point for the div
• Editing file:
  -- nav.html

from just-the-docs.

A perfect example:
Navigation Structure
would be to put the TOC within the section: all of the TOC on left side within the section called Navigation Structure

Like:

Navigation Structure:
--> Main navigation
Ordering pages
Excluding pages
Pages with children
Child pages
Auto-generating Table of Contents
Children with children
Auxiliary Navigation
In-page navigation with Table of Contents

^ On left side / main nav under Navigation Structure

from just-the-docs.

This is not something we will support out-of-the-box at this time.

from just-the-docs.