Show Markdown Headings in Left Nav Bar

[freepicheep]

Is there a way to have markdown headings appear in the left nav bar? I know that you can have them in a separate right nav bar, but my client would like them in the left nav bar like this:

[h-enk]

Yes, there is, but not out of the box. You'd have to override the left sidebar.

Id est, copy:

• node_modules/@thulite/doks-core/layouts/partials/sidebar/section-menu.html and/or
• node_modules/@thulite/doks-core/layouts/partials/sidebar/render-section-menu.html

to:

• layouts/partials/sidebar/section-menu.html and
• layouts/partials/sidebar/render-section-menu.html

Next, update for something like this:

• node_modules/@thulite/doks-core/layouts/partials/sidebar/docs-toc-desktop.html

[freepicheep]

Thank you! I have something that works now. For any others who want to do this, here is my current layouts/partials/sidebar/render-section-menu.html

{{- /* Configure. */}}
{{- $skipHome := true }}

{{- /* Get parameters. */}}
{{- $currentPage := .currentPage }}
{{- $nodes := .nodes }}

{{- /* Render. */}}
<nav class="section-nav docs-links">
  <ul class="list-unstyled">
    {{- range $nodes }}
      {{- if and .Page.IsHome $skipHome }}
        {{- continue }}
      {{- end }}
      {{- template "walk" (dict "node" . "currentPage" $currentPage) }}
    {{- end }}
  </ul>
</nav>

{{- /* Recurively render list items. */}}
{{- define "walk" }}
  {{- $currentPage := .currentPage }}
  {{- $node := .node }}

  {{- $linkContent := $node.Page.LinkTitle }}
  {{- with $node.Name }}
    {{- $linkContent = . }}
  {{- end }}

  {{- $ariaCurrent := "" }}
  {{- $liClass := "" }}

  {{- if in $currentPage.Ancestors $node.Page }}
    {{- $ariaCurrent = "true" }}
  {{- end }}

  {{- if $currentPage.Eq $node.Page }}
    {{- $ariaCurrent = "page" }}
    {{- $liClass = "active" }}
  {{- end }}

  <li {{- with $liClass }} class="{{ . }}" {{ end -}}>
    {{- with $node.Page.Pages }}
    <details{{- with $ariaCurrent }} open{{- end }}{{- if ne $node.Page.Params.sidebar.collapsed true }} open{{- end }}>
      <summary>{{ $linkContent }}</summary>
      <ul class="list-unstyled list-nested">
        {{- range . }}
          {{- template "walk" (dict "node" . "currentPage" $currentPage) }}
        {{- end }}
      </ul>
    </details>
    {{- else }}
      <a {{- with $ariaCurrent }} aria-current="{{ . }}" {{- end }} href="{{- $node.Page.RelPermalink }}">{{ $linkContent }}</a>
      {{- if and ($currentPage.Eq $node.Page) (partial "private/has-headings.html" $currentPage) }}
        <ul class="list-unstyled list-nested">
          {{- if eq site.Params.doks.scrollSpy true }}
            {{- $currentPage.TableOfContents | replaceRE "<nav id=\"TableOfContents\">" "<nav id=\"toc\">" | replaceRE "<ul>" "<ul class=\"list-unstyled\">" | safeHTML }}
          {{- else }}
            {{- $currentPage.TableOfContents | replaceRE "<ul>" "<ul class=\"list-unstyled\">" | safeHTML }}
          {{- end }}
        </ul>
      {{- end }}
    {{- end }}
  </li>
{{- end }}