DOCS-3412: Show left nav for tutorials and hidden pages (#3884)

Author: npentrel

assets/scss/_styles_project.scss

@@ -232,11 +232,11 @@ a > code {
   color: #333333 !important;
 }
 
-.nav-fold * #TableOfContents ul li ul {
+#TableOfContents ul li ul {
   padding: 0;
 }
 
-.nav-fold * #TableOfContents ul li ul.is-collapsed {
+#TableOfContents ul li ul.is-collapsed {
   display: none;
 }
 
@@ -2856,6 +2856,15 @@ a.tree-root {
 
 // Top level nav END
 
+// For tutorials, make side nav heading smaller
+
+li.active-path.tutorial-heading > a {
+  color: #0000EA;
+  margin-top: 1rem;
+  font-size: 0.833rem;
+  font-weight: 600;
+}
+
 // Next page START
 
 #next-page {

docs/dev/contributing.md docs/dev/reference/contributing.md

@@ -5,6 +5,8 @@ weight: 99
 type: "docs"
 description: "Learn about our style guide and how to work with hugo to contribute to these docs."
 toc_hide: true
+aliases:
+  - /dev/contributing/
 ---
 
 Thank you for wanting to help us make the docs better.

docs/dev/tools/tutorials.md

@@ -22,6 +22,7 @@ sitemap:
   priority: 1.0
 aliases:
   - /build/
+  - /tutorials/
 outputs:
   - rss
   - html

docs/tutorials/_index.md

@@ -3,11 +3,10 @@ title: "Tutorials"
 linkTitle: "Tutorials"
 weight: 300
 type: docs
-layout: "tutorials"
-hide_children: true
+layout: "empty"
 sitemap:
   priority: 1.0
-hidden: true
+toc_hide: false
 outputs:
   - rss
   - html

layouts/partials/sidebar-tree.html

@@ -43,15 +43,30 @@
 {{ $activePath := and (not $shouldDelayActive) (or ($p.IsDescendant $s) (eq $p $s)) -}}
 {{ $show := cond (or (lt $ulNr $ulShow) $activePath (and (not $shouldDelayActive) (eq $s.Parent $p.Parent)) (and (not $shouldDelayActive) (eq $s.Parent $p)) (not $p.Site.Params.ui.sidebar_menu_compact) (and (not $shouldDelayActive) ($p.IsDescendant $s.Parent))) true false -}}
 {{ $mid := printf "m-%s" ($s.RelPermalink | anchorize) -}}
-{{ $pages_tmp := where (union $s.Pages $s.Sections).ByWeight ".Params.toc_hide" "!=" true -}}
+{{ $pages_tmp := (union $s.Pages $s.Sections).ByWeight -}}
 {{ $pages := $pages_tmp | first $sidebarMenuTruncate -}}
 {{ $withChild := gt (len $pages) 0 -}}
 {{ $hideChildren := cond (isset $s.Params "hide_children") true false -}}
 {{ $manualLink := cond (isset $s.Params "manuallink") $s.Params.manualLink ( cond (isset $s.Params "manuallinkrelref") (relref $s $s.Params.manualLinkRelref) $s.RelPermalink) -}}
 {{ $manualLinkTitle := cond (isset $s.Params "manuallinktitle") $s.Params.manualLinkTitle $s.Title -}}
 {{ $empty_node := $s.Params.empty_node -}}
+{{ $toc_hide := $s.Params.toc_hide -}}
 {{ $openOnDesk := $s.Params.open_on_desktop }}
 {{ $headerOnly := $s.Params.header_only }}
+
+{{ if eq $p.Section "tutorials"}}
+<!-- If this is a tutorial -->
+<a href="/dev/tools/tutorials/" target="{{ . }}" rel="noopener" class="">
+<span> Tutorials </span>
+</a>
+<li class="active-path tutorial-heading">
+  <a href="" title="{{ $p.Title }}" class="active">{{ $p.LinkTitle }}
+  </a>
+  <div class="td-toc" id="TableOfContents"></div>
+</li>
+{{ else }}
+
+{{ if or ( or (not $toc_hide) ($activePath) ) $active }}
 <li class="{{ if $withChild }}nav-fold{{ end }}{{ if $activePath }} active-path{{ else }}{{ if $p.Parent }} hide-if-desktop{{ end }}{{ end }}{{ if (not (or $show $p.Site.Params.ui.sidebar_menu_foldable )) }} {{ if not $activePath }}collapse{{ end }}{{ end }}{{ if $empty_node }} empty-node-submenu{{ end }}{{if $s.Params.menuindent }} indent{{ end }}{{ if $openOnDesk }} open-on-desktop{{ end }}{{ if $headerOnly }} header-only{{ end }}" >
   {{ if (and $p.Site.Params.ui.sidebar_menu_foldable (ge $ulNr 1)) -}}
   <input type="checkbox" id="{{ $mid }}-check"{{ if $activePath}} checked{{ end }}/>
@@ -60,20 +75,23 @@
   {{ else -}}
   {{- if $withChild }}
     <span>
-      {{ if $empty_node }}
-      <!-- IF EMPTY NODE WITH CHILDREN -->
-        <span class="emptynode {{ if $active}}active{{ end }} {{ if $treeRoot }} tree-root{{ end }}">{{ $s.LinkTitle }}</span>
-      {{ else }}
-        {{ if not (eq $s.LinkTitle "Tutorials") }}
-        <a href="{{ $manualLink }}"{{ if ne $s.LinkTitle $manualLinkTitle }} title="{{ $manualLinkTitle }}"{{ end }}{{ with $s.Params.manualLinkTarget }} target="{{ . }}"{{ if eq . "_blank" }} rel="noopener"{{ end }}{{ end }} class="{{ if $active}} active{{ end }}{{ if $treeRoot }} tree-root{{ end }}">
-          {{ if $s.Params.overview }}
-          <span class="section-overview"> Overview </span><span class="section-overview-title"> {{ $s.LinkTitle }} </span>
+      {{ if or (not $toc_hide) ($activePath)}}
+        {{ if $empty_node }}
+        <!-- IF EMPTY NODE WITH CHILDREN -->
+          <span class="emptynode {{ if $active}}active{{ end }} {{ if $treeRoot }} tree-root{{ end }}">{{ $s.LinkTitle }}</span>
+        {{ else }}
+          {{ if not (eq $s.LinkTitle "Tutorials") }}
+          <a href="{{ $manualLink }}"{{ if ne $s.LinkTitle $manualLinkTitle }} title="{{ $manualLinkTitle }}"{{ end }}{{ with $s.Params.manualLinkTarget }} target="{{ . }}"{{ if eq . "_blank" }} rel="noopener"{{ end }}{{ end }} class="{{ if $active}} active{{ end }}{{ if $treeRoot }} tree-root{{ end }}">
+            {{ if $s.Params.overview }}
+            <span class="section-overview"> Overview </span><span class="section-overview-title"> {{ $s.LinkTitle }} </span>
+            {{ else }}
+            <span> {{ $s.LinkTitle }} </span>
+            {{ end }}
+            {{ if $s.Params.canonical }}<i class="fas fa-external-link-alt fa-sm"></i>{{ end }}
+          </a>
           {{ else }}
-          <span> {{ $s.LinkTitle }} </span>
           {{ end }}
-          {{ if $s.Params.canonical }}<i class="fas fa-external-link-alt fa-sm"></i>{{ end }}
-        </a>
-        {{ end }}
+        {{- end }}
       {{- end }}
       {{- if (or (and $withChild (not $treeRoot) ) (not $hideChildren) ) }}
       {{- if (or $hideChildren $treeRoot) -}}
@@ -104,7 +122,7 @@
   {{ end }}
   {{- end }}
   {{- if $withChild }}
-    {{- if $hideChildren -}}
+    {{- if and ($hideChildren) (not $activePath) -}}
     {{- else -}}
       {{- $ulNr := add $ulNr 1 }}
       <ul class="ul-{{ $ulNr }}">
@@ -115,4 +133,6 @@
     {{- end }}
   {{- end }}
 </li>
-{{- end }}
+{{- end }}
+{{- end }}
+{{- end}}