ScrollSpy: drop smooth scrolling (#2291)

Co-authored-by: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com>

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+*.cmd text eol=crlf
+*.bat text eol=crlf

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,26 @@
+---
+name: Bug report
+labels: [bug, needs-triage]
+about: Create a report to help us improve
+---
+
+<!-- Describe you environment by answering the questions below. Put your answers after the colon on each line. -->
+
+### Environment
+
+- [ ] Version of Docsy you are using:
+- [ ] How are you using Docsy? As a:
+  - [ ] Hugo module
+  - [ ] NPM module
+  - [ ] Git submodule
+  - [ ] Other:
+- [ ] Version of Hugo you are using (output of `hugo version`):
+- [ ] OS:
+  - [ ] Linux
+  - [ ] macOS
+  - [ ] Windows
+  - [ ] Other:
+
+### Problem
+
+<!-- Concisely describe the problem you are seeing, ideally provide steps to reproduce it. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+blank_issues_enabled: true
+contact_links:
+  - name: SUPPORT, ISSUES, and TROUBLESHOOTING
+    url: https://github.com/google/docsy/discussions
+    about:
+      Please DO NOT use GitHub issues for support requests, instead start a
+      discussion thread at https://github.com/google/docsy/discussions. Feel
+      free to open an issue once your problem is confirmed by the docsy
+      maintainers and/or the docsy community.

.github/ISSUE_TEMPLATE/enhancement.md

@@ -0,0 +1,7 @@
+---
+name: Enhancement proposal
+labels: [enhancement, needs-triage]
+about: Propose an enhancement or submit a feature request
+---
+
+<!-- Tell us about the enhancement or describe your feature wish. Think about if it really belongs in the docsy theme; you may want to discuss it on https://github.com/google/docsy/discussions first. -->

.github/workflows/smoke.yaml

@@ -0,0 +1,50 @@
+# Smoke test across OSs: build a Docsy-based site from scratch,
+# using Docsy as hugo module and fetching Docsy via NPM.
+
+name: smoke
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  # schedule: # midnight every day
+  #   - cron: '0 0 * * *'
+  workflow_dispatch:
+
+jobs:
+  new-site:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest]
+        docsy-src: [NPM, HUGO_MODULE]
+    env:
+      BASE_REPO: ${{ github.repository }}
+      BRANCH: ${{ github.head_ref }}
+      PR_REPO: ${{ github.event.pull_request.head.repo.full_name }}
+      SHA: ${{ github.sha }}
+    # TODO: drop PR testing under Windows because it's too slow?
+    # if: github.event_name != 'pull_request' && matrix.os != 'windows-latest'
+    if: github.event_name != 'push' || github.repository == 'google/docsy'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+          cache-dependency-path: package.json
+      - run: tools/install-hugo.sh
+        shell: bash
+      - name: Make site (non-PR)
+        if: github.event_name != 'pull_request'
+        run: |
+          mkdir tmp && cd tmp && set -x
+          ../tools/make-site.sh -s ${{ matrix.docsy-src }} -r $BASE_REPO -v $SHA
+        shell: bash
+      - name: Make site from PR
+        if: github.event_name == 'pull_request'
+        run: |
+          mkdir tmp && cd tmp && set -x
+          ../tools/make-site.sh -s ${{ matrix.docsy-src }} -r $PR_REPO -v $BRANCH
+        shell: bash

.github/workflows/test.yaml

@@ -0,0 +1,31 @@
+# Build Docsy & the User Guide and run all repo checks across OSs.
+
+name: test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  # schedule:
+  #   - cron: '11 0 * * *' # 11 past midnight every day
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+          cache-dependency-path: package.json
+      - run: npm install --omit=optional
+      - if: runner.os != 'Windows'
+        run: npm run test:all
+      - if: runner.os == 'Windows'
+        run: npm run ci:prepare && npm run cd:docs build && npm run ci:post

.gitignore

@@ -1,5 +1,6 @@
 node_modules/
 package-lock.json
+/tmp
 
 # Hugo
 .hugo_build.lock

.markdown-link-check.json

@@ -1,13 +0,0 @@
-{
-  "ignorePatterns": [
-    {
-      "pattern": "^http://localhost"
-    },
-    {
-      "pattern": "^https://badges.netlify.com/api/docsydocs.svg?branch=main"
-    }
-  ],
-  "timeout": "3s",
-  "retryOn429": true,
-  "aliveStatusCodes": [200, 206]
-}

.prettierignore

@@ -1,5 +0,0 @@
-.editorconfig
-.gitignore
-.nvmrc
-.prettierignore
-.s3deploy.yml

.s3deploy.yml

@@ -1,14 +0,0 @@
-routes:
-    - route: "^.+\\.(js|css|svg|ttf)$"
-      #  cache static assets for 20 years
-      headers:
-         Cache-Control: "max-age=630720000, no-transform, public"
-      gzip: true
-    - route: "^.+\\.(png|jpg)$"
-      headers:
-         Cache-Control: "max-age=630720000, no-transform, public"
-      gzip: true
-    - route: "^.+\\.(html|xml|json)$"
-      gzip: true
-      
-        

.vscode/cspell.json

@@ -2,5 +2,16 @@
 {
   "version": "0.2",
   "caseSensitive": true,
-  "words": ["Docsy", "shortcode", "shortcodes"]
+  "words": [
+    "Docsy",
+    "errorf",
+    "hugo",
+    "relref",
+    "scrollspy",
+    "shortcode",
+    "shortcodes",
+    "tabpane",
+    "upvote",
+    "warnf"
+  ]
 }

CHANGELOG.md

@@ -1,5 +1,5 @@
 <!--
-  cSpell:ignore deining docsy gtag lookandfeel navs
+  cSpell:ignore deining docsy gitmodules gtag lookandfeel mhchem navs tabpane
 -->
 
 # Changelog
@@ -11,23 +11,233 @@ notes][releases].
 Useful links:
 
 - [Releases] & [tags]. Jump to the [latest] release.
-- [23Q4] milestone
+- [Milestones]
 
-[23q4]: https://github.com/google/docsy/milestone/9
 [latest]: https://github.com/google/docsy/releases/latest
+[milestones]: https://github.com/google/docsy/milestones
 [releases]: https://github.com/google/docsy/releases
 [tags]: https://github.com/google/docsy/tags
 
-## 0.8.0
+## 0.12.1 or 0.13.0
 
-For the full list of changes, see the [release][0.8.0] notes.
+> **UNRELEASED: this planned version is still under development**
+
+For the full list of changes, see the [0.x.y] release notes.
 
 **Breaking changes**:
 
