feat: adjust right sidebar layout and styling

sgfost · sgfost · commit 6664087044b1 · 2023-07-05T16:07:35.000-07:00
- add "on this page" title to toc
- adjust toc styling
- pin github action links to the bottom
diff --git a/assets/scss/main.scss b/assets/scss/main.scss
@@ -54,6 +54,17 @@ footer {
     }
 }
 
+.td-toc a {
+    font-size: 0.9rem;
+    font-weight: normal;
+    line-height: 1.35;
+    padding-bottom: 0.5rem;
+}
+
+.td-search {
+    width: 100%;
+}
+
 // Adjust anchors vs the fixed menu.
 @include media-breakpoint-up(md) {
     .td-offset-anchor:target {
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
@@ -0,0 +1,32 @@
+<!doctype html>
+<html itemscope itemtype="http://schema.org/WebPage" lang="{{ .Site.Language.Lang }}" class="no-js">
+  <head>
+    {{ partial "head.html" . }}
+  </head>
+  <body class="td-{{ .Kind }}{{ with .Page.Params.body_class }} {{ . }}{{ end }}">
+    <header>
+      {{ partial "navbar.html" . }}
+    </header>
+    <div class="container-fluid td-outer">
+      <div class="td-main">
+        <div class="row flex-xl-nowrap min-vh-100">
+          <aside class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
+            {{ partial "sidebar.html" . }}
+          </aside>
+          <aside class="d-flex flex-column col-xl-2 td-sidebar-toc d-print-none">
+            {{ partial "toc.html" . }}
+            {{ partial "taxonomy_terms_clouds.html" . }}
+            {{ partial "page-meta-links.html" . }}
+          </aside>
+          <main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
+            {{ partial "version-banner.html" . }}
+            {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
+            {{ block "main" . }}{{ end }}
+          </main>
+        </div>
+      </div>
+      {{ partial "footer.html" . }}
+    </div>
+    {{ partial "scripts.html" . }}
+  </body>
+</html>
diff --git a/layouts/partials/page-meta-links.html b/layouts/partials/page-meta-links.html
@@ -13,7 +13,7 @@
     {{ $issueURL := (printf "%s/issues/new?%s" $gh_repo $queryString) }}
     {{ $github_discuss_category := ($.Param "github_discuss_category" | default "general") }}
 
-    <div class="td-page-meta ml-2 pb-1 pt-2 mb-0">
+    <div class="td-page-meta ml-2 pb-1 pt-2 mb-0 mt-auto">
     {{ if $gh_repo }}
         {{ $discussionURL := (printf "%s/discussions/categories/%s" $gh_repo $github_discuss_category) }}
         {{ $newDiscussionURL := (printf "%s/discussions/new?category=%s" $gh_repo $github_discuss_category) }}
diff --git a/layouts/partials/toc.html b/layouts/partials/toc.html
@@ -0,0 +1,10 @@
+{{ if not .Params.notoc -}}
+  {{ with .TableOfContents -}}
+    {{ if ne . `<nav id="TableOfContents"></nav>` -}}
+      <p class="pb-2 border-bottom border-primary text-primary"><b>On this page</b></p>
+      <div class="flex-grow-1 td-toc">
+        {{ . }}
+      </div>
+    {{ end -}}
+  {{ end -}}
+{{ end -}}
