truesight-rtd-theme 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0666f2560ad9a9f414dfec56cfc8dd318849509c290f5bbb8d0fe039a3e02ee1
+  data.tar.gz: b71ae3787b0e508348e58e95219bc4dae2854aa05cc5c80a20055a5d6842e27f
+SHA512:
+  metadata.gz: 245a9cdf79293d55cda00f29e4ff84fd3400d5dada9ba78a92fa069aba4dd1cca12f17225ce13b4f028da03dd0c91297a9fabe14aba4b895379029cdd2903eb2
+  data.tar.gz: 70c02d5ae9cd1d5fd064464854c5f08e51c6a42e3152102e98fe5666121386a32a3476dddb6beb36d7be81f89bcf49e076bbf2eaee94fafdd489d690da3e41cf

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 RunDocs & contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,100 @@
+# jekyll-rtd-theme
+
+![CI](https://github.com/rundocs/jekyll-rtd-theme/workflows/CI/badge.svg?branch=develop)
+![jsDelivr](https://data.jsdelivr.com/v1/package/gh/rundocs/jekyll-rtd-theme/badge)
+
+Just another documentation theme compatible with GitHub Pages
+
+## What it does?
+
+This theme is inspired by [sphinx-rtd-theme](https://github.com/readthedocs/sphinx_rtd_theme) and refactored with:
+
+- [@primer/css](https://github.com/primer/css)
+- [github-pages](https://github.com/github/pages-gem) ([dependency versions](https://pages.github.com/versions/))
+
+## Quick start
+
+```yml
+remote_theme: rundocs/jekyll-rtd-theme
+```
+
+You can [generate](https://github.com/rundocs/starter-slim/generate) with the same files and folders from [rundocs/starter-slim](https://github.com/rundocs/starter-slim/)
+
+## Usage
+
+Documentation that can guide how to create with Github pages, please refer to [rundocs.io](https://rundocs.io) for details
+
+## Features
+
+- Shortcodes (Toasts card, mermaid)
+- Pages Plugins (emoji, gist, avatar, mentions)
+- Auto generate sidebar
+- [Attribute List Definitions](https://kramdown.gettalong.org/syntax.html#attribute-list-definitions) (Primer/css utilities, Font Awesome 4)
+- Service worker (caches)
+- SEO (404, robots.txt, sitemap.xml)
+- Canonical Link (Open Graph, Twitter Card, Schema data)
+
+## Options
+
+| name          | default value        | description       |
+| ------------- | -------------------- | ----------------- |
+| `title`       | repo name            |                   |
+| `description` | repo description     |                   |
+| `url`         | user domain or cname |                   |
+| `baseurl`     | repo name            |                   |
+| `lang`        | `en`                 |                   |
+| `direction`   | `auto`               | `ltr` or `rtl`    |
+| `highlighter` | `rouge`              | Cannot be changed |
+
+```yml
+# folders sort
+readme_index:
+  with_frontmatter: true
+
+meta:
+  key1: value1
+  key2: value2
+  .
+  .
+  .
+
+google:
+  gtag:
+  adsense:
+
+mathjax: # this will prased to json, default: {}
+
+mermaid:
+  custom:     # mermaid link
+  initialize: # this will prased to json, default: {}
+
+scss:   # also _includes/extra/styles.scss
+script: # also _includes/extra/script.js
+
+translate:
+  # shortcodes
+  danger:
+  note:
+  tip:
+  warning:
+  # 404
+  not_found:
+  # copyright
+  revision:
+  # search
+  searching:
+  search:
+  search_docs:
+  search_results:
+  search_results_found: # the "#" in this translate will replaced with results size!
+  search_results_not_found:
+
+plugins:
+  - jemoji
+  - jekyll-avatar
+  - jekyll-mentions
+```
+
+## The license
+
+The theme is available as open source under the terms of the MIT License

data/_includes/README.md

@@ -0,0 +1,9 @@
+# Document Statement
+
+## templates
+
+Template files for this theme
+
+## common
+
+Some common variables and code snippets are designed to be shared by multiple themes

data/_includes/common/assets/data.liquid

@@ -0,0 +1,3 @@
+{%- include common/rest/site_pages.liquid -%}
+
+{{- site_pages | jsonify -}}

data/_includes/common/assets/robots.liquid

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: {{ "sitemap.xml" | absolute_url }}

data/_includes/common/assets/sitemap.liquid

@@ -0,0 +1,12 @@
+{%- include common/rest/site_pages.liquid -%}
+
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+    {%- for page in site_pages -%}
+        <url>
+            <loc>{{ page.url | absolute_url | xml_escape }}</loc>
+            <priority>{{ page.content | size | divided_by: 2048.0 | times: 10 | ceil | divided_by: 10.0 | at_least: 0.1 | at_most: 1.0 }}</priority>
+            <lastmod>{{ site.time | date_to_xmlschema }}</lastmod>
+        </url>
+    {%- endfor %}
+</urlset>

data/_includes/common/assets/sw.caches.js

@@ -0,0 +1,39 @@
+self.addEventListener("activate", function (event) {
+  const current = ["{{ theme_alias }}"];
+
+  event.waitUntil(
+    caches.keys().then(function (keyList) {
+      return Promise.all(
+        keyList.map(function (key) {
+          if (current.indexOf(key) === -1) {
+            return caches.delete(key);
+          }
+        })
+      );
+    })
+  );
+});
+
+self.addEventListener("fetch", function (e) {
+  if (e.request.url.match("{{ theme_alias }}")) {
+    e.respondWith(
+      caches.match(e.request).then(function (resp) {
+        if (resp !== undefined) {
+          return resp;
+        } else {
+          return fetch(e.request, {
+            cache: "no-store",
+          })
+            .then(function (resp) {
+              let clone = resp.clone();
+              caches.open("{{ theme_alias }}").then(function (cache) {
+                cache.put(e.request, clone);
+              });
+              return resp;
+            })
+            .catch(console.log);
+        }
+      })
+    );
+  }
+});

data/_includes/common/core/_list.liquid

@@ -0,0 +1,15 @@
+{%- include common/rest/site_pages.liquid -%}
+{%- include common/rest/workdir.liquid -%}
+
+{%- assign base = page.dir | append: "temp/" | split: "/" | size -%}
+{%- assign size = workdir_level | minus: base -%}
+{%- assign size_p1 = size | plus: 1 -%}
+
+{%- assign dir = site_pages | where: "url", workdir | first %}
+{% include common/rest/tabs.liquid size=size %}- [{{ dir.title | default: dir.url }}]({{ dir.url | relative_url }})
+
+{%- for item in workdir_files %}
+{% include common/rest/tabs.liquid size=size_p1 %}- [{{ item.title | default: item.name }}]({{ item.url | relative_url }})
+{%- endfor -%}
+
+{%- for workdir in workdir_dirs %}{% include common/core/_list.liquid %}{% endfor -%}

data/_includes/common/core/list.liquid

@@ -0,0 +1,10 @@
+{%- include common/rest/site_pages.liquid -%}
+{%- include common/rest/workdir.liquid workdir=page.dir -%}
+
+{%- for item in workdir_files %}
+- [{{ item.title | default: item.name }}]({{ item.url | relative_url }})
+{%- endfor -%}
+
+{%- if include.all -%}
+    {%- for workdir in workdir_dirs %}{% include common/core/_list.liquid %}{% endfor -%}
+{%- endif -%}

data/_includes/common/google_adsense.liquid

@@ -0,0 +1,3 @@
+{%- if site.google.adsense -%}
+    <script data-ad-client="{{ site.google.adsense }}" async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
+{%- endif -%}

data/_includes/common/google_gtag.liquid

@@ -0,0 +1,11 @@
+{%- if site.google.gtag -%}
+    <script async src="https://www.googletagmanager.com/gtag/js?id={{ site.google.gtag }}"></script>
+    <script>
+        window.dataLayer = window.dataLayer || [];
+        function gtag() {
+            dataLayer.push(arguments);
+        }
+        gtag("js", new Date());
+        gtag("config", "{{ site.google.gtag }}");
+    </script>
+{%- endif -%}

data/_includes/common/links.liquid

@@ -0,0 +1,26 @@
+{%- comment %} dns-prefetch {% endcomment %}
+<link rel="dns-prefetch" href="https://cdn.jsdelivr.net">
+
+{%- comment %} canonical link {% endcomment -%}
+{%- if prev -%}
+    <link rel="prev" href="{{ prev.url | absolute_url }}">
+{%- endif -%}
+
+{%- if next -%}
+    <link rel="next" href="{{ next.url | absolute_url }}">
+{%- endif -%}
+
+<link rel="canonical" href="{{ schema_surl }}">
+
+{%- comment %} favicon icon {% endcomment -%}
+<link rel="icon" type="image/svg+xml" href="{{ site.baseurl }}/assets/images/favicon.svg">
+{%- comment %} alternate {% endcomment -%}
+<link rel="icon" type="image/png" href="{{ site.baseurl }}/assets/images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="{{ site.baseurl }}/assets/images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="{{ site.baseurl }}/assets/images/favicon-96x96.png" sizes="96x96">
+
+{%- comment %} safari {% endcomment -%}
+<link rel="mask-icon" href="{{ site.baseurl }}/assets/images/favicon.svg" color="{{ theme_color }}">
+
+{%- comment %} apple-touch-icon {% endcomment -%}
+<link rel="apple-touch-icon" href="{{ site.baseurl }}/assets/images/apple-touch-icon-300x300.jpg">

data/_includes/common/mathjax.liquid

@@ -0,0 +1,6 @@
+{%- if page.content contains "$$" -%}
+    <script>
+      window.MathJax = {% if site.mathjax %}{{ site.mathjax | jsonify }}{% else %}{}{% endif %};
+    </script>
+    <script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax/es5/tex-svg-full.js"></script>
+{%- endif %}

data/_includes/common/mermaid.liquid

@@ -0,0 +1,10 @@
+{%- if content contains '<code class="language-mermaid">' -%}
+    {%- if site.mermaid.custom -%}
+        <script src="{{ site.mermaid.custom }}"></script>
+    {%- else -%}
+        <script src="{{ base }}/assets/js/mermaid.min.js"></script>
+    {%- endif %}
+    <script>
+        mermaid.initialize({% if site.mermaid.initialize %}{{ site.mermaid.initialize | jsonify }}{% else %}{}{% endif %});
+    </script>
+{%- endif %}

data/_includes/common/metadata.liquid

@@ -0,0 +1,12 @@
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5, user-scalable=no">
+<meta name="description" content="{{ description }}">
+<meta name="revised" content="{{ docs.build_revision }}">
+<meta name="author" content="{{ author }}">
+<meta name="generator" content="{{ generator }} v{{ version }}">
+
+{%- for meta in site.meta -%}
+    <meta name="{{ meta.first }}" content="{{ meta.last }}">
+{%- endfor -%}
+
+<meta name="theme-color" content="{{ theme_color }}">

data/_includes/common/opengraph.liquid

@@ -0,0 +1,8 @@
+<meta property="og:title" content="{{ title }}">
+<meta property="og:description" content="{{ description }}">
+<meta property="og:locale" content="{{ lang }}">
+<meta property="og:url" content="{{ schema_surl }}">
+<meta property="og:type" content="article">
+<meta property="article:author" content="{{ author }}">
+<meta property="article:published_time" content="{{ schema_date }}">
+<meta property="article:modified_time" content="{{ schema_modi }}">

data/_includes/common/rest/content.liquid

@@ -0,0 +1,6 @@
+{%- assign content = content
+    | replace: "’", "'"
+    | replace: "“", '"'
+    | replace: "”", '"'
+    | replace: "<script", '<script async'
+    | replace: "highlighter-rouge", "highlighter-rouge notranslate" -%}

data/_includes/common/rest/defaults.liquid

@@ -0,0 +1,7 @@
+{%- include common/rest/site_pages.liquid -%}
+{%- include common/rest/i18n.liquid -%}
+{%- include common/rest/variables.liquid -%}
+{%- include common/rest/content.liquid -%}
+{%- include common/rest/nav.liquid -%}
+{%- include common/rest/title.liquid -%}
+{%- include common/rest/description.liquid -%}

data/_includes/common/rest/description.liquid

@@ -0,0 +1,6 @@
+{%- assign description = content
+    | strip_html
+    | split: " "
+    | join: " "
+    | escape
+    | truncate: 150 -%}

data/_includes/common/rest/i18n.liquid

@@ -0,0 +1 @@
+{%- assign __ = site.translate | default: site.data.translate -%}

data/_includes/common/rest/nav.liquid

@@ -0,0 +1,20 @@
+{%- include common/rest/workdir.liquid workdir=page.dir -%}
+
+{% comment %} prev and next {% endcomment %}
+{%- assign index = 0 -%}
+{%- for item in workdir_files %}
+    {%- if item.url == page.url %}
+        {%- assign index = forloop.index -%}
+    {%- endif %}
+{%- endfor -%}
+
+{%- for item in workdir_files -%}
+    {%- assign index_prev = index | minus: 1 -%}
+    {%- assign index_next = index | plus: 1 -%}
+    {%- if forloop.index == index_prev -%}
+        {%- assign prev = item -%}
+    {%- endif %}
+    {%- if forloop.index == index_next -%}
+        {%- assign next = item -%}
+    {%- endif %}
+{%- endfor -%}

data/_includes/common/rest/site_pages.liquid

@@ -0,0 +1,8 @@
+{%- assign site_pages = site.html_pages
+    | sort: "path"
+    | sort: "sort"
+    | where_exp: "item", "item.url != '/404.html'"
+    | where_exp: "item", "item.url != '/search.html'" -%}
+
+{%- assign site_dirs  = site_pages | where_exp: "item", "item.dir == item.url" -%}
+{%- assign site_files = site_pages | where_exp: "item", "item.dir != item.url" -%}

data/_includes/common/rest/tabs.liquid

@@ -0,0 +1,2 @@
+{%- assign tab = "    " -%}
+{%- for temp in (1..include.size) %}{{ tab }}{% endfor -%}

data/_includes/common/rest/title.liquid

@@ -0,0 +1,18 @@
+{%- case page.url -%}
+    {%- when "/" -%}
+        {%- assign title = site.title
+            | append: " · "
+            | append: site.description | truncate: 110 -%}
+    {%- when "/search.html" -%}
+        {%- assign title = __.search | default: "Search"
+            | append: " · "
+            | append: site.title | truncate: 110 -%}
+    {%- when "/404.html" -%}
+        {%- assign title = "404"
+            | append: " · "
+            | append: site.title | truncate: 110 -%}
+    {%- else -%}
+        {%- assign title = page.title | default: page.name
+            | append: " · "
+            | append: site.title | truncate: 110 -%}
+{%- endcase -%}

data/_includes/common/rest/variables.liquid

@@ -0,0 +1,41 @@
+{%- comment %} variables {% endcomment -%}
+{%- assign version = theme_alias | split: "@" | last -%}
+{%- assign docs = site.github -%}
+{%- assign rest = docs.public_repositories | where: "html_url", docs.repository_url | first -%}
+
+{%- assign rest_created_at = rest.created_at | default: site.time -%}
+{%- assign rest_updated_at = rest.updated_at | default: site.time -%}
+
+{%- comment %} defaults {% endcomment -%}
+{%- assign direction = site.direction | default: "auto" -%}
+{%- assign lang = site.lang | default: "en" -%}
+{%- assign author = docs.owner.name | default: docs.owner_name -%}
+
+{%- capture generator -%}
+    {%- if site.remote_theme -%}
+        {{- theme_alias | split: "@" | first -}}
+    {%- else -%}
+        {{- theme_alias | split: "@" | first | split: "/" | last -}}
+    {%- endif -%}
+{%- endcapture -%}
+
+{%- comment %} schema {% endcomment -%}
+{%- assign schema_date = page.date | default: rest_created_at | date_to_xmlschema -%}
+{%- assign schema_modi = site.time | date_to_xmlschema -%}
+{%- assign schema_surl = page.url  | absolute_url | xml_escape -%}
+
+{% comment %} debug {% endcomment %}
+{%- if site.debug -%}
+    {%- assign base = site.baseurl -%}
+{%- else -%}
+    {%- assign base = "https://cdn.jsdelivr.net/gh/" | append: theme_alias -%}
+{%- endif -%}
+
+{% comment %} extra {% endcomment %}
+{%- capture extra_scss -%}
+    {%- include extra/styles.scss -%} {{- site.scss -}}
+{%- endcapture -%}
+
+{%- capture extra_script -%}
+    {%- include extra/script.js -%} {{- site.script -}}
+{%- endcapture -%}

data/_includes/common/rest/workdir.liquid

@@ -0,0 +1,19 @@
+{%- assign workdir = include.workdir | default: "/" -%}
+
+{%- assign workdir_level = workdir | append: "temp" | replace_first: "/", "" | split: "/" | size -%}
+{%- assign workdir_files = site_files | where_exp: "item", "item.dir == workdir" -%}
+
+{%- capture items -%}
+    {%- for item in site_dirs -%}
+        {%- assign current_m1 = item.dir | append: "temp" | replace_first: "/", "" | split: "/" | size | minus: 1 -%}
+        {%- if workdir_level == current_m1 -%}
+            {%- assign temp = workdir | append: "@@" -%}
+            {%- assign dir = item.dir | replace: workdir, temp | split: "@@" | first -%}
+            {% comment %} In the current subdirectory {% endcomment %}
+            {%- if workdir == dir -%}
+                {{ item.dir }}|
+            {%- endif -%}
+        {%- endif -%}
+    {%- endfor -%}
+{%- endcapture -%}
+{%- assign workdir_dirs = items | split: "|" -%}

data/_includes/common/schema.liquid

@@ -0,0 +1,27 @@
+<script type="application/ld+json">
+    {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        "mainEntityOfPage": {
+            "@type": "WebPage",
+            "@id": "{{ schema_surl }}"
+        },
+        "headline": "{{ title }}",
+        "image": [{% for image in page.images %}"{{ image }}"{% unless forloop.last %},{% endunless %}{% endfor %}],
+        "author": {
+            "@type": "Person",
+            "name": "{{ author }}"
+        },
+        "datePublished": "{{ schema_date }}",
+        "dateModified": "{{ schema_modi }}",
+        "publisher": {
+            "@type": "{{ docs.owner.type }}",
+            "name": "{{ author }}",
+            "logo": {
+                "@type": "ImageObject",
+                "url": "{{ docs.owner.avatar_url }}"
+            }
+        },
+        "description": "{{ description }}"
+    }
+</script>

data/_includes/common/script.liquid

@@ -0,0 +1,11 @@
+<script>
+    window.ui = {
+        title: "{{ site.title }}",
+        baseurl: "{{ site.baseurl }}",
+        i18n: {
+            search_results: "{{ __.search_results | default: 'Search Results' }}",
+            search_results_found: "{{ __.search_results_found | default: 'Search finished, found # page(s) matching the search query.' }}",
+            search_results_not_found: "{{ __.search_results_not_found | default: 'Your search did not match any documents, please make sure that all characters are spelled correctly!' }}"
+        }
+    };
+</script>

data/_includes/common/title.liquid

@@ -0,0 +1 @@
+<title>{{ title }}</title>

data/_includes/common/twitter_cards.liquid

@@ -0,0 +1,6 @@
+<meta name="twitter:title" content="{{ title }}">
+<meta name="twitter:description" content="{{ description }}">
+<meta name="twitter:card" content="summary">
+<meta name="twitter:site" content="@{{ author }}">
+<meta name="twitter:url" content="{{ schema_surl }}">
+<meta name="twitter:creator" content="@{{ generator }} v{{ version }}">

data/_includes/list.liquid

@@ -0,0 +1 @@
+{%- include common/core/list.liquid -%}

data/_includes/rest/defaults.liquid

@@ -0,0 +1,2 @@
+{%- assign theme_alias = "rundocs/jekyll-rtd-theme@2.0.10" -%}
+{%- assign theme_color = "#2980b9" -%}

data/_includes/rest/script.liquid

@@ -0,0 +1,7 @@
+<script src="{{ base }}/assets/js/jquery.min.js"></script>
+
+{%- if extra_script.size > 0 -%}
+    <script>{{ extra_script }}</script>
+{%- endif -%}
+
+<script src="{{ base }}/assets/js/theme{% if site.debug.dist != false %}.min{% endif %}.js"></script>

data/_includes/rest/styles.liquid

@@ -0,0 +1,5 @@
+<link rel="stylesheet" href="{{ base }}/assets/css/theme{% if site.debug.dist != false %}.min{% endif %}.css">
+
+{%- if extra_scss.size > 0 -%}
+    <style>{{ extra_scss | scssify | strip_newlines }}</style>
+{%- endif -%}

data/_includes/shortcodes/danger.liquid

@@ -0,0 +1,9 @@
+<div class="toasts danger mb-4">
+    <div class="title px-2 py-1">
+        <i class="fa fa-exclamation-triangle"></i>
+        {{ __.danger | default: "Danger" }}
+    </div>
+    <div class="content px-2 py-3">
+        {{ codes | markdownify | strip_newlines -}}
+    </div>
+</div>

data/_includes/shortcodes/mermaid.liquid

@@ -0,0 +1,3 @@
+<div class="mermaid-wrap mb-4" data-lang="{{ codes | split: ' ' | first }}">
+    <div class="mermaid overflow-x-auto p-3">{{ codes }}</div>
+</div>

data/_includes/shortcodes/note.liquid

@@ -0,0 +1,9 @@
+<div class="toasts note mb-4">
+    <div class="title px-2 py-1">
+        <i class="fa fa-info-circle"></i>
+        {{ __.note | default: "Note" }}
+    </div>
+    <div class="content px-2 py-3">
+        {{ codes | markdownify | strip_newlines -}}
+    </div>
+</div>

data/_includes/shortcodes/tip.liquid

@@ -0,0 +1,9 @@
+<div class="toasts tip mb-4">
+    <div class="title px-2 py-1">
+        <i class="fa fa-check-circle"></i>
+        {{ __.tip | default: "Tip" }}
+    </div>
+    <div class="content px-2 py-3">
+        {{ codes | markdownify | strip_newlines -}}
+    </div>
+</div>

data/_includes/shortcodes/warning.liquid

@@ -0,0 +1,9 @@
+<div class="toasts warning mb-4">
+    <div class="title px-2 py-1">
+        <i class="fa fa-exclamation-circle"></i>
+        {{ __.warning | default: "Warning" }}
+    </div>
+    <div class="content px-2 py-3">
+        {{ codes | markdownify | strip_newlines -}}
+    </div>
+</div>

data/_includes/templates/_toctree.liquid

@@ -0,0 +1,41 @@
+{%- include common/rest/workdir.liquid %}
+
+{% comment %} display the directory name {% endcomment %}
+{%- assign dir = site_pages | where: "url", workdir | first -%}
+
+{%- if workdir_level == 2 %}
+    {% comment %} display the root sub-directory as "p.caption" {% endcomment %}
+    <a class="caption d-block text-uppercase no-wrap px-2 py-0" href="{{ dir.url | relative_url }}">
+        {{ dir.title | default: dir.url }}
+    </a>
+{%- else %}
+    <a class="d-flex flex-items-baseline" href="{{ dir.url | relative_url }}">
+        {{ dir.title | default: dir.url }}
+    </a>
+{%- endif -%}
+
+<ul>
+    {% comment %} list file {% endcomment %}
+    {%- for item in workdir_files -%}
+        {%- assign level = item.dir | append: "temp" | replace_first: "/", "" | split: "/" | size | minus: 1 -%}
+        {%- capture current -%}
+            {%- if page.url == item.url %}current{% endif -%}
+        {%- endcapture %}
+
+        <li class="toc level-{{ level }} {{ current }}" data-sort="{{ item.sort }}" data-level="{{ level }}">
+            <a class="d-flex flex-items-baseline {{ current }}" href="{{ item.url | relative_url }}">
+                {%- if item.sort -%}
+                    {{ item.sort }}. {{ item.title | default: item.name }}
+                {%- else -%}
+                    {{ item.title | default: item.name }}
+                {%- endif -%}
+            </a>
+        </li>
+    {%- endfor -%}
+
+    {% comment %} list dirs {% endcomment %}
+    {%- for workdir in workdir_dirs -%}
+        {%- assign level = workdir | append: "temp" | replace_first: "/", "" | split: "/" | size | minus: 2 %}
+        <li class="toc level-{{ level }}">{% include templates/_toctree.liquid %}</li>
+    {%- endfor -%}
+</ul>