-- Docsy is packaged as a **single Hugo module** ([#1120]).
-  - For details, see [Use Docsy as a Hugo Module].
-- **Important**: non-Hugo-module projects should read the [Docsy NPM install
-  side-effect] note.
+- **Shortcodes**:
+  - The alert shortcode has been reworked to address [#906] and [#939]. It can
+    now be used with Markdown content, and it can contain calls to other
+    shortcodes. For details, see [Shortcode helpers > alert][] ([#941])
+- ...
+
+[#941]: https://github.com/google/docsy/pull/941
+[Shortcode helpers > alert]:
+  https://www.docsy.dev/docs/adding-content/shortcodes/#alert
+
+**New**:
+
+**Other changes**:
+
+[0.x.y]: https://github.com/google/docsy/releases/latest?FIXME=v0.X.Y
+
+## 0.12.0
+
+For the full list of changes, see the [0.12.0] release notes.
+
+**Breaking changes**:
+
+- Renames the default Docsy heading render hook and heading self-link partials.
+  This is a breaking change only if your project uses this feature. For details,
+  see [Heading self links][] ([#2223]).
+- Relocates and adapts layouts in response to Hugo's [new template system][].
+  For details, see [Adapt to new template system in Hugo v0.146.0 #2243][#2243].
+- **IMPORTANT**: if your project overrides any of the layout files mentioned in
+  [#2243], then apply the same name changes in your project files. In
+  particular, note that:
+  - Taxonomy-related layout files: names have been _swapped_, and `terms.html`
+    is now singular ([#2257]):
+    - Renames `_default/taxonomy.html` to `term.html` (singular)
+    - Renames `_default/terms.html` to `taxonomy.html`
+  - Renames `layouts/**/content.html` by adding a `_td-` filename prefix
+    ([#2259]).
+
+[#2257]: https://github.com/google/docsy/pull/2257
+[#2259]: https://github.com/google/docsy/pull/2259
+[new template system]: https://gohugo.io/templates/new-templatesystem-overview/
+
+**Potential breaking changes**:
+
+- Removes shortcode `figure`, hugo's built-in shortcode `figure` can/will be
+  used instead.
+
+**New**:
+
+- **[Breadcrumb navigation]** support has been enhanced and adjusted:
+  - You can now disable breadcrumbs for an entire project, or individual pages
+    or sections by setting `ui.breadcrumb_disable` to true. For details, see
+    [Breadcrumb navigation][].
+  - **Blog** pages now also have breadcrumbs by default ([#1788]).
+  - Index-page single-element breadcrumb lists are hidden by default ([#2160]).
+- Support for a [_td-content-after-header.html] page-content render hook, which
+  can be [content type][] specific ([#2192]). For details, see the [User
+  Guide][before-page-content].
+
+**Other changes**:
+
+- **Blog** section index page content and title used to be ignored, they are now
+  displayed ([#1787]). To recover the old behavior use the following style
+  override: `.td-section.td-blog .td-content { display: none; }`.
+- Adds a `comment` shortcode, as a drop-in replacement for the one removed from
+  Hugo.
+
+[0.12.0]: https://github.com/google/docsy/releases/v0.12.0
+[#1787]: https://github.com/google/docsy/issues/1787
+[#1788]: https://github.com/google/docsy/issues/1788
+[#2160]: https://github.com/google/docsy/pull/2160
+[#2192]: https://github.com/google/docsy/pull/2192
+[#2223]: https://github.com/google/docsy/pull/2223
+[#2243]: https://github.com/google/docsy/pull/2243
+[before-page-content]:
+  https://www.docsy.dev/docs/adding-content/lookandfeel/#before-page-content
+[Breadcrumb navigation]:
+  https://www.docsy.dev/docs/adding-content/navigation/#breadcrumb-navigation
+[content type]: https://gohugo.io/quick-reference/glossary/#content-type
+[Heading self links]:
+  https://www.docsy.dev/docs/adding-content/navigation/#heading-self-links
+[_td-content-after-header.html]:
+  https://github.com/google/docsy/blob/main/layouts/_td-content-after-header.html
+
+## 0.11.0
+
+For the full list of changes, see the [0.11.0] release notes.
+
+**New**:
+
+- Support for Right-To-Left (RLT) languages is reintroduced via [Bootstrap's
+  support for RTL][bs-rtl]. For details, see [Right-to-left languages][rtl].
+- The URL to your project's contribution guidelines is configurable. For
+  details, see [Adding a community page].
+- When a section's sidebar entries are truncated because there are more than
+  [params.ui.sidebar_menu_truncate] section entries, a warning is issued.
+
+[0.11.0]: https://github.com/google/docsy/releases/v0.11.0
+[bs-rtl]: https://getbootstrap.com/docs/5.3/getting-started/rtl/
+[Adding a community page]:
+  https://www.docsy.dev/docs/adding-content/content/#adding-a-community-page
+[params.ui.sidebar_menu_truncate]:
+  https://www.docsy.dev/docs/adding-content/navigation/#section-menu-options
+[rtl]: https://www.docsy.dev/docs/language/#right-to-left-languages
+
+## 0.10.0
+
+For an introduction to this release, see the [0.10.0 release report]. For the
+full list of changes, see the [0.10.0] release notes.
+
+**New**: color themes and dark-mode support! For details, see [Color themes and
+dark-mode support][dark-mode].
+
+**Breaking changes**:
+
+- Removes shortcode `card-code` that was [deprecated in 0.7.0](#070); use
+  shortcode `card` with named parameter `code=true` instead.
+- The following SCSS variables are inlined in favor of dark-mode compatible
+  styling: `$border-color`, `$td-sidebar-tree-root-color`,
+  `$td-sidebar-bg-color`, `$td-sidebar-border-color` ([#1952])
+
+**Style changes** (potentially breaking):
+
+- The style of various shortcode and elements have been adjusted so that they
+  are compatible with light/dark mode. For details see, **Important style
+  changes** in [Color themes and dark-mode support][dark-mode].
+
+[#1952]: https://github.com/google/docsy/pull/1952
+[0.10.0]: https://github.com/google/docsy/releases/v0.10.0
+[0.10.0 release report]: https://www.docsy.dev/blog/2024/0.10.0/
+[dark-mode]:
+  https://www.docsy.dev/blog/2024/0.10.0/#color-themes-and-dark-mode-support
+
+## 0.9.1
+
+Patch release. For details, see [0.9.1].
+
+[0.9.1]: https://github.com/google/docsy/releases/v0.9.1
+
+## 0.9.0
+
+For an introduction and commentary, see the [0.9.0 release report]. For the full
+list of commits, see the [0.9.0] release notes. The most significant changes of
+this release are listed next.
+
+**Breaking changes**:
+
+- **[Repository Links]** now work for [multi-language] sites ([#1744]).
+
+  For any given page, repository links are now computed from a page's _resolved_
+  `File` path &mdash; as resolved _through_ mount points, if any. That is, the
+  path used is the one that refers to the file's actual location on disk, not
+  it's logical path in Hugo's [union file system].
+
+  This is a breaking change for pages of sites that use mounts and
+  [path_base_for_github_subdir]. Projects will need to adjust the value of
+  [path_base_for_github_subdir] to be relative to the file's physical location.
+
+- Class names to disable [repository links] were misnamed with a suffix of the
+  form `--KIND`. The new suffix is `__KIND`. For details, see [Disabling links].
+
+- **Heading self-link** support has been reimplemented and projects must now
+  explicitly enable the feature. For details, see [Heading self
+  links][0.9.0:hsl].
+
+**Footer changes**: refactoring, for easier customization, and simplification.
+For details concerning all footer changes, see [#1818].
+
+- **Footer layout** has been factored into parts: _left_, _right_, and _center_,
+  with _copyright_ a subpart of center. For details see [Footer layout]
+- **Footer copyright**, supports date-range, and site copyright fallback. For
+  details, see [Footer copyright].
+- **Footer streamlined**: the About-page footer link and All-rights-reserved
+  text are now hidden by default. For details, see [Footer streamlined].
+
+**Other changes**:
+
+- The latest release of **[Mermaid] resources** are now fetched at build time
+  ([#1410]).
+- [Look and feel] updates.
+
+[0.9.0]: https://github.com/google/docsy/releases/v0.9.0
+[0.9.0 release report]: https://www.docsy.dev/blog/2024/0.9.0/
+[#1410]: https://github.com/google/docsy/pull/1410
+[#1744]: https://github.com/google/docsy/pull/1744
+[#1818]: https://github.com/google/docsy/pull/1818
+[disabling links]:
+  https://www.docsy.dev/docs/adding-content/repository-links/#disabling-links
+[Footer layout]: https://www.docsy.dev/blog/2024/0.9.0/#footer-layout
+[Footer copyright]: https://www.docsy.dev/blog/2024/0.9.0/#footer-copyright
+[Footer streamlined]: https://www.docsy.dev/blog/2024/0.9.0/#footer-streamlined
+[0.9.0:hsl]: https://www.docsy.dev/blog/2024/0.9.0/#heading-self-links
+[look and feel]: https://www.docsy.dev/blog/2024/0.9.0/#look-and-feel
+[mermaid]:
+  https://www.docsy.dev/docs/adding-content/diagrams-and-formulae/#diagrams-with-mermaid
+[multi-language]: https://www.docsy.dev/docs/language/
+[path_base_for_github_subdir]:
+  https://www.docsy.dev/docs/adding-content/repository-links/#path_base_for_github_subdir-optional
+[Repository Links]: https://www.docsy.dev/docs/adding-content/repository-links/
+[union file system]:
+  https://gohugo.io/getting-started/directory-structure/#union-file-system
+
+## 0.8.0
+
+For the full list of changes, see the [0.8.0] release notes.
+
+**Breaking changes**:
+
+- Docsy is packaged as a **single Hugo module** ([#1120]). For details, see [Use
+  Docsy as a Hugo Module].
+- **Important**: non-Hugo-module projects should be aware of the [Docsy NPM
+  install side-effect]. Also, for guidance on Hugo-reported "failed to load
+  modules" error, see [Docsy as an NPM package].
 - **Page feedback**, or [User feedback]:
   - In support of projects configuring analytics outside of Docsy, feedback
     functionality is enabled regardless of whether
@@ -45,7 +255,9 @@ For the full list of changes, see the [release][0.8.0] notes.
 [#1385]: https://github.com/google/docsy/issues/1385
 [#1726]: https://github.com/google/docsy/pull/1726
 [#1727]: https://github.com/google/docsy/pull/1727
-[0.8.0]: https://github.com/google/docsy/releases/latest?fixme=v0.8.0
+[0.8.0]: https://github.com/google/docsy/releases/v0.8.0
+[Docsy as an NPM package]:
+  https://docsy.dev/docs/get-started/other-options/#option-3-docsy-as-an-npm-package
 [Docsy NPM install side-effect]:
   https://docsy.dev/docs/get-started/other-options/#docsy-npm-install-side-effect
 [Use Docsy as a Hugo Module]:
@@ -55,7 +267,7 @@ For the full list of changes, see the [release][0.8.0] notes.
 
 ## 0.7.2
 
-For the full list of changes, see the [release][0.7.2] notes. We mention some
+For the full list of changes, see the [0.7.2] release notes. We mention some
 noteworthy changes here:
 
 - **Algolia**
@@ -84,7 +296,7 @@ noteworthy changes here:
 
 ## 0.7.1
 
-For the full list of changes, see the [release][0.7.1] notes.
+For the full list of changes, see the [0.7.1] release notes.
 
 Followup changes to **Bootstrap (BS) 5.2 upgrade** ([#470]):
 
@@ -99,7 +311,7 @@ Followup changes to **Bootstrap (BS) 5.2 upgrade** ([#470]):
 
 ## 0.7.0
 
-For the full list of changes, see the [release][0.7.0] notes.
+For the full list of changes, see the [0.7.0] release notes.
 
 **New**:
 
@@ -121,9 +333,10 @@ For the full list of changes, see the [release][0.7.0] notes.
 - **Shortcodes**:
   - Now using Hugo's native support for processing HTML & markdown, not file
     extension testing. ([#906])
-  - Dropped support for pre-Hugo-0.54.x behavior of `{{% %}}`. ([#939])
+  - Dropped support for pre-Hugo-0.54.x behavior of [shortcodes with markdown],
+    `{{%/*...*/%}}`. ([#939])
   - `blocks/section`: **default** and accepted values of the `type` argument
-    have changed! For details see [blocks/section] ([#1472]).
+    have changed! For details, see [blocks/section] ([#1472]).
   - **Card shortcodes** ([#1376])]:
     - Renamed CSS class `td-card-deck` to `td-card-group`.
     - `card`, `card-code`: markup of inner content (HTML/markdown) now depends
@@ -134,6 +347,8 @@ For the full list of changes, see the [release][0.7.0] notes.
 
 [chroma-docsy]:
   https://www.docsy.dev/docs/adding-content/lookandfeel/#code-highlighting-with-chroma
+[shortcodes with markdown]:
+  https://gohugo.io/content-management/shortcodes/#shortcodes-with-markdown
 
 - **Detection of draw.io diagrams** is now **disabled** by default [#1185]
 
@@ -162,7 +377,7 @@ For the full list of changes, see the [release][0.7.0] notes.
 
 ## 0.6.0
 
-For the full list of changes, see the [release][0.6.0] notes.
+For the full list of changes, see the [0.6.0] release notes.
 
 With this release we declare a feature freeze while we migrate to the newest
 Bootstrap version. See [the announcement][bs-announcement] for more information.
@@ -183,7 +398,7 @@ Bootstrap version. See [the announcement][bs-announcement] for more information.
 
 ## 0.5.1
 
-For the full list of changes, see the [release][0.5.1] notes. **BREAKING
+For the full list of changes, see the [0.5.1] release notes. **BREAKING
 CHANGES** are documented below.
 
 **After you update** your project's Docsy:
@@ -240,7 +455,7 @@ Unpublished.
 
 ## 0.4.0
 
-For the full list of changes, see the [release][0.4.0] notes. Potential
+For the full list of changes, see the [0.4.0] release notes. Potential
 **BREAKING CHANGES** are documented below.
 
 **After you update** your project's Docsy, run `npm install`.
@@ -292,11 +507,11 @@ Proceed as usual to build or serve your site.
 [hugo module]: https://www.docsy.dev/docs/get-started/docsy-as-module/
 [other docsy setups]: https://www.docsy.dev/docs/get-started/other-options/
 [prepare]:
-  https://docs.npmjs.com/cli/v8/using-npm/scripts#prepare-and-prepublish
+  https://docs.npmjs.com/cli/v10/using-npm/scripts#prepare-and-prepublish
 
 ## 0.3.0
 
-For the full list of changes, see the [release][0.3.0] notes.
+For the full list of changes, see the [0.3.0] release notes.
 
 **Breaking changes**:
 
@@ -315,7 +530,7 @@ For the full list of changes, see the [release][0.3.0] notes.
 
 ## 0.2.0
 
-For the full list of changes, see the [release][0.2.0] notes.
+For the full list of changes, see the [0.2.0] release notes.
 
 **New**:
 
@@ -332,11 +547,14 @@ For the full list of changes, see the [release][0.2.0] notes.
 [0.2.0]: https://github.com/google/docsy/releases/v0.2.0
 [hugo modules]: https://gohugo.io/hugo-modules/
 
-<!-- SECTION TEMPLATE ------------------------------------------------------
+<!-- ENTRY TEMPLATE ------------------------------------------------------
 
-## 0.X.Y - next planned release (unpublished yet)
+```
+## 0.X.Y
 
-For the full list of changes, see the [release][0.x.y] notes.
+> **UNRELEASED: this planned version is still under development**
+
+For the full list of changes, see the [0.x.y] release notes.
 
 **Breaking changes**:
 
@@ -346,6 +564,7 @@ For the full list of changes, see the [release][0.x.y] notes.
 
 **Other changes**:
 
-[0.x.y]: https://github.com/google/docsy/releases/v0.X.Y-FIXME
+[0.x.y]: https://github.com/google/docsy/releases/latest?FIXME=v0.X.Y
+```
 
 ---------------------------------------------------------------------------->

CONTRIBUTING.md

@@ -46,31 +46,39 @@ These notes are WIP for creating a **release (v0.X.Y)** from a local copy of the
 repo.
 
 1.  **Change directory** to your local Docsy repo.
-2.  **Create or update a [CHANGELOG](CHANGELOG.md) entry** for v0.X.Y. The
-    section should provide a brief summary of breaking changes using the section
-    template at the end of the file. (Note that change details are autogenerated
-    by GitHub in a later step.)
+2.  **Create or update a [CHANGELOG] entry** for v0.X.Y. The section should
+    provide a brief summary of breaking changes using the section template at
+    the end of the file. (Note that change details are autogenerated by GitHub
+    in a later step.)
 3.  **Update Docsy version** to v0.X.Y for:
-    - `version` key in [package.json](package.json)
-    - `version` key in [userguide/hugo.yaml][]
-4.  Run `npm install` to have vendor assets and [go.mod](go.mod) updated for
-    dependencies.
+    - `version` key in [package.json]
+    - `version` key in [userguide/hugo.yaml]
+4.  Run `npm run ci:prepare` to ensure that vendor assets and [go.mod]
+    dependencies are up-to-date.
 5.  **Submit a PR with your changes**, using a title like "Release v0.X.Y
     preparation".
-6.  **Get PR approved and merged**.
-7.  **Pull in `main`** to get the last PR.
-8.  **Ensure** that you're:
+6.  **Test the PR** branch from selected sites, and push any required
+    adjustments.
+    - If the test site uses Docsy as a Git submodule:
+      ```console
+      $ cd themes/docs
+      $ git fetch
+      $ git switch -t repo/branch-name # e.g. chalin/chalin-im-0.9.1-2024-02-16
+      ```
+7.  **Get PR approved and merged**.
+8.  **Pull in `main`** to get the last PR.
+9.  **Ensure** that you're:
     - On the default branch, `main`
     - At the commit that you want to tag as v0.X.Y
-9.  **Create tags** for v0.X.Y:
+10. **Create tags** for v0.X.Y:
 
     ```sh
     REL=v0.X.Y
     git tag $REL
     ```
 
-10. **Push the new tags** to the main repo, which is named `upstream` in the
-    following example:
+11. **Push the new tags** to the main remote (`origin` or `upstream` depending
+    on your setup) as well as any secondary remotes, if any:
 
     ```console
     $ git push upstream $REL
@@ -78,7 +86,7 @@ repo.
     * [new tag]         v0.X.Y -> v0.X.Y
     ```
 
-11. **[Draft a new release][]** using GitHub web; fill in the fields as follows:
+12. **[Draft a new release][]** using GitHub web; fill in the fields as follows:
 
     - From the **release/tag dropdown**: Select the new release tag that you
       just pushed, v0.X.Y.
@@ -91,16 +99,15 @@ repo.
       ```markdown
       ## Release summary
 
-      See, https://github.com/google/docsy/blob/main/CHANGELOG.md#0XY
+      - [Release report](https://www.docsy.dev/blog/2024/0.X.Y/)
+      - [CHANGELOG](https://github.com/google/docsy/blob/main/CHANGELOG.md#0XY)
       ```
 
-    - Remove the "New contributors" autogenerated text (if present) since we
-      don't publish that as part of our release notes.
     - Select **Create a discussion for this release**.
 
-12. **Publish the release**: click _Publish release_.
-13. Test the release with a downstream project, such as [docsy-example].
-14. If you find issues, determine whether they need to be fixed immediately. If
+13. **Publish the release**: click _Publish release_.
+14. Test the release with a downstream project, such as [docsy-example].
+15. If you find issues, determine whether they need to be fixed immediately. If
     so, get fixes submitted, reviewed and approved. Then publish a dot release:
     go back to step 1.
 
@@ -110,13 +117,22 @@ Assuming that Docsy release v0.X.Y has been successfully deployed and use by at
 least one downstream project, then perform the following actions before any
 further changes are merged into the default branch:
 
-1. Set `version` in [package.json](package.json) to the next planned (or the
-   next dot) release with a dev suffix, such as `v0.X.Z-dev.0-unreleased`.
-2. **Submit a PR with your changes**, using a title like "Set NPM package
-   version to next unreleased dev".
-3. **Get PR approved and merged**.
+1. Set `version` in [package.json] to the next planned (or the next dot) release
+   with a dev suffix, such as `v0.X.Z-dev-unreleased`.
+2. In the [CHANGELOG]:
+   - **Create a new entry** for the next release by copying the ENTRY TEMPLATE
+     at the end of the file.
+   - **Pin the 0.X.Y release URL**, which ends with `latest?FIXME=...`, to the
+     v0.X.Y release at `https://github.com/google/docsy/releases/v0.x.y`.
+3. **Submit a PR with your changes**, using a title like "Set NPM package
+   version to next unreleased dev version".
+4. **Get PR approved and merged**.
 
+[CHANGELOG]: https://github.com/google/docsy/blob/main/CHANGELOG.md
 [contribution guidelines]: https://www.docsy.dev/docs/contribution-guidelines/
-[Draft a new release]: https://github.com/google/docsy/releases/new
 [docsy-example]: https://github.com/google/docsy-example
-[userguide/hugo.yaml]: userguide/hugo.yaml
+[Draft a new release]: https://github.com/google/docsy/releases/new
+[go.mod]: https://github.com/google/docsy/blob/main/go.mod
+[package.json]: https://github.com/google/docsy/blob/main/package.json
+[userguide/hugo.yaml]:
+  https://github.com/google/docsy/blob/main/userguide/hugo.yaml

README.md

@@ -1,12 +1,7 @@
 # Docsy
 
-[![Project status: active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
-[![Project releases](https://img.shields.io/github/release/google/docsy)](https://github.com/google/docsy/releases)
-[![Project build Status](https://badges.netlify.com/api/docsydocs.svg?branch=main)](https://app.netlify.com/sites/docsydocs/deploys)
-[![Project contributors](https://img.shields.io/github/contributors/google/docsy)](https://github.com/google/docsy/graphs/contributors)
-[![Project license](https://img.shields.io/github/license/google/docsy)](https://github.com/google/docsy/blob/main/LICENSE)
-
-## 🚧 WARNING 🚧 : `main` is under development and potentially unstable! Use official Docsy [releases].
+> **🚧 WARNING 🚧 : `main` is under development and potentially unstable! Use
+> official Docsy [releases].**
 
 Docsy is a [Hugo](https://gohugo.io) theme for technical documentation sets,
 providing simple navigation, site structure, and more.
@@ -42,7 +37,7 @@ The following are basic prerequisites for using Docsy in your site:
 Any additional prerequisites depend on the
 [installation option](https://www.docsy.dev/docs/get-started/#installation-options)
 you choose. We recommend using Docsy as a Hugo module, which requires that you
-have the `go` language installed in addition to Hugo and PostCSS.
+have the Go language installed in addition to Hugo and PostCSS.
 
 For complete prerequisites and instructions, see our
 [Get started guides](https://www.docsy.dev/docs/get-started/).
@@ -89,14 +84,14 @@ npm run serve
 
 ## Contributing
 
-Read [CONTRIBUTING.md] for details on our [code of conduct], and the process for
-submitting pull requests to us. Thank you to all past, present, and future
+For details on our [code of conduct] and the process for submitting pull
+requests, see [CONTRIBUTING.md]. Thank you to all past, present, and future
 [contributors]!
 
 ## License
 
-This project is licensed under the Apache License 2.0 - see the
-[LICENSE.md](https://github.com/google/docsy/blob/main/LICENSE) file for details
+This project is licensed under the Apache License 2.0 - see
+[LICENSE](https://github.com/google/docsy/blob/main/LICENSE) for details
 
 [code of conduct]:
   https://github.com/google/.github/blob/master/CODE_OF_CONDUCT.md

assets/_vendor/bootstrap/scss/_rfs.scss

@@ -1,4 +1,4 @@
-// stylelint-disable property-blacklist, scss/dollar-variable-default
+// stylelint-disable scss/dimension-no-non-numeric-values
 
 // SCSS RFS mixin
 //
@@ -154,8 +154,7 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
     &.enable-rfs {
       @content;
     }
-  }
-  @else {
+  } @else {
     @content;
   }
 }
@@ -168,7 +167,7 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
       @content;
     }
 
-    @include _rfs-media-query {
+    @include _rfs-media-query () {
       .enable-rfs &,
       &.enable-rfs {
         @content;
@@ -182,7 +181,7 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
         @content;
       }
     }
-    @include _rfs-media-query {
+    @include _rfs-media-query () {
       @content;
     }
   }
@@ -193,12 +192,12 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
   // Convert to list
   $values: if(type-of($values) != list, ($values,), $values);
 
-  $val: '';
+  $val: "";
 
   // Loop over each value and calculate value
   @each $value in $values {
     @if $value == 0 {
-      $val: $val + ' 0';
+      $val: $val + " 0";
     }
     @else {
       // Cache $value unit
@@ -206,15 +205,14 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
 
       @if $unit == px {
         // Convert to rem if needed
-        $val: $val + ' ' + if($rfs-unit == rem, #{divide($value, $value * 0 + $rfs-rem-value)}rem, $value);
+        $val: $val + " " + if($rfs-unit == rem, #{divide($value, $value * 0 + $rfs-rem-value)}rem, $value);
       }
       @else if $unit == rem {
         // Convert to px if needed
-        $val: $val + ' ' + if($rfs-unit == px, #{divide($value, $value * 0 + 1) * $rfs-rem-value}px, $value);
-      }
-      @else {
+        $val: $val + " " + if($rfs-unit == px, #{divide($value, $value * 0 + 1) * $rfs-rem-value}px, $value);
+      } @else {
         // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value
-        $val: $val + ' ' + $value;
+        $val: $val + " " + $value;
       }
     }
   }
@@ -228,30 +226,26 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
   // Convert to list
   $values: if(type-of($values) != list, ($values,), $values);
 
-  $val: '';
+  $val: "";
 
   // Loop over each value and calculate value
   @each $value in $values {
     @if $value == 0 {
-      $val: $val + ' 0';
-    }
-
-    @else {
+      $val: $val + " 0";
+    } @else {
       // Cache $value unit
       $unit: if(type-of($value) == "number", unit($value), false);
 
       // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value
       @if not $unit or $unit != px and $unit != rem {
-        $val: $val + ' ' + $value;
-      }
-
-      @else {
+        $val: $val + " " + $value;
+      } @else {
         // Remove unit from $value for calculations
         $value: divide($value, $value * 0 + if($unit == px, 1, divide(1, $rfs-rem-value)));
 
         // Only add the media query if the value is greater than the minimum value
         @if abs($value) <= $rfs-base-value or not $enable-rfs {
-          $val: $val + ' ' +  if($rfs-unit == rem, #{divide($value, $rfs-rem-value)}rem, #{$value}px);
+          $val: $val + " " + if($rfs-unit == rem, #{divide($value, $rfs-rem-value)}rem, #{$value}px);
         }
         @else {
           // Calculate the minimum value
@@ -273,7 +267,7 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
           $variable-width: #{divide($value-diff * 100, $rfs-breakpoint)}#{$variable-unit};
 
           // Return the calculated value
-          $val: $val + ' calc(' + $min-width + if($value < 0, ' - ', ' + ') + $variable-width + ')';
+          $val: $val + " calc(" + $min-width + if($value < 0, " - ", " + ") + $variable-width + ")";
         }
       }
     }
@@ -287,22 +281,22 @@ $rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height
 @mixin rfs($values, $property: font-size) {
   @if $values != null {
     $val: rfs-value($values);
-    $fluidVal: rfs-fluid-value($values);
+    $fluid-val: rfs-fluid-value($values);
 
     // Do not print the media query if responsive & non-responsive values are the same
-    @if $val == $fluidVal {
+    @if $val == $fluid-val {
       #{$property}: $val;
     }
     @else {
-      @include _rfs-rule {
-        #{$property}: if($rfs-mode == max-media-query, $val, $fluidVal);
+      @include _rfs-rule () {
+        #{$property}: if($rfs-mode == max-media-query, $val, $fluid-val);
 
         // Include safari iframe resize fix if needed
         min-width: if($rfs-safari-iframe-resize-bug-fix, (0 * 1vw), null);
       }
 
-      @include _rfs-media-query-rule {
-        #{$property}: if($rfs-mode == max-media-query, $fluidVal, $val);
+      @include _rfs-media-query-rule () {
+        #{$property}: if($rfs-mode == max-media-query, $fluid-val, $val);
       }
     }
   }

assets/js/anchor.js

@@ -1,49 +0,0 @@
-/*
- * Copyright 2018 Google LLC
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    https://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-(function ($) {
-    'use strict';
-
-    // Headers' anchor link that shows on hover
-    $(function () {
-        // append anchor links to headings in markdown.
-        var article = document.getElementsByTagName('main')[0];
-        if (!article) {
-            return;
-        }
-        var headings = article.querySelectorAll('h1, h2, h3, h4, h5, h6');
-        headings.forEach(function (heading) {
-            if (heading.id) {
-                var a = document.createElement('a');
-                // set visibility: hidden, not display: none to avoid layout change
-                a.style.visibility = 'hidden';
-                // [a11y] hide this from screen readers, etc..
-                a.setAttribute('aria-hidden', 'true');
-                // material insert_link icon in svg format
-                a.innerHTML = ' <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"><path d="M0 0h24v24H0z" fill="none"/><path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"/></svg>';
-                a.href = '#' + heading.id;
-                heading.insertAdjacentElement('beforeend', a);
-                heading.addEventListener('mouseenter', function () {
-                    a.style.visibility = 'initial';
-                });
-                heading.addEventListener('mouseleave', function () {
-                    a.style.visibility = 'hidden';
-                });
-            }
-        });
-    });
-
-}(jQuery));

assets/js/click-to-copy.js

@@ -19,7 +19,6 @@ for (let index = 0; index < codeListings.length; index++) {
     'fas',
     'fa-copy',
     'btn',
-    'btn-dark',
     'btn-sm',
     'td-click-to-copy'
   );

assets/js/dark-mode.js

@@ -0,0 +1,87 @@
+/*!
+ * This is a Docsy-adapted version of https://github.com/twbs/examples/blob/main/color-modes/js/color-modes.js.
+ *
+ * Original header:
+ *
+ * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/)
+ * Copyright 2011-2024 The Bootstrap Authors
+ * Licensed under the Creative Commons Attribution 3.0 Unported License.
+ */
+
+(() => {
+  'use strict'
+
+  const themeKey = 'td-color-theme'
+  const getStoredTheme = () => localStorage.getItem(themeKey)
+  const setStoredTheme = theme => localStorage.setItem(themeKey, theme)
+
+  const getPreferredTheme = () => {
+    const storedTheme = getStoredTheme()
+    if (storedTheme) {
+      return storedTheme
+    }
+
+    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
+  }
+
+  const setTheme = theme => {
+    if (theme === 'auto') {
+      document.documentElement.setAttribute('data-bs-theme', (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'))
+    } else {
+      document.documentElement.setAttribute('data-bs-theme', theme)
+    }
+  }
+
+  setTheme(getPreferredTheme())
+
+  const showActiveTheme = (theme, focus = false) => {
+    const themeSwitcher = document.querySelector('#bd-theme')
+
+    if (!themeSwitcher) {
+      return
+    }
+
+    const themeSwitcherText = document.querySelector('#bd-theme-text')
+    const activeThemeIcon = document.querySelector('.theme-icon-active use')
+    const btnToActive = document.querySelector(`[data-bs-theme-value="${theme}"]`)
+    const svgOfActiveBtn = btnToActive.querySelector('svg use').getAttribute('href')
+
+    document.querySelectorAll('[data-bs-theme-value]').forEach(element => {
+      element.classList.remove('active')
+      element.setAttribute('aria-pressed', 'false')
+    })
+
+    btnToActive.classList.add('active')
+    btnToActive.setAttribute('aria-pressed', 'true')
+    activeThemeIcon.setAttribute('href', svgOfActiveBtn)
+    if (themeSwitcherText) {
+      const themeSwitcherLabel = `${themeSwitcherText.textContent} (${btnToActive.dataset.bsThemeValue})`
+      themeSwitcher.setAttribute('aria-label', themeSwitcherLabel)
+    }
+
+    if (focus) {
+      themeSwitcher.focus()
+    }
+  }
+
+  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
+    const storedTheme = getStoredTheme()
+    if (storedTheme !== 'light' && storedTheme !== 'dark') {
+      setTheme(getPreferredTheme())
+    }
+  })
+
+  window.addEventListener('DOMContentLoaded', () => {
+    showActiveTheme(getPreferredTheme())
+
+    document.querySelectorAll('[data-bs-theme-value]')
+      .forEach(toggle => {
+        toggle.addEventListener('click', () => {
+          const theme = toggle.getAttribute('data-bs-theme-value')
+          setStoredTheme(theme)
+          setTheme(theme)
+          showActiveTheme(theme, true)
+        })
+      })
+  })
+})()

assets/js/mermaid.js

@@ -1,41 +0,0 @@
-(function($) {
-    var needMermaid = false;
-
-{{ if ge hugo.Version "0.93.0" -}}
-    if ($('.mermaid').length > 0) {
-        needMermaid = true;
-    };
-{{ else -}}
-    $('.language-mermaid').parent().replaceWith(function() {
-        needMermaid = true;
-        return $('<pre class="mermaid">').text($(this).text());
-    });
-{{ end -}}
-
-    if (!needMermaid)  {
-        mermaid.initialize({startOnLoad: false});
-        return;
-    }
-
-    var params = {{ .Site.Params.mermaid | jsonify | safeJS }};
-
-    // site params are stored with lowercase keys; lookup correct casing
-    // from Mermaid default config.
-    var norm = function(defaultConfig, params) {
-        var result = {};
-        for (const key in defaultConfig) {
-            const keyLower = key.toLowerCase();
-            if (defaultConfig.hasOwnProperty(key) && params.hasOwnProperty(keyLower)) {
-                if (typeof defaultConfig[key] === "object") {
-                    result[key] = norm(defaultConfig[key], params[keyLower]);
-                } else {
-                    result[key] = params[keyLower];
-                }
-            }
-        }
-        return result;
-    };
-    var settings = norm(mermaid.mermaidAPI.defaultConfig, params);
-    settings.startOnLoad = true;
-    mermaid.initialize(settings);
-})(jQuery);

assets/js/offline-search.js

@@ -145,7 +145,7 @@
           const $entry = $('<div>').addClass('mt-4');
 
           $entry.append(
-            $('<small>').addClass('d-block text-muted').text(r.ref)
+            $('<small>').addClass('d-block text-body-secondary').text(r.ref)
           );
 
           $entry.append(

assets/scss/_alerts.scss

@@ -2,16 +2,19 @@
 
 .alert {
   font-weight: $font-weight-medium;
-  background: $white;
   color: inherit;
   border-radius: 0;
 
+  :last-child {
+    margin-bottom: 0;
+  }
+
+  .alert-heading {
+    color: var(--bs-alert-link-color);
+  }
+
   @each $color, $value in $theme-colors {
     &-#{$color} {
-      & .alert-heading {
-        color: $value;
-      }
-
       border-style: solid;
       border-color: $value;
       border-width: 0 0 0 4px;

assets/scss/_boxes.scss

@@ -116,3 +116,21 @@
 @each $color, $value in $grays {
   @include box-variant(".td-box", $color, $value);
 }
+
+// Single dark-mode compatibility override for white boxes:
+@include color-mode(dark) {
+  .td-box--white {
+    color: var(--bs-body-color);
+    background-color: var(--bs-body-bg);
+    p > a, span > a {
+      color: var(--bs-link-color);
+      &:focus,
+      &:hover {
+        color: rgba(var(--bs-link-color-rgb), var(--bs-link-opacity, 1));
+      }
+    }
+    .td-arrow-down::before {
+      border-color: var(--bs-body-bg) transparent transparent transparent;
+    }
+  }
+}

assets/scss/_breadcrumb.scss

@@ -2,7 +2,11 @@
 
 .td-breadcrumbs {
   @media print {
-    display: none !important;
+    display: none;
+  }
+
+  &__single {
+    display: none;
   }
 
   .breadcrumb {

assets/scss/_code.scss

@@ -1,10 +1,12 @@
 // Code formatting.
 
+@include color-mode(dark, true) {
+  --td-pre-bg: #{adjust-color($gray-900, $lightness: -2.5%)};
+}
+
 .td-content {
   // Highlighted code.
   .highlight {
-    @extend .card;
-
     margin: 2rem 0;
     padding: 0;
     position: relative;
@@ -17,26 +19,28 @@
     pre {
       margin: 0;
       padding: 1rem;
+      border-radius: inherit;
 
       // Default click-to-copy button
 
       button.td-click-to-copy {
         position: absolute;
-        color: $gray-400;
-        border-radius: 3px;
+        color: var(--bs-tertiary-color);
         border-width: 0;
-        background-color: inherit;
-        box-shadow: 1px 1px $gray-400;
+        background-color: transparent;
+        background-image: none;
+        --bs-btn-box-shadow: 0;
+        padding: var(--bs-btn-padding-y) calc(var(--bs-btn-padding-x) / 2);
         right: 4px;
         top: 2px;
 
         &:hover {
-          color: $dark;
-          background-color: $gray-400;
+          color: var(--bs-secondary-color);
+          background-color: var(--bs-dark-bg-subtle);
         }
         &:active {
-          color: $dark;
-          background-color: $gray-400;
+          color: var(--bs-secondary-color);
+          background-color: var(--bs-dark-bg-subtle);
           transform: translateY(2px);
         }
       }
@@ -52,7 +56,7 @@
     margin: 0;
     font-size: 85%;
     word-break: normal;
-    background-color: rgba($black, 0.05);
+    background-color: var(--td-pre-bg);
     border-radius: $border-radius;
 
     br {
@@ -63,7 +67,9 @@
   // Code blocks
   pre {
     word-wrap: normal;
-    background-color: $gray-100;
+    background-color: var(--td-pre-bg);
+    border: solid var(--bs-border-color);
+    border-width: 1px;
     padding: $spacer;
 
     > code {

assets/scss/_content.scss

@@ -8,7 +8,7 @@
   p,
   li,
   td {
-    font-weight: $font-weight-body-text;
+    font-weight: $td-font-weight-body-text;
   }
 
   > h1 {
@@ -47,8 +47,8 @@
   blockquote {
     padding: 0 0 0 1rem;
     margin-bottom: $spacer;
-    color: $gray-600;
-    border-left: 6px solid $secondary;
+    color: var(--bs-secondary-color);
+    border-left: 6px solid var(--bs-primary);
   }
 
   ul li,
@@ -94,3 +94,27 @@
     font-size: 3rem;
   }
 }
+
+.td-heading-self-link {
+  &::before {
+    content: '#';
+  }
+
+  font-size: 90%;
+  padding-left: 0.25em;
+  text-decoration: none;
+  visibility: hidden;
+
+  // Always visible on touch devices and small screens
+  @media (hover: none) and (pointer: coarse),
+  (max-width: map-get($grid-breakpoints, sm)) {
+    visibility: visible;
+  }
+
+}
+
+@for $i from 1 through 6 {
+  h#{$i}:hover > .td-heading-self-link {
+    visibility: visible;
+  }
+}

assets/scss/_drawio.scss

@@ -23,7 +23,7 @@ div.drawioframe {
   height: 100%;
   width: 100%;
   top: 0;
-  left: 0px;
+  left: 0;
   z-index: 1000;
   background: #000b;
   border: 0;

assets/scss/_nav.scss

@@ -1,6 +1,7 @@
 //
 // Main navbar
 //
+// cSpell:ignore onscroll
 
 .td-navbar-cover {
   @include media-breakpoint-up(md) {
@@ -57,7 +58,7 @@
   // For .td-search__input styling, see _search.scss
 
   .dropdown {
-    min-width: 100px;
+    min-width: 50px;
   }
 
   @include media-breakpoint-up(md) {
@@ -91,6 +92,22 @@
       overflow-x: auto;
     }
   }
+
+  .td-light-dark-menu {
+    .bi {
+      // Adapted from: https://github.com/twbs/bootstrap/blob/main/site/layouts/_default/examples.html
+      width: 1em;
+      height: 1em;
+      vertical-align: -.125em;
+      fill: currentcolor;
+    }
+
+    &.dropdown {
+      @include media-breakpoint-down(lg) {
+        position: unset;
+      }
+    }
+  }
 }
 
 // Icons
@@ -98,7 +115,7 @@
   li i {
     padding-right: 0.5em;
 
-    &:before {
+    &::before {
       display: inline-block;
       text-align: center;
       min-width: 1em;
@@ -111,13 +128,13 @@
     border: 0;
     font-weight: inherit;
 
-    &:before {
+    &::before {
       display: inline-block;
       font-style: normal;
       font-variant: normal;
       text-rendering: auto;
       -webkit-font-smoothing: antialiased;
-      font-family: $font-awesome-font-name;
+      font-family: $td-font-awesome-font-name;
       font-weight: 900;
       content: "\f0d9";
       padding-left: 0.5em;
@@ -166,13 +183,13 @@ nav.foldable-nav {
     padding-left: 1.5em;
   }
 
-  .ul-1 .with-child > label:before {
+  .ul-1 .with-child > label::before {
     display: inline-block;
     font-style: normal;
     font-variant: normal;
     text-rendering: auto;
     -webkit-font-smoothing: antialiased;
-    font-family: $font-awesome-font-name;
+    font-family: $td-font-awesome-font-name;
     font-weight: 900;
     content: "\f0da";
     position: absolute;
@@ -180,15 +197,15 @@ nav.foldable-nav {
     padding-left: 0.4em;
     padding-right: 0.4em;
     font-size: 1em;
-    color: $gray-900;
+    color: var(--bs-secondary-color);
     transition: all 0.5s;
     &:hover {
       transform: rotate(90deg);
     }
   }
 
-  .ul-1 .with-child > input:checked ~ label:before {
-    color: $primary;
+  .ul-1 .with-child > input:checked ~ label::before {
+    color: var(--bs-secondary-color);
     transform: rotate(90deg);
     transition: transform 0.5s;
   }
@@ -200,13 +217,13 @@ nav.foldable-nav {
 
 @media (hover: hover) and (pointer: fine) {
   nav.foldable-nav {
-    .ul-1 .with-child > label:hover:before {
-      color: $primary;
+    .ul-1 .with-child > label:hover::before {
+      color: var(--bs-link-color);
       transition: color 0.3s;
     }
 
-    .ul-1 .with-child > input:checked ~ label:hover:before {
-      color: $primary;
+    .ul-1 .with-child > input:checked ~ label:hover::before {
+      color: var(--bs-link-color);
       transition: color 0.3s;
     }
   }

assets/scss/_pageinfo.scss

@@ -1,16 +1,24 @@
 .pageinfo {
   font-weight: $font-weight-medium;
-  background: $gray-100;
+  background: var(--bs-alert-bg);
   color: inherit;
-  border-radius: 0;
-  margin: 2rem;
+  margin: 2rem auto;
   padding: 1.5rem;
   padding-bottom: 0.5rem;
 
   @each $color, $value in $theme-colors {
     &-#{$color} {
-      border-style: solid;
-      border-color: $value;
+      @extend .alert-#{$color};
+      border-width: 0;
     }
   }
 }
+
+.td-page-meta {
+  &__lastmod {
+    @extend .text-body-secondary;
+    @extend .border-top;
+    margin-top: map-get($spacers, 5) !important;
+    padding-top: map-get($spacers, 3) !important;
+  }
+}

assets/scss/_search.scss

@@ -19,7 +19,7 @@
     // Click-through to the underlying input.
     pointer-events: none;
 
-    &:before {
+    &::before {
       @extend .fa;
       content: fa-content($fa-var-search);
     }
@@ -27,7 +27,7 @@
     // Styling adjustments for the navbar
     @at-root {
       .td-navbar & {
-        color: $navbar-dark-color;
+        color: inherit;
       }
     }
   }
@@ -44,17 +44,17 @@
     &.form-control:focus {
       border-color: tint-color($primary, 95%);
       box-shadow: 0 0 0 2px tint-color($primary, 40%);
-      color: inherit;
+      color: var(--bs-body-color);
     }
 
     // Styling adjustments for the navbar
     @at-root {
       .td-navbar & {
         border: none;
-        color: $navbar-dark-color;
+        color: inherit;
 
         @include placeholder {
-          color: $navbar-dark-color;
+          color: inherit;
         }
       }
     }
@@ -67,7 +67,7 @@
     }
 
     .td-search-input {
-      text-indent: 0px;
+      text-indent: 0;
     }
   }
 
@@ -114,7 +114,7 @@
     // cursor: pointer;
     float: right;
 
-    &:after {
+    &::after {
       @extend .fas;
       content: fa-content($fa-var-times);
     }

assets/scss/_sidebar-toc.scss

@@ -2,7 +2,9 @@
 // Right side toc
 //
 .td-sidebar-toc {
-  border-left: 1px solid $border-color;
+  @include link-decoration;
+
+  border-left: 1px solid var(--bs-border-color);
 
   @supports (position: sticky) {
     position: sticky;
@@ -15,16 +17,19 @@
   padding-top: 0.75rem;
   padding-bottom: 1.5rem;
   vertical-align: top;
-}
 
-.td-page-meta {
-  a {
+  .td-page-meta a {
     display: block;
     font-weight: $font-weight-medium;
   }
 }
 
 .td-toc {
+  $toc-padding-base: 1rem;
+  $toc-padding-increment: 0.5rem; // for TOC entry nesting
+
+  margin-top: 1rem;
+
   a {
     display: block;
     font-weight: $font-weight-light;
@@ -36,22 +41,48 @@
     display: block;
   }
 
-  li li {
-    margin-left: 0.5rem;
+  > .toc-title {
+    font-weight: $font-weight-bold;
+    color: var(--bs-secondary-color);
+    border-bottom: 1px solid var(--bs-tertiary-color);
+    padding-bottom: 0.5rem;
+    margin-bottom: 0.5rem;
   }
 
   #TableOfContents {
-    // Hugo's ToC is a mouthful, this can be used to style the top level h2 entries.
-    > ul > li > ul > li > a {
-    }
+    margin-left: -0.75rem;
 
     a {
-      color: $gray-600;
+      margin-left: 0;
+      padding-left: $toc-padding-base;
+      text-decoration: none;
+      border-left: .125rem solid transparent;
+      transition: color 0.15s ease-in-out, border-color 0.15s ease-in-out;
+      color: var(--bs-secondary-color);
 
-      &:hover {
-        color: $blue;
-        text-decoration: none;
+      &.active {
+        color: var(--bs-primary);
+        border-left-color: var(--bs-primary);
+        background-color: var(--bs-secondary-bg-subtle);
       }
+
+      &:focus,
+      &:hover {
+        color: initial;
+      }
+    }
+
+    ul ul a {
+      padding-left: $toc-padding-base + $toc-padding-increment;
+    }
+    ul ul ul a {
+      padding-left: $toc-padding-base + ($toc-padding-increment * 2);
+    }
+    ul ul ul ul a {
+      padding-left: $toc-padding-base + ($toc-padding-increment * 3);
+    }
+    ul ul ul ul ul a {
+      padding-left: $toc-padding-base + ($toc-padding-increment * 4);
     }
   }
 

assets/scss/_sidebar-tree.scss

@@ -39,7 +39,8 @@
       list-style: none;
     }
 
-    &.ul-0, ul {
+    &.ul-0,
+    ul {
       padding: 0;
       margin: 0;
     }
@@ -62,7 +63,7 @@
     }
 
     a {
-      color: $gray-900;
+      color: var(--bs-secondary-color);
     }
   }
 
@@ -71,15 +72,15 @@
     padding-bottom: 0.375rem;
 
     &__page {
-      color: $gray-700;
+      color: var(--bs-body-color);
       font-weight: $font-weight-light;
     }
   }
 
   a {
+    &:focus,
     &:hover {
-      color: $blue;
-      text-decoration: none;
+      color: var(--bs-link-color);
     }
 
     &.active {
@@ -87,14 +88,9 @@
     }
   }
 
-  .dropdown {
-    a {
-      color: $gray-700;
-    }
-
-    .nav-link {
-      padding: 0 0 1rem;
-    }
+  .dropdown .nav-link {
+    padding-left: 1.5rem;
+    margin-bottom: 0.5rem;
   }
 
   & > .td-sidebar-nav__section {
@@ -104,7 +100,7 @@
   li i {
     // Layout of icons
     padding-right: 0.5em;
-    &:before {
+    &::before {
       display: inline-block;
       text-align: center;
       min-width: 1em;
@@ -113,25 +109,25 @@
 
   .td-sidebar-link.tree-root {
     font-weight: $font-weight-bold;
-    color: $td-sidebar-tree-root-color;
-    border-bottom: 1px $td-sidebar-tree-root-color solid;
+    border-bottom: 1px solid var(--bs-tertiary-color);
     margin-bottom: 1rem;
   }
 }
 
 .td-sidebar {
+  @include link-decoration;
+
   @include media-breakpoint-up(md) {
     padding-top: 4rem;
-    background-color: $td-sidebar-bg-color;
     padding-right: 1rem;
-    border-right: 1px solid $td-sidebar-border-color;
+    border-right: 1px solid var(--bs-border-color);
   }
 
   padding-bottom: 1rem;
 
   &__toggle {
     line-height: 1;
-    color: $gray-900;
+    color: var(--bs-body-color);
     margin: 1rem;
   }
 

assets/scss/_taxonomy.scss

@@ -24,9 +24,9 @@
     display: inline-block;
     width: 100%;
     font-size: 1rem;
-    font-weight: 700;
-    color: $primary;
-    border-bottom: 1px $primary solid;
+    font-weight: $font-weight-bold;
+    color: var(--bs-primary-text-emphasis);
+    border-bottom: 1px solid var(--bs-tertiary-color);
     margin-bottom: 1em;
     padding-bottom: 0.375rem;
     margin-top: 1em;
@@ -105,14 +105,14 @@
   margin-left: 0.6em;
   text-align: center;
   border-radius: 1em;
-  background-color: $white;
+  background-color: var(--bs-body-bg);
 }
 
 .taxonomy-term {
-  background: $gray-200;
+  background: var(--bs-secondary-bg);
   border-width: 0;
   border-radius: 0 3px 3px 0;
-  color: $gray-600;
+  color: var(--bs-body-color);
   display: inline-block;
   font-size: 1em;
   line-height: 1.5em;
@@ -127,11 +127,11 @@
   clip-path: polygon(100% 0, 100% 100%, 0.8em 100%, 0 50%, 0.8em 0);
 
   &:hover {
-    background-color: $primary;
-    color: $white;
+    background-color: var(--bs-primary-bg-subtle);
+    color: var(--bs-body-color-dark);
 
     .taxonomy-count {
-      color: $dark !important;
+      color: var(--bs-body-color-dark);
     }
   }
 
@@ -203,7 +203,7 @@
     font-variant: normal;
     text-rendering: auto;
     -webkit-font-smoothing: antialiased;
-    font-family: $font-awesome-font-name;
+    font-family: $td-font-awesome-font-name;
     // font-weight: 900;
     padding-right: 0.5em;
     font-size: 2em;
@@ -288,24 +288,24 @@
   margin-bottom: 1.5rem;
 }
 
-.article-teaser.article-type-docs h3 a:before {
+.article-teaser.article-type-docs h3 a::before {
   display: inline-block;
   font-style: normal;
   font-variant: normal;
   text-rendering: auto;
   -webkit-font-smoothing: antialiased;
-  font-family: $font-awesome-font-name;
+  font-family: $td-font-awesome-font-name;
   content: "\f02d";
   padding-right: 0.5em;
 }
 
-.article-teaser.article-type-blog h3 a:before {
+.article-teaser.article-type-blog h3 a::before {
   display: inline-block;
   font-style: normal;
   font-variant: normal;
   text-rendering: auto;
   -webkit-font-smoothing: antialiased;
-  font-family: $font-awesome-font-name;
+  font-family: $td-font-awesome-font-name;
   content: "\f781";
   padding-right: 0.5em;
 }
@@ -315,13 +315,13 @@
   line-height: 1.2;
   font-size: 1.5rem;
 
-  &:before {
+  &::before {
     display: inline-block;
     font-style: normal;
     font-variant: normal;
     text-rendering: auto;
     -webkit-font-smoothing: antialiased;
-    font-family: $font-awesome-font-name;
+    font-family: $td-font-awesome-font-name;
     content: "\f122";
     padding-right: 0.5em;
   }
@@ -334,11 +334,11 @@
   }
 
   .breadcrumb {
-    margin-bottom: 0em;
+    margin-bottom: 0;
     font-size: 0.85rem;
   }
 
   .article-meta {
-    margin-bottom: 0em;
+    margin-bottom: 0;
   }
 }

assets/scss/_variables.scss

@@ -3,29 +3,13 @@
 $enable-gradients: true !default;
 $enable-shadows: true !default;
 
-// Theme colors
-
-// TODO: consider moving all of these theme-color definitions into the User
-// Guide SCSS, or declare theme here, but namespaced:
-
-$primary: #30638e !default;
-$secondary: #ffa630 !default;
-$success: #3772ff !default;
-$info: #c0e0de !default;
-$warning: #ed6a5a !default;
-$danger: #ed6a5a !default;
-$light: #d3f3ee !default; // TODO: consider using BS value
-$dark: #403f4c !default;  // TODO: consider using BS value
-
-$code-color: shade-color($secondary, 40%) !default;
+:root,
+[data-bs-theme="light"] {
+  --td-pre-bg: var(--bs-tertiary-bg);
+}
 
 // UI element colors
 
-$border-color: $gray-300 !default;
-$td-sidebar-tree-root-color: $primary !default;
-$td-sidebar-bg-color: rgba($primary, 0.03) !default;
-$td-sidebar-border-color: $border-color !default;
-
 // Background colors for the sections on home page etc. It is a paint by number
 // system, starting at 0, where the number is taken from the shortcode's ordinal
 // if not provided by the user. These colors are all part of the theme palette,
@@ -34,60 +18,27 @@ $td-sidebar-border-color: $border-color !default;
 $td-box-colors: $dark, $primary, $secondary, $info, $white, $gray-600, $success,
   $warning, $dark, $danger, $primary, $secondary, $info !default;
 
-$link-color: $blue-500 !default;
-$link-decoration: none !default;
-$link-shade-percentage: 30% !default;
-
 // Fonts
 
-$td-enable-google-fonts: true !default;
+$td-enable-google-fonts: false !default;
 
-$google_font_name: "Open Sans" !default;
-$google_font_family: "Open+Sans:300,300i,400,400i,700,700i" !default;
-$web-font-path: "https://fonts.googleapis.com/css?family=#{$google_font_family}&display=swap";
-$font-awesome-font-name: "Font Awesome 6 Free" !default;
-
-$td-fonts-serif: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
-  "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji",
-  "Segoe UI Symbol";
+$td-font-awesome-font-name: "Font Awesome 6 Free" !default;
+$td-google-font-name: "Open Sans" !default;
+$td-google-font-family: "Open+Sans:300,300i,400,400i,700,700i" !default;
+$td-web-font-path: "https://fonts.googleapis.com/css?family=#{$td-google-font-family}&display=swap";
 
 @if $td-enable-google-fonts {
-  $td-fonts-serif: join("#{$google_font_name}", $td-fonts-serif);
+  $td-fonts-serif: join("#{$td-google-font-name}", $td-fonts-serif);
 }
 
-$font-family-sans-serif: $td-fonts-serif !default; // TODO: consider moving into UG SCSS or namespace the var (td-)
+$font-family-sans-serif: null !default;
+@if $td-enable-google-fonts {
+  $font-family-sans-serif: $td-fonts-serif;
+}
 
-$font-family-monospace: SFMono-Regular, Menlo, Monaco, Consolas,
-  "Liberation Mono", "Courier New", monospace !default; // TODO: consider moving into UG SCSS or namespace the var (td-)
-$font-family-base: $font-family-sans-serif !default; // TODO: consider moving into UG SCSS or namespace the var (td-)
-
-// Font weights
-
-$font-weight-medium: 500 !default; // TODO: move into var forward file after upgrading BS to v5.3+
-
-$font-weight-body-text: $font-weight-normal !default;
-
-// Heading sizes
-
-$h3-font-size: $font-size-base * 1.5 !default;  // TODO: consider using BS default (* 1.75), or moving into UG SCSS
-$h4-font-size: $font-size-base * 1.35 !default; // TODO: consider using BS default (* 1.5), or moving into UG SCSS
-$h5-font-size: $font-size-base * 1.15 !default; // TODO: consider using BS default (* 1.25), or moving into UG SCSS
+$td-font-weight-body-text: $font-weight-normal !default;
 
 // Space
 
 $td-block-space-top-base: 4 * $spacer !default;
 $td-block-space-bottom-base: 4 * $spacer !default;
-
-// Pagination
-
-$pagination-color: $gray-600 !default; // TODO: consider using BS default
-$pagination-disabled-color: $gray-300 !default; // TODO: consider using BS default
-
-// Navbar
-
-$navbar-dark-color: rgba($white, 0.75) !default;      // TODO: consider moving into UG SCSS
-$navbar-dark-hover-color: rgba($white, 0.5) !default; // TODO: consider moving into UG SCSS
-
-// Footer
-
-$list-inline-padding: $spacer;

assets/scss/_variables_forward.scss

@@ -1,21 +1,58 @@
 // Forward declarations of variables used by _variables.scss and
 // _variables_project.scss.
 //
-// TODO(@chalin): autogenerate the content of this file
+// Docsy theme variables:
+//
+// Note: since these are Docsy variables, we don't forward (repeat) the
+// definitions, we've simply added them here.
+
+$td-fonts-serif: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+  "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji",
+  "Segoe UI Symbol" !default;
+
+$td-font-family-monospace: SFMono-Regular, Menlo, Monaco, Consolas,
+  "Liberation Mono", "Courier New", monospace !default;
+
+// ===================================================
+// DO NOT EDIT non-comment lines beyond this point
+// since they are auto-refreshed.
 
 // Bootstrap SASS variables:
 
 $white:    #fff !default;
+$gray-100: #f8f9fa !default;
+$gray-200: #e9ecef !default;
 $gray-300: #dee2e6 !default;
+$gray-400: #ced4da !default;
+$gray-500: #adb5bd !default;
 $gray-600: #6c757d !default;
+$gray-700: #495057 !default;
+$gray-800: #343a40 !default;
+$gray-900: #212529 !default;
 $black:    #000 !default;
 
 $blue:    #0d6efd !default;
+$indigo:  #6610f2 !default;
+$purple:  #6f42c1 !default;
+$pink:    #d63384 !default;
+$red:     #dc3545 !default;
+$orange:  #fd7e14 !default;
+$yellow:  #ffc107 !default;
+$green:   #198754 !default;
+$teal:    #20c997 !default;
+$cyan:    #0dcaf0 !default;
 
-$blue-500: $blue !default;
-
-$font-size-base: 1rem !default;
-$font-weight-normal: 400 !default;
-$font-weight-bold: 700 !default;
+$font-size-base:              1rem !default; // Assumes the browser default, typically `16px`
+$font-weight-normal:          400 !default;
+$font-weight-bold:            700 !default;
 
 $spacer: 1rem !default;
+
+$primary:       $blue !default;
+$secondary:     $gray-600 !default;
+$success:       $green !default;
+$info:          $cyan !default;
+$warning:       $yellow !default;
+$danger:        $red !default;
+$light:         $gray-100 !default;
+$dark:          $gray-900 !default;

assets/scss/_variables_project.scss

@@ -1,7 +1,4 @@
 /*
-
-Nothing defined here. The Hugo project that uses this theme can override theme variables by adding a file to:
-
-assets/scss/_variables_project.scss
-
+Projects can override this file. For details, see:
+https://www.docsy.dev/docs/adding-content/lookandfeel/#project-style-files
 */

assets/scss/_variables_project_after_bs.scss

@@ -0,0 +1,4 @@
+/*
+Projects can override this file. For details, see:
+https://www.docsy.dev/docs/adding-content/lookandfeel/#project-style-files
+*/

assets/scss/main.scss

@@ -1,6 +1,8 @@
+// cSpell:ignore pageinfo
+
 @import "../vendor/bootstrap/scss/functions";
 
-@import "_variables_forward";
+@import "variables_forward";
 @import "variables_project";
 @import "variables";
 @import "support/mixins";
@@ -8,9 +10,11 @@
 @import "../vendor/bootstrap/scss/bootstrap";
 @import "support/bootstrap_vers_test";
 
-@import "../vendor/Font-Awesome/scss/fontawesome.scss";
-@import "../vendor/Font-Awesome/scss/solid.scss";
-@import "../vendor/Font-Awesome/scss/brands.scss";
+@import "../vendor/Font-Awesome/scss/fontawesome";
+@import "../vendor/Font-Awesome/scss/solid";
+@import "../vendor/Font-Awesome/scss/brands";
+
+@import "variables_project_after_bs";
 
 @import "support/utilities";
 @import "colors";
@@ -33,10 +37,11 @@
 @import "drawio";
 @import "shortcodes";
 @import "swagger";
+@import "support/rtl";
 
 
 @if $td-enable-google-fonts {
-  @import url($web-font-path);
+  @import url($td-web-font-path);
 }
 
 .td-footer {
@@ -49,9 +54,17 @@
     min-height: 200px;
   }
 
-  &__copyright-etc {
+  /* &__left { } */
+
+  &__center {
     @extend .small;
+    text-align: center;
   }
+
+  &__right {
+    text-align: right;
+  }
+
   &__about {
     font-size: initial;
   }
@@ -64,7 +77,7 @@
 
     &-item {
       @extend .list-inline-item;
-      @extend .h3;
+      @include font-size(map-get($font-sizes, 4));
 
       a {
         color: inherit !important;
@@ -72,6 +85,14 @@
     }
   }
 
+  &__authors,
+  &__all_rights_reserved {
+    padding-left: map-get($spacers, 1);
+  }
+
+  &__all_rights_reserved {
+    display: none;
+  }
 }
 
 // Adjust anchors vs the fixed menu.
@@ -83,10 +104,10 @@
     visibility: hidden;
   }
 
-  h2[id]:before,
-  h3[id]:before,
-  h4[id]:before,
-  h5[id]:before {
+  h2[id]::before,
+  h3[id]::before,
+  h4[id]::before,
+  h5[id]::before {
     display: block;
     content: " ";
     margin-top: -5rem;

assets/scss/rtl/_main.scss

@@ -1,55 +0,0 @@
-body:lang(fa),
-body:lang(ar),
-body:lang(az),
-body:lang(dv),
-body:lang(he),
-body:lang(ku),
-body:lang(ur) {
-  @import "spacing";
-
-  direction: rtl;
-  text-align: right;
-
-  .dropdown-menu {
-    text-align: right;
-  }
-
-  .text-right {
-    text-align: left !important;
-  }
-
-  pre {
-    text-align: left;
-    direction: ltr;
-  }
-
-  .td-rss-button {
-    left: 1rem !important;
-    right: auto !important;
-  }
-}
-
-body:lang(fa) {
-  @import url("https://cdn.jsdelivr.net/gh/rastikerdar/vazir-font@v27.0.1/dist/font-face.css");
-  font-family: "Vazir", "Open Sans", -apple-system, BlinkMacSystemFont,
-    "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji",
-    "Segoe UI Emoji", "Segoe UI Symbol";
-}
-
-body:lang(he) {
-  @if $td-enable-google-fonts {
-    @import url("https://fonts.googleapis.com/css2?family=Rubik:wght@300;400;500;600;700&display=swap");
-  }
-  font-family: "Rubik", "Open Sans", -apple-system, BlinkMacSystemFont,
-    "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji",
-    "Segoe UI Emoji", "Segoe UI Symbol";
-}
-
-body:lang(ar) {
-  @if $td-enable-google-fonts {
-    @import url("https://fonts.googleapis.com/css2?family=Tajawal:wght@300;400;500;700&display=swap");
-  }
-  font-family: "Tajawal", "Open Sans", -apple-system, BlinkMacSystemFont,
-    "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji",
-    "Segoe UI Emoji", "Segoe UI Symbol";
-}

assets/scss/rtl/_spacing.scss

@@ -1,87 +0,0 @@
-@each $breakpoint in map-keys($grid-breakpoints) {
-  @include media-breakpoint-up($breakpoint) {
-    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);
-
-    @each $prop, $abbrev in (margin: m, padding: p) {
-      @each $size, $length in $spacers {
-        .#{$abbrev}#{$infix}-#{$size} {
-          #{$prop}: $length !important;
-        }
-
-        .#{$abbrev}t#{$infix}-#{$size},
-        .#{$abbrev}y#{$infix}-#{$size} {
-          #{$prop}-top: $length !important;
-        }
-
-        .#{$abbrev}r#{$infix}-#{$size},
-        .#{$abbrev}x#{$infix}-#{$size} {
-          #{$prop}-inline-end: $length !important;
-        }
-
-        .#{$abbrev}b#{$infix}-#{$size},
-        .#{$abbrev}y#{$infix}-#{$size} {
-          #{$prop}-bottom: $length !important;
-        }
-
-        .#{$abbrev}l#{$infix}-#{$size},
-        .#{$abbrev}x#{$infix}-#{$size} {
-          #{$prop}-inline-start: $length !important;
-        }
-      }
-    }
-
-    // Negative margins (e.g., where `.mb-n1` is negative version of `.mb-1`)
-    @each $size, $length in $spacers {
-      @if $size !=0 {
-        .m#{$infix}-n#{$size} {
-          margin: -$length !important;
-        }
-
-        .mt#{$infix}-n#{$size},
-        .my#{$infix}-n#{$size} {
-          margin-top: -$length !important;
-        }
-
-        .mr#{$infix}-n#{$size},
-        .mx#{$infix}-n#{$size} {
-          margin-right: -$length !important;
-        }
-
-        .mb#{$infix}-n#{$size},
-        .my#{$infix}-n#{$size} {
-          margin-bottom: -$length !important;
-        }
-
-        .ml#{$infix}-n#{$size},
-        .mx#{$infix}-n#{$size} {
-          margin-left: -$length !important;
-        }
-      }
-    }
-
-    // Some special margin utils
-    .m#{$infix}-auto {
-      margin: auto !important;
-    }
-
-    .mt#{$infix}-auto,
-    .my#{$infix}-auto {
-      margin-top: auto !important;
-    }
-
-    .mr#{$infix}-auto,
-    .mx#{$infix}-auto {
-      margin-right: auto !important;
-    }
-
-    .mb#{$infix}-auto,
-    .my#{$infix}-auto {
-      margin-bottom: auto !important;
-    }
-
-    .ml#{$infix}-auto,
-    .mx#{$infix}-auto {
-      margin-left: auto !important;
-    }
-  }
-}

assets/scss/section-index.scss

@@ -7,7 +7,7 @@
     margin-bottom: 0;
 
     a {
-      font-weight: 700;
+      font-weight: $font-weight-bold;
     }
   }
 

assets/scss/shortcodes.scss

@@ -1,2 +1,2 @@
-@import "shortcodes/tabbed-pane.scss";
-@import "shortcodes/cards-pane.scss";
+@import "shortcodes/tabbed-pane";
+@import "shortcodes/cards-pane";

assets/scss/shortcodes/cards-pane.scss

@@ -12,15 +12,18 @@
     }
   }
 
+  .card-header.code {
+    background-color: $card-bg;
+  }
+
   .card-body {
     &.code {
-      background-color: #f8f9fa;
+      background-color: $card-bg;
       padding: 0 0 0 1ex;
     }
 
     pre {
       margin: 0;
-      padding: 0 1rem 1rem 1rem;
     }
   }
 }

assets/scss/shortcodes/tabbed-pane.scss

@@ -10,18 +10,18 @@
       border: none;
       max-width: 100%;
     }
-    margin-top: 0rem;
+    margin-top: 0;
     margin-bottom: 1.5rem;
-    border-left: 1px solid rgba(0, 0, 0, 0.125);
-    border-right: 1px solid rgba(0, 0, 0, 0.125);
-    border-bottom: 1px solid rgba(0, 0, 0, 0.125);
+    border-left: $nav-tabs-border-width solid $nav-tabs-border-color;
+    border-right: $nav-tabs-border-width solid $nav-tabs-border-color;
+    border-bottom: $nav-tabs-border-width solid $nav-tabs-border-color;
   }
 }
 
 .tab-body {
   font-weight: $font-weight-medium;
-  background: $gray-100;
-  color: inherit;
+  background: var(--td-pre-bg);
+  color: var(--bs-body-color);
   border-radius: 0;
   padding: 1.5rem;
 

assets/scss/support/_mixins.scss

@@ -1,5 +1,20 @@
 // Mixins
 
+@mixin link-decoration($base: none, $focus_or_hover: initial) {
+  a {
+    text-decoration: $base;
+
+    &:focus,
+    &:hover {
+      text-decoration: $focus_or_hover;
+    }
+  }
+
+  .btn-link {
+    text-decoration: $base;
+  }
+}
+
 @mixin link-variant($parent, $color, $hover-color, $underline: false) {
   #{$parent} {
     color: $color;

assets/scss/support/_utilities.scss

@@ -25,10 +25,7 @@
   &::after {
     content: "";
     position: absolute;
-    top: 0;
-    right: 0;
-    bottom: 0;
-    left: 0;
+    inset: 0;
   }
 
   &--dark::after {

assets/scss/td/_code-dark.scss

@@ -0,0 +1,10 @@
+[data-bs-theme="light"] {
+  @import 'td/chroma/light';
+}
+
+[data-bs-theme="dark"] {
+  @import 'td/chroma/dark';
+  .chroma {
+    background-color: var(--td-pre-bg);
+  }
+}

assets/scss/td/chroma/_dark.scss

@@ -0,0 +1,89 @@
+/* Chroma style: onedark */
+/* Generated using: hugo gen chromastyles --style=onedark */
+
+/* Background */ .bg { color:#abb2bf;background-color:#282c34; }
+/* PreWrapper */ .chroma { color:#abb2bf;background-color:#282c34; }
+/* Other */ .chroma .x {  }
+/* Error */ .chroma .err {  }
+/* CodeLine */ .chroma .cl {  }
+/* LineLink */ .chroma .lnlinks { outline:none;text-decoration:none;color:inherit }
+/* LineTableTD */ .chroma .lntd { vertical-align:top;padding:0;margin:0;border:0; }
+/* LineTable */ .chroma .lntable { border-spacing:0;padding:0;margin:0;border:0; }
+/* LineHighlight */ .chroma .hl { background-color:#3d4148 }
+/* LineNumbersTable */ .chroma .lnt { white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#55595f }
+/* LineNumbers */ .chroma .ln { white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#55595f }
+/* Line */ .chroma .line { display:flex; }
+/* Keyword */ .chroma .k { color:#c678dd }
+/* KeywordConstant */ .chroma .kc { color:#e5c07b }
+/* KeywordDeclaration */ .chroma .kd { color:#c678dd }
+/* KeywordNamespace */ .chroma .kn { color:#c678dd }
+/* KeywordPseudo */ .chroma .kp { color:#c678dd }
+/* KeywordReserved */ .chroma .kr { color:#c678dd }
+/* KeywordType */ .chroma .kt { color:#e5c07b }
+/* Name */ .chroma .n { color:#e06c75 }
+/* NameAttribute */ .chroma .na { color:#e06c75 }
+/* NameClass */ .chroma .nc { color:#e5c07b }
+/* NameConstant */ .chroma .no { color:#e06c75 }
+/* NameDecorator */ .chroma .nd { color:#61afef }
+/* NameEntity */ .chroma .ni { color:#e06c75 }
+/* NameException */ .chroma .ne { color:#e06c75 }
+/* NameLabel */ .chroma .nl { color:#e06c75 }
+/* NameNamespace */ .chroma .nn { color:#e06c75 }
+/* NameOther */ .chroma .nx { color:#e06c75 }
+/* NameProperty */ .chroma .py { color:#e06c75 }
+/* NameTag */ .chroma .nt { color:#e06c75 }
+/* NameBuiltin */ .chroma .nb { color:#e5c07b }
+/* NameBuiltinPseudo */ .chroma .bp { color:#e5c07b }
+/* NameVariable */ .chroma .nv { color:#e06c75 }
+/* NameVariableClass */ .chroma .vc { color:#e06c75 }
+/* NameVariableGlobal */ .chroma .vg { color:#e06c75 }
+/* NameVariableInstance */ .chroma .vi { color:#e06c75 }
+/* NameVariableMagic */ .chroma .vm { color:#e06c75 }
+/* NameFunction */ .chroma .nf { color:#61afef;font-weight:bold }
+/* NameFunctionMagic */ .chroma .fm { color:#56b6c2;font-weight:bold }
+/* Literal */ .chroma .l {  }
+/* LiteralDate */ .chroma .ld {  }
+/* LiteralString */ .chroma .s { color:#98c379 }
+/* LiteralStringAffix */ .chroma .sa { color:#98c379 }
+/* LiteralStringBacktick */ .chroma .sb { color:#98c379 }
+/* LiteralStringChar */ .chroma .sc { color:#98c379 }
+/* LiteralStringDelimiter */ .chroma .dl { color:#98c379 }
+/* LiteralStringDoc */ .chroma .sd { color:#98c379 }
+/* LiteralStringDouble */ .chroma .s2 { color:#98c379 }
+/* LiteralStringEscape */ .chroma .se { color:#98c379 }
+/* LiteralStringHeredoc */ .chroma .sh { color:#98c379 }
+/* LiteralStringInterpol */ .chroma .si { color:#98c379 }
+/* LiteralStringOther */ .chroma .sx { color:#98c379 }
+/* LiteralStringRegex */ .chroma .sr { color:#98c379 }
+/* LiteralStringSingle */ .chroma .s1 { color:#98c379 }
+/* LiteralStringSymbol */ .chroma .ss { color:#98c379 }
+/* LiteralNumber */ .chroma .m { color:#d19a66 }
+/* LiteralNumberBin */ .chroma .mb { color:#d19a66 }
+/* LiteralNumberFloat */ .chroma .mf { color:#d19a66 }
+/* LiteralNumberHex */ .chroma .mh { color:#d19a66 }
+/* LiteralNumberInteger */ .chroma .mi { color:#d19a66 }
+/* LiteralNumberIntegerLong */ .chroma .il { color:#d19a66 }
+/* LiteralNumberOct */ .chroma .mo { color:#d19a66 }
+/* Operator */ .chroma .o { color:#56b6c2 }
+/* OperatorWord */ .chroma .ow { color:#56b6c2 }
+/* Punctuation */ .chroma .p {  }
+/* Comment */ .chroma .c { color:#7f848e }
+/* CommentHashbang */ .chroma .ch { color:#7f848e }
+/* CommentMultiline */ .chroma .cm { color:#7f848e }
+/* CommentSingle */ .chroma .c1 { color:#7f848e }
+/* CommentSpecial */ .chroma .cs { color:#7f848e }
+/* CommentPreproc */ .chroma .cp { color:#7f848e }
+/* CommentPreprocFile */ .chroma .cpf { color:#7f848e }
+/* Generic */ .chroma .g {  }
+/* GenericDeleted */ .chroma .gd { color:#e06c75 }
+/* GenericEmph */ .chroma .ge {  }
+/* GenericError */ .chroma .gr {  }
+/* GenericHeading */ .chroma .gh {  }
+/* GenericInserted */ .chroma .gi { color:#98c379;font-weight:bold }
+/* GenericOutput */ .chroma .go {  }
+/* GenericPrompt */ .chroma .gp {  }
+/* GenericStrong */ .chroma .gs {  }
+/* GenericSubheading */ .chroma .gu {  }
+/* GenericTraceback */ .chroma .gt {  }
+/* GenericUnderline */ .chroma .gl {  }
+/* TextWhitespace */ .chroma .w {  }

assets/scss/td/chroma/_light.scss

@@ -0,0 +1,89 @@
+/* Chroma style: tango */
+/* Generated using: hugo gen chromastyles --style=tango */
+
+/* Background */ .bg { background-color:#f8f8f8; }
+/* PreWrapper */ .chroma { background-color:#f8f8f8; }
+/* Other */ .chroma .x { color:#000 }
+/* Error */ .chroma .err { color:#a40000 }
+/* CodeLine */ .chroma .cl {  }
+/* LineLink */ .chroma .lnlinks { outline:none;text-decoration:none;color:inherit }
+/* LineTableTD */ .chroma .lntd { vertical-align:top;padding:0;margin:0;border:0; }
+/* LineTable */ .chroma .lntable { border-spacing:0;padding:0;margin:0;border:0; }
+/* LineHighlight */ .chroma .hl { background-color:#dfdfdf }
+/* LineNumbersTable */ .chroma .lnt { white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f }
+/* LineNumbers */ .chroma .ln { white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f }
+/* Line */ .chroma .line { display:flex; }
+/* Keyword */ .chroma .k { color:#204a87;font-weight:bold }
+/* KeywordConstant */ .chroma .kc { color:#204a87;font-weight:bold }
+/* KeywordDeclaration */ .chroma .kd { color:#204a87;font-weight:bold }
+/* KeywordNamespace */ .chroma .kn { color:#204a87;font-weight:bold }
+/* KeywordPseudo */ .chroma .kp { color:#204a87;font-weight:bold }
+/* KeywordReserved */ .chroma .kr { color:#204a87;font-weight:bold }
+/* KeywordType */ .chroma .kt { color:#204a87;font-weight:bold }
+/* Name */ .chroma .n { color:#000 }
+/* NameAttribute */ .chroma .na { color:#c4a000 }
+/* NameClass */ .chroma .nc { color:#000 }
+/* NameConstant */ .chroma .no { color:#000 }
+/* NameDecorator */ .chroma .nd { color:#5c35cc;font-weight:bold }
+/* NameEntity */ .chroma .ni { color:#ce5c00 }
+/* NameException */ .chroma .ne { color:#c00;font-weight:bold }
+/* NameLabel */ .chroma .nl { color:#f57900 }
+/* NameNamespace */ .chroma .nn { color:#000 }
+/* NameOther */ .chroma .nx { color:#000 }
+/* NameProperty */ .chroma .py { color:#000 }
+/* NameTag */ .chroma .nt { color:#204a87;font-weight:bold }
+/* NameBuiltin */ .chroma .nb { color:#204a87 }
+/* NameBuiltinPseudo */ .chroma .bp { color:#3465a4 }
+/* NameVariable */ .chroma .nv { color:#000 }
+/* NameVariableClass */ .chroma .vc { color:#000 }
+/* NameVariableGlobal */ .chroma .vg { color:#000 }
+/* NameVariableInstance */ .chroma .vi { color:#000 }
+/* NameVariableMagic */ .chroma .vm { color:#000 }
+/* NameFunction */ .chroma .nf { color:#000 }
+/* NameFunctionMagic */ .chroma .fm { color:#000 }
+/* Literal */ .chroma .l { color:#000 }
+/* LiteralDate */ .chroma .ld { color:#000 }
+/* LiteralString */ .chroma .s { color:#4e9a06 }
+/* LiteralStringAffix */ .chroma .sa { color:#4e9a06 }
+/* LiteralStringBacktick */ .chroma .sb { color:#4e9a06 }
+/* LiteralStringChar */ .chroma .sc { color:#4e9a06 }
+/* LiteralStringDelimiter */ .chroma .dl { color:#4e9a06 }
+/* LiteralStringDoc */ .chroma .sd { color:#8f5902;font-style:italic }
+/* LiteralStringDouble */ .chroma .s2 { color:#4e9a06 }
+/* LiteralStringEscape */ .chroma .se { color:#4e9a06 }
+/* LiteralStringHeredoc */ .chroma .sh { color:#4e9a06 }
+/* LiteralStringInterpol */ .chroma .si { color:#4e9a06 }
+/* LiteralStringOther */ .chroma .sx { color:#4e9a06 }
+/* LiteralStringRegex */ .chroma .sr { color:#4e9a06 }
+/* LiteralStringSingle */ .chroma .s1 { color:#4e9a06 }
+/* LiteralStringSymbol */ .chroma .ss { color:#4e9a06 }
+/* LiteralNumber */ .chroma .m { color:#0000cf;font-weight:bold }
+/* LiteralNumberBin */ .chroma .mb { color:#0000cf;font-weight:bold }
+/* LiteralNumberFloat */ .chroma .mf { color:#0000cf;font-weight:bold }
+/* LiteralNumberHex */ .chroma .mh { color:#0000cf;font-weight:bold }
+/* LiteralNumberInteger */ .chroma .mi { color:#0000cf;font-weight:bold }
+/* LiteralNumberIntegerLong */ .chroma .il { color:#0000cf;font-weight:bold }
+/* LiteralNumberOct */ .chroma .mo { color:#0000cf;font-weight:bold }
+/* Operator */ .chroma .o { color:#ce5c00;font-weight:bold }
+/* OperatorWord */ .chroma .ow { color:#204a87;font-weight:bold }
+/* Punctuation */ .chroma .p { color:#000;font-weight:bold }
+/* Comment */ .chroma .c { color:#8f5902;font-style:italic }
+/* CommentHashbang */ .chroma .ch { color:#8f5902;font-style:italic }
+/* CommentMultiline */ .chroma .cm { color:#8f5902;font-style:italic }
+/* CommentSingle */ .chroma .c1 { color:#8f5902;font-style:italic }
+/* CommentSpecial */ .chroma .cs { color:#8f5902;font-style:italic }
+/* CommentPreproc */ .chroma .cp { color:#8f5902;font-style:italic }
+/* CommentPreprocFile */ .chroma .cpf { color:#8f5902;font-style:italic }
+/* Generic */ .chroma .g { color:#000 }
+/* GenericDeleted */ .chroma .gd { color:#a40000 }
+/* GenericEmph */ .chroma .ge { color:#000;font-style:italic }
+/* GenericError */ .chroma .gr { color:#ef2929 }
+/* GenericHeading */ .chroma .gh { color:#000080;font-weight:bold }
+/* GenericInserted */ .chroma .gi { color:#00a000 }
+/* GenericOutput */ .chroma .go { color:#000;font-style:italic }
+/* GenericPrompt */ .chroma .gp { color:#8f5902 }
+/* GenericStrong */ .chroma .gs { color:#000;font-weight:bold }
+/* GenericSubheading */ .chroma .gu { color:#800080;font-weight:bold }
+/* GenericTraceback */ .chroma .gt { color:#a40000;font-weight:bold }
+/* GenericUnderline */ .chroma .gl { color:#000;text-decoration:underline }
+/* TextWhitespace */ .chroma .w { color:#f8f8f8;text-decoration:underline }

go.mod

@@ -5,6 +5,6 @@ go 1.12
 // AUTO-GENERATED using `npm run get:hugo-modules`
 
 require (
-	github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2 // indirect
-	github.com/twbs/bootstrap v5.2.3+incompatible // indirect
+	github.com/FortAwesome/Font-Awesome v0.0.0-20241216213156-af620534bfc3 // indirect
+	github.com/twbs/bootstrap v5.3.6+incompatible // indirect
 )

go.sum

@@ -1,4 +1,4 @@
-github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2 h1:Uv1z5EqCfmiK4IHUwT0m3h/u/WCk+kpRfxvAZhpC7Gc=
-github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
-github.com/twbs/bootstrap v5.2.3+incompatible h1:lOmsJx587qfF7/gE7Vv4FxEofegyJlEACeVV+Mt7cgc=
-github.com/twbs/bootstrap v5.2.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=
+github.com/FortAwesome/Font-Awesome v0.0.0-20241216213156-af620534bfc3 h1:/iluJkJiyTAdnqrw3Yi9rH2HNHhrrtCmj8VJe7I6o3w=
+github.com/FortAwesome/Font-Awesome v0.0.0-20241216213156-af620534bfc3/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
+github.com/twbs/bootstrap v5.3.6+incompatible h1:efmXVyq839m5QQ0+JBUdQQ1TrmoBqvQ5kRhUueKsH+4=
+github.com/twbs/bootstrap v5.3.6+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=

hugo.yaml

@@ -18,7 +18,7 @@ outputFormats:
 module:
   hugoVersion:
     extended: true
-    min: 0.110.0
+    min: 0.146.0
   mounts:
     - source: assets
       target: assets
@@ -44,7 +44,7 @@ module:
       target: static/webfonts
     # Mounts for module installations,
     # needed to work around a known bug in Go’s module management.
-    - source: assets/_vendor/bootstrap/scss/
+    - source: assets/_vendor/bootstrap/scss
       target: assets/vendor/bootstrap/scss/vendor
   imports:
     - path: github.com/twbs/bootstrap

i18n/ar.toml

@@ -1,80 +1,89 @@
 # UI strings. Buttons and similar.
-
 [ui_pager_prev]
-other = "السابق"
+other = "السَّابق"
 
 [ui_pager_next]
-other = "التالي"
+other = "التَّالي"
 
 [ui_read_more]
-other = "إقرأ المزيد"
+other = "اِقْرأ اَلمزِيد"
 
 [ui_search]
-other = "ابحث في هذا الموقع"
+other = "اِبْحث فِي هذَا اَلموْقِع"
 
 # Used in sentences such as "Posted in News"
 [ui_in]
-other = "في"
+other = "فِي"
+
 # Used in sentences such as "All Tags"
 [ui_all]
-other = "كل"
+other = "كُلَّ"
 
 # Footer text
 [footer_all_rights_reserved]
-other = "كافة الحقوق محفوظة"
+other = "كَافَّة اَلحُقوق مَحفُوظة"
 
 [footer_privacy_policy]
-other = "سياسة الخصوصية"
+other = "سِياسة الخصوصيَّة"
 
-
-# Post (blog, articles etc.)
+# Post (blog , articles etc.)
 [post_byline_by]
 other = "الكاتب"
 [post_created]
-other = "منشئة"
+other = "مُنْشِئة"
 [post_last_mod]
-other = "اخر تعديل"
+other = "آخر تَعدِيل"
 [post_edit_this]
-other = "عدل هذه الصفحة"
+other = "عدل هَذِه الصَّفْحة"
 [post_view_this]
-other = "أنظر مصدر الصفحة"
+other = "أَنظُر مَصدَر الصَّفْحة"
 [post_create_child_page]
-other = " أنشئ صفحة فرعية"
+other = "أُنْشِئ صَفحَة فَرعِية"
 [post_create_issue]
-other = "أنشئ مسألة حول الوثائق"
+other = "أُنْشِئ مَسْأَلة حَوْل الوثائق"
 [post_create_project_issue]
-other = "أنشئ مسألة حول المشروع"
+other = "أُنْشِئ مَسْأَلة حَوْل المشْروع"
 [post_posts_in]
-other = "منشور في"
+other = "مَنشُور فِي"
 [post_reading_time]
-other = "دقيقة للقراءة"
+other = "دَقِيقَة لِلْقراءة"
 [post_less_than_a_minute_read]
-other = "أقل من دقيقة"
+other = "أقلَّ مِن دَقِيقَة"
 
 # Print support
 [print_printable_section]
-other = "هذا العرض يتضمن عدة صفحات للطباعة ضمن هذا القسم."
+other = "هذَا العرْض يَتَضمَّن عِدَّة صَفَحات لِلطِّباعة ضِمْن هذَا القسْم."
 [print_click_to_print]
-other = "اضغط هنا للطباعة"
+other = "اِضْغط هُنَا لِلطِّباعة"
 [print_show_regular]
-other = "العودة للعرض العادي"
+other = "اَلْعَودة لِلْعرْض العاديِّ"
 [print_entire_section]
-other = "اطبع القسم كاملا"
+other = "اِطْبع القسْم كاملا"
 
 # Community
 [community_join]
-other = "انضم الي مجتمع {{ .Site.Title }}"
+other = "اِنْضمَّ إِلى مُجتَمَع {{ .Site.Title }}"
 [community_introduce]
-other = "{{ .Site.Title }} هو مشروع مفتوح المصدر يمكن لأي شخص في المجتمع استخدامه وتحسينه والاستمتاع به. يسعدنا أن تنضم إلينا! إليك بعض الطرق للمشاركة و معرفة ما يحدث."
+other = "{{ .Site.Title }} هُو مَشرُوع مَفتُوح المصْدر يُمْكِن لِأيِّ شَخْص فِي المجْتمع اِسْتخْدامه وتحْسينه والاسْتمْتاع بِه. يُسْعدنَا أن تَنضَم إِليْنَا! إِلَيك بَعْض الطُّرق لِلْمشاركة ومتابعة آخر التَّحْديثات."
 [community_learn]
-other = "تعلم وتواصل"
+other = "تَعلُّم وتواصل"
 [community_using]
-other = "تستخدام أو تريد استخدام {{ .Site.Title }}؟ اكتشف المزيد هنا:"
+other = "تِسْتخْدام أو تُريد اِسْتخْدام {{ .Site.Title }} ؟ اِكتشَف اَلمزِيد هُنَا:"
 [community_develop]
-other = "طور و ساهم"
+other = "طَوَّر وساهم "
 [community_contribute]
-other = "إذا كنت ترغب في المشاركة بشكل أكبر من خلال المساهمة في {{ .Site.Title }}, انضم إلينا هنا:"
+other = "إِذَا كُنْت تَرغَب فِي المشاركة بِشَكل أَكبَر مِن خِلَال المساهمة فِي {{ .Site.Title }} ،اِنْضمَّ إِليْنَا هُنَا:"
 [community_how_to]
-other = "يمكنك معرفة كيفية المساهمة في {{ .Site.Title }} من خلال"
+other = "يُمْكِنك مَعرِفة كَيفِية المساهمة فِي {{ .Site.Title }} مِن خِلَال"
 [community_guideline]
-other = "إرشادات المساهمة"
+other = "إِرْشادات المساهمة"
+
+# Feedback
+[feedback_title]
+other = "تَقيِيم الأدَاء"
+[feedback_question]
+other = "هل كَانَت هَذِه الصَّفْحة مُفيدَة"
+[feedback_positive]
+other = "نعم"
+[feedback_negative]
+other = "لََا"

i18n/es.toml

@@ -79,3 +79,13 @@ other = "Si deseas involucrarte más contribuyendo a {{ .Site.Title }}, únete a
 other = "Puedes averiguar cómo contribuir a {{ .Site.Title }} en nuestras"
 [community_guideline]
 other = "Guias de Contribución"
+
+# Feedback
+[feedback_title]
+other = "Comentarios"
+[feedback_question]
+other = "¿Fue útil esta página?"
+[feedback_positive]
+other = "Si"
+[feedback_negative]
+other = "No"

i18n/fa.toml

@@ -1,5 +1,3 @@
-
-
 # UI strings. Buttons and similar.
 
 [ui_pager_prev]
@@ -35,6 +33,8 @@ other = "ساخته شده"
 other = "آخرین تغییرات"
 [post_edit_this]
 other = "این صفحه را ویرایش کنید"
+[post_view_this]
+other = "مشاهده منبع صفحه"
 [post_create_child_page]
 other = "ایجاد زیر صفحه در این صفحه"
 [post_create_issue]
@@ -76,3 +76,13 @@ other = "If you want to get more involved by contributing to {{ .Site.Title }},
 other = "You can find out how to contribute to {{ .Site.Title }} in our"
 [community_guideline]
 other = "Contribution Guidelines"
+
+# Feedback
+[feedback_title]
+other = "بازخورد"
+[feedback_question]
+other = "این صفحه به شما کمک کرد؟"
+[feedback_positive]
+other = "آره"
+[feedback_negative]
+other = "نه"

i18n/fr.toml

@@ -77,3 +77,14 @@ other = "Si vous voulez vous impliquer davantage en contribuant à {{ .Site.Titl
 other = "Vous pouvez trouver comment contribuer à {{ .Site.Title }} dans nos"
 [community_guideline]
 other = "Règles de contribution"
+
+# Feedback
+[feedback_title]
+other = "Feedback"
+[feedback_question]
+other = "Cette page est-elle utile?"
+[feedback_positive]
+other = "Oui"
+[feedback_negative]
+other = "Non"
+

i18n/ja.toml

@@ -77,3 +77,13 @@ other = "If you want to get more involved by contributing to {{ .Site.Title }},
 other = "You can find out how to contribute to {{ .Site.Title }} in our"
 [community_guideline]
 other = "Contribution Guidelines"
+
+# Feedback
+[feedback_title]
+other = "フィードバック"
+[feedback_question]
+other = "このページは役に立ちましたか?"
+[feedback_positive]
+other = "役に立った"
+[feedback_negative]
+other = "役に立たなかった"

i18n/no.toml

@@ -20,10 +20,10 @@ other = "i"
 
 # Footer text
 [footer_all_rights_reserved]
-other = "Alle retter er reservert"
+other = "Alle rettigheter er reservert"
 
 [footer_privacy_policy]
-other = "Privacy Policy"
+other = "Personvernpolicy"
 
 
 # Post (blog, articles etc.)
@@ -36,42 +36,44 @@ other = "Sist endret"
 [post_edit_this]
 other = "Endre denne siden"
 [post_create_child_page]
-other = "Create child page"
+other = "Lag underside"
 [post_create_issue]
 other = "Opprett dokumentasjon sak"
 [post_create_project_issue]
 other = "Opprett prosjekt sak"
 [post_posts_in]
-other = "Poster i"
+other = "Poster til"
 [post_reading_time]
 other = "minute read"
 [post_less_than_a_minute_read]
 other = "less than a minute"
+[post_view_this]
+other = "Vis kildekoden"
 
 # Print support
 [print_printable_section]
-other = "This is the multi-page printable view of this section."
+other = "Dette er flersidevisningen av denne seksjonen."
 [print_click_to_print]
-other = "Click here to print"
+other = "Klikk her for å skrive ut"
 [print_show_regular]
-other = "Return to the regular view of this page"
+other = "Gå tilbake til vanlig sidevisning"
 [print_entire_section]
-other = "Print entire section"
+other = "Skriv ut hele seksjonen"
 
 # Community
 [community_join]
-other = "Join the {{ .Site.Title }} community"
+other = "Bli med i {{ .Site.Title }} fellesskapet"
 [community_introduce]
-other = "{{ .Site.Title }} is an open source project that anyone in the community can use, improve, and enjoy. We'd love you to join us! Here's a few ways to find out what's happening and get involved."
+other = "{{ .Site.Title }} er et åpen kildekodeprosjekt som alle kan bruke, forbedre og glede seg over. Bli med - her er noen måter du kan holde deg oppdatert på og bidra."
 [community_learn]
-other = "Learn and Connect"
+other = "Lær og få kontakt"
 [community_using]
-other = "Using or want to use {{ .Site.Title }}? Find out more here:"
+other = "Bruker du, eller har du lyst til å bruke {{ .Site.Title }}? Lær mer her:"
 [community_develop]
-other = "Develop and Contribute"
+other = "Bidra og videreutvikle"
 [community_contribute]
-other = "If you want to get more involved by contributing to {{ .Site.Title }}, join us here:"
+other = "Dersom du vil involvere deg mer ved å bidra til {{ .Site.Title }}, bli med oss her:"
 [community_how_to]
-other = "You can find out how to contribute to {{ .Site.Title }} in our"
+other = "Du kan finne ut hvordan du bidrar til {{ .Site.Title }} i vår"
 [community_guideline]
-other = "Contribution Guidelines"
+other = "Retningslinjer for bidrag"

i18n/oc.toml

@@ -0,0 +1,90 @@
+# UI strings. Buttons and similar.
+
+[ui_pager_prev]
+other = "Precedent"
+
+[ui_pager_next]
+other = "Seguent"
+
+[ui_read_more]
+other = "Ne legir mai"
+
+[ui_search]
+other = "Cercar dins lo site…"
+
+# Used in sentences such as "Posted in News"
+[ui_in]
+other = "Dins"
+
+# Used in sentences such as "All Tags"
+[ui_all]
+other = "Totas"
+
+# Footer text
+[footer_all_rights_reserved]
+other = "Tot drech reservat"
+
+[footer_privacy_policy]
+other = "Politica de confidencialitat"
+
+# Post (blog, articles etc.)
+[post_byline_by]
+other = "Per"
+[post_created]
+other = "Creacion"
+[post_last_mod]
+other = "Darrièra modificacion"
+[post_edit_this]
+other = "Modificar aquesta pagina"
+[post_view_this]
+other = "Veire la pagina font"
+[post_create_child_page]
+other = "Crear una pagina enfant"
+[post_create_issue]
+other = "Crear una anomalia de documentacion"
+[post_create_project_issue]
+other = "Crear una anomalia de projècte"
+[post_posts_in]
+other = "Publicacions dins"
+[post_reading_time]
+other = "minutas de lectura"
+[post_less_than_a_minute_read]
+other = "mens d'una minuta de lectura"
+
+# Print support
+[print_printable_section]
+other = "Aquò es una vista multipagina imprimibla de la seccion."
+[print_click_to_print]
+other = "Clicar aquí per imprimir"
+[print_show_regular]
+other = "Tornar a la vista normala d'aquesta pagina"
+[print_entire_section]
+other = "Imprimir la seccion complèta"
+
+# Community
+[community_join]
+other = "Rejónher la comunitat {{ .Site.Title }}"
+[community_introduce]
+other = "{{ .Site.Title }} es un projècte liure que totòm dins la comunitat pòt utilizar, melhorar e n'aprofichar. Nos agradariá que nos rejonguèssetz ! Vaquí d'unas etapas per saber çò que se passa e s'implicar."
+[community_learn]
+other = "Aprendre e se connectar"
+[community_using]
+other = "Utilizatz o volètz utilizar {{ .Site.Title }} ? Aprenètz-ne mai aquí :"
+[community_develop]
+other = "Desvelopar e contribuir"
+[community_contribute]
+other = "Se volètz vos implicar en contribuissent a {{ .Site.Title }}, retrobatz-nos :"
+[community_how_to]
+other = "Podètz trobar cossí contribuir a {{ .Site.Title }} dins nòstra"
+[community_guideline]
+other = "Guida de contribucion"
+
+# Feedback
+[feedback_title]
+other = "Feedback"
+[feedback_question]
+other = "Èra utila aquesta pagina ?"
+[feedback_positive]
+other = "Oc"
+[feedback_negative]
+other = "Non"

i18n/pl.toml

@@ -12,7 +12,7 @@ other = "Dalej"
 other = "Zobacz więcej"
 
 [ui_search]
-other = "Szukaj ns stronie ..."
+other = "Szukaj na stronie ..."
 
 # Used in sentences such as "Posted in News"
 [ui_in]

i18n/pt-br.toml

@@ -1,5 +1,3 @@
-
-
 # UI strings. Buttons and similar.
 
 [ui_pager_prev]
@@ -18,6 +16,10 @@ other = "Buscar no site…"
 [ui_in]
 other = "em"
 
+# Used in sentences such as "All Tags"
+[ui_all]
+other = "todos"
+
 # Footer text
 [footer_all_rights_reserved]
 other = "Todos os direitos reservados"
@@ -25,7 +27,6 @@ other = "Todos os direitos reservados"
 [footer_privacy_policy]
 other = "Política de Privacidade"
 
-
 # Post (blog, articles etc.)
 [post_byline_by]
 other = "Por"
@@ -35,6 +36,8 @@ other = "Criado"
 other = "Última modificação"
 [post_edit_this]
 other = "Editar essa página"
+[post_view_this]
+other = "Ver origem da página"
 [post_create_child_page]
 other = "Criar uma subpágina"
 [post_create_issue]
@@ -75,3 +78,13 @@ other = "If you want to get more involved by contributing to {{ .Site.Title }},
 other = "You can find out how to contribute to {{ .Site.Title }} in our"
 [community_guideline]
 other = "Contribution Guidelines"
+
+# Feedback
+[feedback_title]
+other = "Feedback"
+[feedback_question]
+other = "Esta página foi útil?"
+[feedback_positive]
+other = "Sim"
+[feedback_negative]
+other = "Não"

i18n/sr-cyrl.toml

@@ -0,0 +1,90 @@
+# UI strings. Buttons and similar.
+
+[ui_pager_prev]
+other = "Претходно"
+
+[ui_pager_next]
+other = "Наредно"
+
+[ui_read_more]
+other = "Прочитајте више"
+
+[ui_search]
+other = "Претражите сајт…"
+
+# Used in sentences such as "Posted in News"
+[ui_in]
+other = "у"
+
+# Used in sentences such as "All Tags"
+[ui_all]
+other = "све"
+
+# Footer text
+[footer_all_rights_reserved]
+other = "Сва права задржана"
+
+[footer_privacy_policy]
+other = "Политика приватности"
+
+# Post (blog, articles etc.)
+[post_byline_by]
+other = "Аутор"
+[post_created]
+other = "Креирано"
+[post_last_mod]
+other = "Последњи пут измењено"
+[post_edit_this]
+other = "Уредите ову страницу"
+[post_view_this]
+other = "Погледајте извор странице"
+[post_create_child_page]
+other = "Креирајте подстраницу"
+[post_create_issue]
+other = "Креирајте issue за документацију"
+[post_create_project_issue]
+other = "Креирајте issue за пројекат"
+[post_posts_in]
+other = "Објава у"
+[post_reading_time]
+other = "минута за читање"
+[post_less_than_a_minute_read]
+other = "мање од минута за читање"
+
+# Print support
+[print_printable_section]
+other = "Ово је вишестрани преглед за штампање ове секције."
+[print_click_to_print]
+other = "Кликните овде за штампање"
+[print_show_regular]
+other = "Повратак на обичан преглед ове странице"
+[print_entire_section]
+other = "Одштампајте читаву секцију"
+
+# Community
+[community_join]
+other = "Придружите се {{ .Site.Title }} заједници"
+[community_introduce]
+other = "{{ .Site.Title }} је open source пројекат којег свако у заједници може да користи, унапређује и да ужива у њему. Волели бисмо да нам се придружите! Овде се можете укључити како бисте сазнали шта се дешава."
+[community_learn]
+other = "Научите и повежите се"
+[community_using]
+other = "Већ користите или желите да почнете користити {{ .Site.Title }}? Сазнајте више:"
+[community_develop]
+other = "Развој и допринос"
+[community_contribute]
+other = "Ако желите да се више укључите у допринос на {{ .Site.Title }}, придружите нам се:"
+[community_how_to]
+other = "Можете сазнати како да допринесете на {{ .Site.Title }} у нашим"
+[community_guideline]
+other = "Смерницама за допринос"
+
+# Feedback
+[feedback_title]
+other = "Feedback"
+[feedback_question]
+other = "Да ли вам је ова страница била од помоћи?"
+[feedback_positive]
+other = "Да"
+[feedback_negative]
+other = "Не"

i18n/sr-latn.toml

@@ -0,0 +1,90 @@
+# UI strings. Buttons and similar.
+
+[ui_pager_prev]
+other = "Prethodno"
+
+[ui_pager_next]
+other = "Naredno"
+
+[ui_read_more]
+other = "Pročitajte više"
+
+[ui_search]
+other = "Pretražite sajt…"
+
+# Used in sentences such as "Posted in News"
+[ui_in]
+other = "u"
+
+# Used in sentences such as "All Tags"
+[ui_all]
+other = "sve"
+
+# Footer text
+[footer_all_rights_reserved]
+other = "Sva prava zadržana"
+
+[footer_privacy_policy]
+other = "Politika privatnosti"
+
+# Post (blog, articles etc.)
+[post_byline_by]
+other = "Autor"
+[post_created]
+other = "Kreirano"
+[post_last_mod]
+other = "Poslednji put izmenjeno"
+[post_edit_this]
+other = "Uredite ovu stranicu"
+[post_view_this]
+other = "Pogledajte izvor stranice"
+[post_create_child_page]
+other = "Kreirajte podstranicu"
+[post_create_issue]
+other = "Kreirajte issue za dokumentaciju"
+[post_create_project_issue]
+other = "Kreirajte issue za projekat"
+[post_posts_in]
+other = "Objava u"
+[post_reading_time]
+other = "minuta za čitanje"
+[post_less_than_a_minute_read]
+other = "manje od minuta za čitanje"
+
+# Print support
+[print_printable_section]
+other = "Ovo je višestrani pregled za štampanje ove sekcije."
+[print_click_to_print]
+other = "Kliknite ovde za štampanje"
+[print_show_regular]
+other = "Povratak na običan pregled ove stranice"
+[print_entire_section]
+other = "Odštampajte čitavu sekciju"
+
+# Community
+[community_join]
+other = "Pridružite se {{ .Site.Title }} zajednici"
+[community_introduce]
+other = "{{ .Site.Title }} je open source projekat kojeg svako u zajednici može da koristi, unapređuje i da uživa u njemu. Voleli bismo da nam se pridružite! Ovde se možete uključiti kako biste saznali šta se dešava."
+[community_learn]
+other = "Naučite i povežite se"
+[community_using]
+other = "Već koristite ili želite da počnete koristiti {{ .Site.Title }}? Saznajte više:"
+[community_develop]
+other = "Razvoj i doprinos"
+[community_contribute]
+other = "Ako želite da se više uključite u doprinos na {{ .Site.Title }}, pridružite nam se:"
+[community_how_to]
+other = "Možete saznati kako da doprinesete na {{ .Site.Title }} u našim"
+[community_guideline]
+other = "Smernicama za doprinos"
+
+# Feedback
+[feedback_title]
+other = "Feedback"
+[feedback_question]
+other = "Da li vam je ova stranica bila od pomoći?"
+[feedback_positive]
+other = "Da"
+[feedback_negative]
+other = "Ne"

i18n/tr.toml

@@ -1,5 +1,3 @@
-
-
 # UI strings. Buttons and similar.
 
 [ui_pager_prev]
@@ -18,14 +16,17 @@ other = "Bu sitede arayın…"
 [ui_in]
 other = "içinde"
 
+# Used in sentences such as "All Tags"
+[ui_all]
+other = "tüm"
+
 # Footer text
 [footer_all_rights_reserved]
-other = "Bütün haklar saklıdır"
+other = "Tüm Hakları Saklıdır"
 
 [footer_privacy_policy]
 other = "Gizlilik Politikası"
 
-
 # Post (blog, articles etc.)
 [post_byline_by]
 other = "by"
@@ -35,6 +36,8 @@ other = "Oluşturuldu"
 other = "Son düzenleme"
 [post_edit_this]
 other = "Bu sayfayı düzenle"
+[post_view_this]
+other = "Sayfa kaynağını görüntüle"
 [post_create_child_page]
 other = "Çocuk sayfası oluştur"
 [post_create_issue]
@@ -46,7 +49,7 @@ other = "Gönderiler in"
 [post_reading_time]
 other = "minute read"
 [post_less_than_a_minute_read]
-other = "less than a minute"
+other = "1 dakikadan az"
 
 # Print support
 [print_printable_section]
@@ -60,18 +63,28 @@ other = "Bütün bölümü yazıdırın"
 
 # Community
 [community_join]
-other = "Join the {{ .Site.Title }} community"
+other = "{{ .Site.Title }} topluluğuna katılın"
 [community_introduce]
-other = "{{ .Site.Title }} is an open source project that anyone in the community can use, improve, and enjoy. We'd love you to join us! Here's a few ways to find out what's happening and get involved."
+other = "{{ .Site.Title }} topluluktaki herkesin kullanabileceği, geliştirebileceği ve keyfini çıkarabileceği açık kaynaklı bir projedir. Bize katılmanızı çok isteriz! İşte neler olduğunu öğrenmenin ve dahil olmanın birkaç yolu."
 [community_learn]
-other = "Learn and Connect"
+other = "Öğrenin ve Bağlanın"
 [community_using]
-other = "Using or want to use {{ .Site.Title }}? Find out more here:"
+other = "{{ .Site.Title }} kullanıyor veya kullanmak mı istiyorsunuz? Daha fazlasını burada bulabilirsiniz:"
 [community_develop]
-other = "Develop and Contribute"
+other = "Geliştirin ve Katkıda Bulunun"
 [community_contribute]
 other = "If you want to get more involved by contributing to {{ .Site.Title }}, join us here:"
 [community_how_to]
 other = "You can find out how to contribute to {{ .Site.Title }} in our"
 [community_guideline]
-other = "Contribution Guidelines"
+other = "Katkı Yönergeleri"
+
+# Feedback
+[feedback_title]
+other = "Geribildirim"
+[feedback_question]
+other = "Bu sayfa yararlı oldu mu?"
+[feedback_positive]
+other = "Evet"
+[feedback_negative]
+other = "Hayır"

i18n/uk.toml

@@ -7,7 +7,7 @@ other = "Попередня"
 other = "Наступна"
 
 [ui_read_more]
-other = "Детальніше"
+other = "Читати далі"
 
 [ui_search]
 other = "Пошук по сайту…"
@@ -18,64 +18,73 @@ other = "у"
 
 # Used in sentences such as "All Tags"
 [ui_all]
-other = "все"
+other = "всі"
 
 # Footer text
 [footer_all_rights_reserved]
-other = "Усі права захищені"
+other = "Усі права захищено"
 
 [footer_privacy_policy]
 other = "Політика конфіденційності"
 
-
 # Post (blog, articles etc.)
 [post_byline_by]
 other = "Автор"
 [post_created]
 other = "Створено"
 [post_last_mod]
-other = "Змінено"
+other = "Востаннє змінено"
 [post_edit_this]
-other = "Відредагувати сторінку"
+other = "Редагувати цю сторінку"
 [post_view_this]
-other = "Побачити джерело сторінки"
+other = "Переглянути джерело сторінки"
 [post_create_child_page]
-other = "Створити додаткову сторінку"
+other = "Створити дочірню сторінку"
 [post_create_issue]
-other = "Запропонувати змінення документації"
+other = "Створити запит щодо документації"
 [post_create_project_issue]
-other = "Запропонувати допрацювання по проекту"
+other = "Створити запит щодо проєкту"
 [post_posts_in]
-other = "Публикації у"
+other = "Публікації в"
 [post_reading_time]
-other = "хвилина читання"
+other = "хв. читання"
 [post_less_than_a_minute_read]
 other = "менше хвилини"
 
 # Print support
 [print_printable_section]
-other = "Це багатосторінковий друкований вигляд цього розділу."
+other = "Це багатосторінкова версія цього розділу для друку."
 [print_click_to_print]
-other = "Натисність щоб друкувати"
+other = "Натисніть тут, щоб надрукувати"
 [print_show_regular]
 other = "Повернутися до звичайного перегляду сторінки"
 [print_entire_section]
-other = "Друкувати увесь розділ"
+other = "Надрукувати весь розділ"
 
 # Community
 [community_join]
-other = "Приєднуйтесь до {{ .Site.Title }} спільноти"
+other = "Приєднуйтесь до спільноти {{ .Site.Title }}"
 [community_introduce]
-other = "{{ .Site.Title }} - це проект з відкритим кодом, який будь-хто в спільноті може використовувати, покращувати та насолоджуватися. Ми будемо раді бачити тебе з нами! Ось декілька опцій щоб знати що відбувається та залучитись."
+other = "{{ .Site.Title }} — це проєкт з відкритим вихідним кодом, яким будь-хто зі спільноти може користуватися, покращувати та насолоджуватися. Ми будемо раді, якщо ви приєднаєтеся до нас! Ось кілька способів дізнатися, що відбувається, і взяти участь."
 [community_learn]
-other = "Вивчай та Приєднуйся"
+other = "Вивчайте та приєднуйтесь"
 [community_using]
-other = "Користуєшся чи хотів би користуватись {{ .Site.Title }}? Дізнайся більше тут:"
+other = "Використовуєте або хочете використовувати {{ .Site.Title }}? Дізнайтеся більше тут:"
 [community_develop]
-other = "Розвивай та Роби внесок"
+other = "Розробляйте та робіть внески"
 [community_contribute]
-other = "Якщо хочеш бути більш залученим, роблячи внесок у {{ .Site.Title }}, приєднуйся до нас тут:"
+other = "Хочете долучитися до розвитку {{ .Site.Title }} та зробити свій внесок? Приєднуйтеся до нас тут:"
 [community_how_to]
-other = "Дізнайся як зробити внесок до цих документів в нашому"
+other = "Дізнайтеся, як зробити внесок у {{ .Site.Title }} у наших"
 [community_guideline]
-other = "Рекомендації щодо внеску"
+other = "Настановах з внесків"
+
+# Feedback
+[feedback_title]
+other = "Зворотний зв’язок"
+[feedback_question]
+other = "Чи була ця сторінка корисною?"
+[feedback_positive]
+other = "Так"
+[feedback_negative]
+other = "Ні"

i18n/zh-tw.toml

@@ -32,33 +32,33 @@ other = "隱私政策"
 [post_byline_by]
 other = "作者："
 [post_created]
-other = "創建"
+other = "建立"
 [post_last_mod]
-other = "最後修改"
+other = "最後更新於"
 [post_edit_this]
 other = "編輯此頁"
 [post_view_this]
-other = "查看頁面原始碼"
+other = "檢視頁面原始碼"
 [post_create_child_page]
-other = "創建子頁面"
+other = "建立子頁面"
 [post_create_issue]
-other = "創建文檔議題"
+other = "建立文件議題"
 [post_create_project_issue]
-other = "創建項目議題"
+other = "建立專案議題"
 [post_posts_in]
 other = "張貼於"
 [post_reading_time]
-other = " 分鐘左右可讀完"
+other = " 分鐘閱讀時間"
 [post_less_than_a_minute_read]
 other = "1 分鐘內可讀完"
 
 # Print support
 [print_printable_section]
-other = "這是本節的多頁可列印視圖。"
+other = "這是本節的多頁可列印檢視。"
 [print_click_to_print]
-other = "點擊此處列印"
+other = "點選此處列印"
 [print_show_regular]
-other = "返回此頁面的常規視圖"
+other = "返回此頁面的標準檢視"
 [print_entire_section]
 other = "列印整個章節"
 
@@ -66,16 +66,26 @@ other = "列印整個章節"
 [community_join]
 other = "加入 {{ .Site.Title }} 社群"
 [community_introduce]
-other = "{{ .Site.Title }} 是一個開源項目，社群中的任何人都可以使用、改善和盡情使用它。我們很期待你能加入我們！下面是如何查看最近更新以及參與我們的一些方式。"
+other = "{{ .Site.Title }} 是一個開放原始碼專案，社群中的任何人都可以使用、改進並享受其成果。我們非常歡迎您加入我們！以下是了解最新動態以及參與我們的一些方式。"
 [community_learn]
-other = "學習和溝通"
+other = "學習與交流"
 [community_using]
-other = "正在或打算使用 {{ .Site.Title }} ？獲取更多資訊："
+other = "正在或打算使用 {{ .Site.Title }} 嗎？在此取得更多資訊："
 [community_develop]
 other = "開發和貢獻"
 [community_contribute]
-other = "如果你想通過為 {{ .Site.Title }} 貢獻更多參與，請在此處加入我們："
+other = "如果您想透過貢獻來更深入地參與 {{ .Site.Title }}，請在此處加入我們："
 [community_how_to]
-other = "你可以了解如何為 {{ .Site.Title }} 做出貢獻，請參考我們的"
+other = "您可以透過文件了解如何為 {{ .Site.Title }} 做出貢獻，請參考我們的"
 [community_guideline]
 other = "貢獻指南"
+
+# Feedback
+[feedback_title]
+other = "意見回饋"
+[feedback_question]
+other = "這個頁面對您有幫助嗎？"
+[feedback_positive]
+other = "有幫助"
+[feedback_negative]
+other = "沒幫助"

layouts/_default/list.rss.xml

@@ -1,43 +0,0 @@
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-  <channel>
-    <title>{{ .Site.Title }} – {{ .Title }}</title>
-    <link>{{ .Permalink }}</link>
-    <description>Recent content {{ if ne  .Title  .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description>
-    <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
-    <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
-    <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
-    <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
-    <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
-    <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
-    {{ with .OutputFormats.Get "RSS" }}
-	  {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
-    {{ end }}
-    {{ if not $.Section }}
-      {{ $sections := .Site.Params.rss_sections | default (slice "blog") }}
-      {{ .Scratch.Set "rss_pages" (first 50 (where $.Site.RegularPages "Type" "in" $sections )) }}
-    {{ else }}
-      {{ if $.Parent.IsHome }}
-        {{ .Scratch.Set "rss_pages" (first 50 (where $.Site.RegularPages "Type" $.Section )) }}
-      {{ else }}
-        {{ .Scratch.Set "rss_pages" (first 50 $.Pages) }}
-      {{ end }}
-    {{ end }}
-    {{ range (.Scratch.Get "rss_pages")  }}
-    <item>
-      <title>{{ .Section | title }}: {{ .Title }}</title>
-      <link>{{ .Permalink }}</link>
-      <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
-      {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
-      <guid>{{ .Permalink }}</guid>
-      <description>
-        {{ $img := (.Resources.ByType "image").GetMatch "*featured*" }}
-        {{ with $img }}
-        {{ $img := .Resize "640x" }}
-        {{ printf "<![CDATA[<img src=\"%s\" width=\"%d\" height=\"%d\"/>]]>" $img.Permalink $img.Width $img.Height | safeHTML }}
-        {{ end }}
-        {{ .Content | html }}
-      </description>
-    </item>
-    {{ end }}
-  </channel>
-</rss>

layouts/_default/single.html

@@ -1,3 +0,0 @@
-{{ define "main" -}}
-{{ .Content -}}
-{{ end }}

layouts/_internal/google_analytics_gtag.html

@@ -1,42 +0,0 @@
-{{/*
-
-  This is a modified copy of
-
-  https://github.com/gohugoio/hugo/blob/master/tpl/tplimpl/embedded/templates/google_analytics.html,
-
-  specifically this version:
-
-  https://github.com/gohugoio/hugo/blob/f7e00c039ff3cea5f991b05c1e325666004cf129/tpl/tplimpl/embedded/templates/google_analytics.html
-
-  The only differences between this copy and the original are that we've dropped:
-
-  - The `{{ if hasPrefix . "G-"}}` condition
-  - The `{{ else }}` block
-  - The `anonymize_ip` argument to the `gtag()` call, since it is superfluous.
-    For details, see https://github.com/gohugoio/hugo/issues/10093.
-
-*/}}
-
-{{- $pc := .Site.Config.Privacy.GoogleAnalytics -}}
-{{- if not $pc.Disable }}{{ with .Site.GoogleAnalytics -}}
-<script async src="https://www.googletagmanager.com/gtag/js?id={{ . }}"></script>
-<script>
-{{ template "__ga_js_set_doNotTrack" $ }}
-if (!doNotTrack) {
-	window.dataLayer = window.dataLayer || [];
-	function gtag(){dataLayer.push(arguments);}
-	gtag('js', new Date());
-	gtag('config', '{{ . }}');
-}
-</script>
-{{- end }}{{ end -}}
-
-{{- define "__ga_js_set_doNotTrack" -}}{{/* This is also used in the async version. */}}
-{{- $pc := .Site.Config.Privacy.GoogleAnalytics -}}
-{{- if not $pc.RespectDoNotTrack -}}
-var doNotTrack = false;
-{{- else -}}
-var dnt = (navigator.doNotTrack || window.doNotTrack || navigator.msDoNotTrack);
-var doNotTrack = (dnt == "1" || dnt == "yes");
-{{- end -}}
-{{- end -}}

layouts/_partials/community_links.html

@@ -1,4 +1,5 @@
 {{ $links := .Site.Params.links -}}
+{{ $contribUrl := .Params.contributingUrl | default "docs/contribution-guidelines" -}}
 
 <section class="row td-box td-box--white td-box--height-auto linkbox">
   <div class="col-xs-12 col-sm-6 col-md-6 col-lg-6">
@@ -16,7 +17,7 @@
     {{ end }}
     <p>
       {{ T "community_how_to" . }}
-      <a href="{{ "docs/contribution-guidelines" | relURL }}">{{ T "community_guideline" }}</a>.
+      <a href="{{ $contribUrl | relURL }}">{{ T "community_guideline" }}</a>.
     </p>
   </div>
 </section>

layouts/_partials/disqus-comment.html

@@ -14,7 +14,7 @@ this.page.identifier = PAGE_IDENTIFIER; // Replace PAGE_IDENTIFIER with your pag
 */
 (function() { // DON'T EDIT BELOW THIS LINE
 var d = document, s = d.createElement('script');
-s.src = 'https://' + {{ .Site.DisqusShortname }} + '.disqus.com/embed.js';
+s.src = 'https://' + {{ .Site.Config.Services.Disqus.Shortname }} + '.disqus.com/embed.js';
 s.setAttribute('data-timestamp', +new Date());
 (d.head || d.body).appendChild(s);
 })();

layouts/_partials/featured-image.html

@@ -8,7 +8,7 @@
 <figure class="{{ $class }}" style="width: {{ $image.Width }}px">
 <img src="{{ $image.RelPermalink }}" alt="Featured Image for {{ $p.Title }}" width="{{ $image.Width }}" height="{{ $image.Height }}">
 {{ with $image.Params.byline }}
- <figcaption class="mt-2 mt-md-0"><small class="text-muted">{{ . | html }}</small></figcaption>
+ <figcaption class="mt-2 mt-md-0"><small class="text-body-secondary">{{ . | html }}</small></figcaption>
 {{ end }}
 </figure>
 {{ end }}

layouts/_partials/footer.html

@@ -0,0 +1,17 @@
+<footer class="td-footer row d-print-none">
+  <div class="container-fluid">
+    <div class="row mx-md-2">
+      <div class="td-footer__left col-6 col-sm-4 order-sm-1">
+        {{ partial "footer/left.html"  . }}
+      </div>
+      {{- /* Trim WS */ -}}
+      <div class="td-footer__right col-6 col-sm-4 order-sm-3">
+        {{ partial "footer/right.html"  . }}
+      </div>
+      {{- /* Trim WS */ -}}
+      <div class="td-footer__center col-12 col-sm-4 py-2 order-sm-2">
+        {{ partial "footer/center.html"  . }}
+      </div>
+    </div>
+  </div>
+</footer>

layouts/_partials/footer/center.html

@@ -0,0 +1,15 @@
+{{ partial "footer/copyright.html"  . -}}
+
+{{ with .Site.Params.privacy_policy -}}
+  <span class="ms-2"><a href="{{ . }}" target="_blank" rel="noopener">{{ T "footer_privacy_policy" }}</a></span>
+{{- end -}}
+
+{{ if ne .Site.Params.ui.footer_about_disable nil -}}
+  {{ warnf "Config parameter '.params.ui.footer_about_disable' is DEPRECATED, use '.params.ui.footer_about_enable' instead." -}}
+{{ end -}}
+
+{{ if or .Site.Params.ui.footer_about_enable (eq .Site.Params.ui.footer_about_disable false) -}}
+  {{ with .Site.GetPage "about" -}}
+    <p class="td-footer__about mt-2"><a href="{{ .RelPermalink }}">{{ .Title }}</a></p>
+  {{- end -}}
+{{ end -}}

layouts/_partials/footer/copyright.html

@@ -0,0 +1,42 @@
+{{ $page := .Page -}}
+{{ with .Site.Params.copyright -}}
+  {{ $fromYear := "" -}}
+  {{ $toYear := "" -}}
+  {{ $authors := "" -}}
+  {{ if reflect.IsMap . -}}
+    {{ $fromYear = .from_year -}}
+    {{ $toYear = .to_year -}}
+    {{ $authors = .authors -}}
+  {{ else -}}
+    {{ $authors = . -}}
+  {{ end -}}
+
+  <span class="td-footer__copyright">&copy;
+    {{ with $fromYear -}}
+      {{ . }}&ndash;
+    {{- end -}}
+    {{ $toYear | default now.Year }}
+    <span class="td-footer__authors">
+      {{- $authors
+            | default (printf "%s Authors" ($.Site.Title | default "Site"))
+            | $page.RenderString -}}
+    </span>
+    {{- /* Trim WS */ -}}
+  </span>
+
+  {{- with T "footer_all_rights_reserved" -}}
+    <span class="td-footer__all_rights_reserved">
+      {{- . -}}
+    </span>
+  {{- end }}
+
+{{- else -}}
+
+  {{ with .Site.Copyright -}}
+    {{/* For historical reasons we process this as HTML rather than markdown. */ -}}
+    <span class="td-footer__copyright">
+      {{- . | safeHTML -}}
+    </span>
+  {{- end -}}
+
+{{ end -}}

layouts/_partials/footer/left.html

@@ -0,0 +1,5 @@
+{{ with .Site.Params.links -}}
+  {{ with index . "user" -}}
+    {{- partial "footer/links.html"  . -}}
+  {{ end -}}
+{{ end -}}

layouts/_partials/footer/links.html

@@ -0,0 +1,9 @@
+<ul class="td-footer__links-list">
+  {{ range . }}
+  <li class="td-footer__links-item" data-bs-toggle="tooltip" title="{{ .name }}" aria-label="{{ .name }}">
+    <a target="_blank" rel="noopener" href="{{ .url }}" aria-label="{{ .name }}">
+      <i class="{{ .icon }}"></i>
+    </a>
+  </li>
+  {{ end }}
+</ul>

layouts/_partials/footer/right.html

@@ -0,0 +1,5 @@
+{{ with .Site.Params.links -}}
+  {{ with index . "developer" -}}
+    {{- partial "footer/links.html"  . -}}
+  {{ end -}}
+{{ end -}}

layouts/_partials/head-css.html

@@ -0,0 +1,30 @@
+{{ $scssMain := "scss/main.scss" -}}
+{{ $css := resources.Get $scssMain
+      | toCSS (dict "enableSourceMap" (not hugo.IsProduction)) -}}
+
+{{/* NOTE: we only apply `postCSS` in production or for RTL languages. This
+makes it snappier to develop in Chrome, but it may look sub-optimal in other
+browsers. */ -}}
+
+{{ if eq .Site.Language.LanguageDirection "rtl" -}}
+  {{ $css = $css
+      | postCSS (dict "use" "autoprefixer rtlcss" "noMap" true)
+      | resources.Copy (replace $scssMain "." ".rtl.") -}}
+{{ else if hugo.IsProduction -}}
+  {{ $css = $css | postCSS -}}
+{{ end -}}
+
+{{ if hugo.IsProduction -}}
+  {{ $css = $css | minify | fingerprint -}}
+  <link rel="preload" href="{{ $css.RelPermalink }}" as="style" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+{{ end -}}
+
+{{ with $css -}}
+  <link href="{{ .RelPermalink }}" rel="stylesheet"
+  {{- with .Data.Integrity }} integrity="{{ . }}" crossorigin="anonymous"{{ end -}}
+  >
+{{ else -}}
+  {{ errorf "Resource not found or error building CSS: %s" $scssMain -}}
+{{ end -}}
+
+{{- /**/ -}}

layouts/_partials/head.html

@@ -1,3 +1,4 @@
+{{/* cSpell:ignore docsearch opengraph outputformat */ -}}
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
 {{ range .AlternativeOutputFormats -}}
@@ -20,14 +21,14 @@
     {{ .Site.Title -}}
   {{ end -}}
 </title>
-<meta name="description" content="{{ template "partials/page-description.html" . }}">
-{{ template "_internal/opengraph.html" . -}}
-{{ template "_internal/schema.html" . -}}
-{{ template "_internal/twitter_cards.html" . -}}
-{{ partialCached "head-css.html" . "asdf" -}}
+<meta name="description" content="{{ partial "page-description.html" . }}">
+{{ partial "opengraph.html" . -}}
+{{ partial "schema.html" . -}}
+{{ partial "twitter_cards.html" . -}}
+{{ partialCached "head-css.html" . "head-css-cache-key" -}}
 <script
-  src="https://code.jquery.com/jquery-3.6.3.min.js"
-  integrity="sha512-STof4xm1wgkfm7heWqFJVn58Hm3EtS31XFaagaa8VMReCXAkQnJZ+jEy8PCC/iT18dFy95WcExNHFTqLyp72eQ=="
+  src="https://code.jquery.com/jquery-3.7.1.min.js"
+  integrity="sha512-v2CJ7UaYy4JwqLDIrZUI/4hqeoQieOmAZNXBeQyjo21dadnwR+8ZaIJVT8EE2iyI61OV8e6M8PP2/4hpQINQ/g=="
   crossorigin="anonymous"></script>
 {{ if .Site.Params.offlineSearch -}}
 <script defer
@@ -46,19 +47,14 @@
 
 {{/* To comply with GDPR, cookie consent scripts places in head-end must execute before Google Analytics is enabled */ -}}
 {{ if hugo.IsProduction -}}
-  {{ $enableGtagForUniversalAnalytics := not .Site.Params.disableGtagForUniversalAnalytics -}}
-  {{ if (or $enableGtagForUniversalAnalytics (hasPrefix .Site.GoogleAnalytics "G-")) -}}
-    {{ template "_internal/google_analytics_gtag.html" . -}}
-  {{ else -}}
-    {{ template "_internal/google_analytics_async.html" . -}}
-  {{ end -}}
+  {{ partial "google_analytics.html" . -}}
 {{ end -}}
 
 {{ define "algolia/head" -}}
 
 {{ if and .Site.Params.search (isset .Site.Params.search "algolia") -}}
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3.5.2"
-  integrity="sha512-TW5eKlwwg7OfQUVBqxjp94/uqtjJJbhkRE3++XGEQjAL1n3y//QVqS3acPkwqkzInaFRtj+w05uyxDbfDXiI1A=="
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3.8.2"
+  integrity="sha512-l7pkV1dOURFyHCeH8I4fK9lCkQKuqhlsTCqRl3zktifDlB8oTUJ+mJPgYkK9kHpUut8j1iPquTv32t6hvTPv3g=="
   crossorigin="anonymous" />
 {{ end -}}
 

layouts/_partials/navbar.html

@@ -4,8 +4,8 @@
 -}}
 {{ $baseURL := urls.Parse $.Site.Params.Baseurl -}}
 
-<nav class="td-navbar navbar-dark js-navbar-scroll
-            {{- if $cover }} td-navbar-cover {{- end }}">
+<nav class="td-navbar js-navbar-scroll
+            {{- if $cover }} td-navbar-cover {{- end }}" data-bs-theme="dark">
 <div class="container-fluid flex-column flex-md-row">
   <a class="navbar-brand" href="{{ .Site.Home.RelPermalink }}">
     {{- /**/ -}}
@@ -57,6 +57,11 @@
         {{ partial "navbar-lang-selector.html" . -}}
       </li>
       {{ end -}}
+      {{ if .Site.Params.ui.showLightDarkModeMenu -}}
+      <li class="td-light-dark-menu nav-item dropdown">
+        {{ partial "theme-toggler" . }}
+      </li>
+      {{ end -}}
     </ul>
   </div>
   <div class="d-none d-lg-block">

layouts/_partials/page-description.html

@@ -0,0 +1,3 @@
+{{ with or .Description .Summary site.Params.description | plainify | htmlUnescape -}}
+  {{ trim . "\n\r\t " -}}
+{{ end -}}

layouts/_partials/page-meta-lastmod.html

@@ -1,8 +1,8 @@
-{{ if and (.GitInfo) (.Site.Params.github_repo) -}}
-<div class="text-muted mt-5 pt-3 border-top">
+{{ if and .GitInfo .Site.Params.github_repo -}}
+<div class="td-page-meta__lastmod">
   {{ T "post_last_mod" }} {{ .Lastmod.Format .Site.Params.time_format_default -}}
   {{ with .GitInfo }}: {{/* Trim WS */ -}}
-    <a href="{{ $.Site.Params.github_repo }}/commit/{{ .Hash }}">
+    <a data-proofer-ignore href="{{ $.Site.Params.github_repo }}/commit/{{ .Hash }}">
       {{- .Subject }} ({{ .AbbreviatedHash }}) {{- /* Trim WS */ -}}
     </a>
   {{- end }}

layouts/_partials/page-meta-links.html

@@ -0,0 +1,52 @@
+{{/* cSpell:ignore querify subdir */ -}}
+{{/* Class names ending with `--KIND` are deprecated in favor of `__KIND`, but we're keeping them for a few releases after 0.9.0 */ -}}
+
+{{ if .File -}}
+{{ $path := strings.TrimPrefix (add hugo.WorkingDir "/") $.File.Filename -}}
+{{ $gh_repo := $.Param "github_repo" -}}
+{{ $gh_url := $.Param "github_url" -}}
+{{ $gh_subdir := $.Param "github_subdir" | default "" -}}
+{{ $gh_project_repo := $.Param "github_project_repo" -}}
+{{ $gh_branch := $.Param "github_branch" | default "main" -}}
+<div class="td-page-meta ms-2 pb-1 pt-2 mb-0">
+{{ if $gh_url -}}
+  {{ warnf "Warning: use of `github_url` is deprecated. For details, see https://www.docsy.dev/docs/adding-content/repository-links/#github_url-optional" -}}
+  <a href="{{ $gh_url }}" target="_blank"><i class="fa-solid fa-pen-to-square fa-fw"></i> {{ T "post_edit_this" }}</a>
+{{ else if $gh_repo -}}
+
+  {{/* Adjust $path based on path_base_for_github_subdir */ -}}
+  {{ $ghs_base := $.Param "path_base_for_github_subdir" -}}
+  {{ $ghs_rename := "" -}}
+  {{ if reflect.IsMap $ghs_base -}}
+    {{ $ghs_rename = $ghs_base.to -}}
+    {{ $ghs_base = $ghs_base.from -}}
+  {{ end -}}
+  {{ with $ghs_base -}}
+    {{ $path = replaceRE . $ghs_rename $path -}}
+  {{ end -}}
+
+  {{ $gh_repo_path := printf "%s/%s/%s" $gh_branch $gh_subdir $path -}}
+  {{ $gh_repo_path = replaceRE "//+" "/" $gh_repo_path -}}
+
+  {{ $viewURL := printf "%s/tree/%s" $gh_repo $gh_repo_path -}}
+  {{ $editURL := printf "%s/edit/%s" $gh_repo $gh_repo_path -}}
+  {{ $issuesURL := printf "%s/issues/new?title=%s" $gh_repo (safeURL $.Title ) -}}
+  {{ $newPageStub := resources.Get "stubs/new-page-template.md" -}}
+  {{ $newPageQS := querify "value" $newPageStub.Content "filename" "change-me.md" | safeURL -}}
+  {{ $newPageURL := printf "%s/new/%s?%s" $gh_repo (path.Dir $gh_repo_path) $newPageQS -}}
+
+  <a href="{{ $viewURL }}" class="td-page-meta--view td-page-meta__view" target="_blank" rel="noopener"><i class="fa-solid fa-file-lines fa-fw"></i> {{ T "post_view_this" }}</a>
+  <a href="{{ $editURL }}" class="td-page-meta--edit td-page-meta__edit" target="_blank" rel="noopener"><i class="fa-solid fa-pen-to-square fa-fw"></i> {{ T "post_edit_this" }}</a>
+  <a href="{{ $newPageURL }}" class="td-page-meta--child td-page-meta__child" target="_blank" rel="noopener"><i class="fa-solid fa-pen-to-square fa-fw"></i> {{ T "post_create_child_page" }}</a>
+  <a href="{{ $issuesURL }}" class="td-page-meta--issue td-page-meta__issue" target="_blank" rel="noopener"><i class="fa-solid fa-list-check fa-fw"></i> {{ T "post_create_issue" }}</a>
+  {{ with $gh_project_repo -}}
+    {{ $project_issueURL := printf "%s/issues/new" . -}}
+    <a href="{{ $project_issueURL }}" class="td-page-meta--project td-page-meta__project-issue" target="_blank" rel="noopener"><i class="fa-solid fa-list-check fa-fw"></i> {{ T "post_create_project_issue" }}</a>
+  {{ end -}}
+
+{{ end -}}
+{{ with .CurrentSection.AlternativeOutputFormats.Get "print" -}}
+  <a id="print" href="{{ .RelPermalink | safeURL }}"><i class="fa-solid fa-print fa-fw"></i> {{ T "print_entire_section" }}</a>
+{{ end }}
+</div>
+{{ end -}}

layouts/_partials/print/content-blog.html

@@ -6,7 +6,7 @@
 	<div class="td-byline mb-4">
 		{{ with .Params.author }}{{ T "post_byline_by" }} <b>{{ . | markdownify }}</b> |{{ end}}
         {{if .Date }}
-		<time datetime="{{  .Date.Format "2006-01-02" }}" class="text-muted">{{ .Date.Format .Site.Params.time_format_blog  }}</time>
+		<time datetime="{{  .Date.Format "2006-01-02" }}" class="text-body-secondary">{{ .Date.Format .Site.Params.time_format_blog  }}</time>
         {{ end }}
 	</div>
 	{{ .Content }}

layouts/_partials/print/content.html

@@ -1,6 +1,6 @@
 {{ $tpl := printf "print/content-%s.html" .Page.Type }}
 
-{{ if templates.Exists (printf "partials/%s" $tpl) }}
+{{ if templates.Exists (printf "_partials/%s" $tpl) }}
   {{ partial $tpl . }}
 {{ else -}}
 {{ $break := cond .DoPageBreak "page-break-before: always" "" -}}

layouts/_partials/print/page-heading.html

@@ -1,7 +1,7 @@
 {{/* Use the title and description of the first page to begin the document */}}
 
 {{ $tpl := printf "print/page-heading-%s.html" .Page.Type }}
-{{ if templates.Exists (printf "partials/%s" $tpl) }}
+{{ if templates.Exists (printf "_partials/%s" $tpl) }}
   {{ partial $tpl . }}
 {{ else -}}
 <h1 class="title">{{ .Title }}</h1>