jekyll-rtd-theme 2.0.3 → 2.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71e0be728a36e78ef8a38db4242292a0981347013258726fb82074c3d38fdc0d
-  data.tar.gz: e41c8381aa8cf0af5780449b0567f222d3a8959a00c5a73aa51daf028f99e1c7
+  metadata.gz: ee83573aebcfd24f89838e193a2f92821faf24923e2fdadf1fb85101408f3df4
+  data.tar.gz: 4f627eded8e3576c0e3c2e36428a71b0b89a59f198d105ce317d8925785b0d66
 SHA512:
-  metadata.gz: ed35e6eff3b3b0ab73924527a16f52adea7f7ba95845f51e43def520b8136d3bc9c88594921a7b0b93875c75a0aa9c1b69efb3bba18e431ca344aac1c5574726
-  data.tar.gz: 40b26d3027d9f8f379a284cc3025c51c4740346921439aec81d4d87df114b633db7644badf7cc7ef2f90bb307aa52beb326495175ef797a0804da6ad78b0ce07
+  metadata.gz: d3b0910fb77a936748ffe12199d22f632e7347d678696e69121c90456eb2d483f8bbc0e91d52db20d3443fc620e54742cd88913423a72d48dd8d56314805d839
+  data.tar.gz: e40892f1493aba635fb4153940e701ef3acef2e40ae83d90dd8c8ae240ac1e9dce0c0de2a5cfb48680ae48d1af7e6ae6a1d3885a5bd73a53b7326aaf25c39e2b

data/README.md

@@ -3,21 +3,14 @@
 ![CI](https://github.com/rundocs/jekyll-rtd-theme/workflows/CI/badge.svg?branch=v2)
 ![jsDelivr](https://data.jsdelivr.com/v1/package/gh/rundocs/jekyll-rtd-theme/badge)
 
-Opinionated github flavored standard document theme for open source projects, with few options, but everything!
+Opinionated standard document theme, with few options, but everything!
 
 ## What it does?
 
 This theme is inspired by [sphinx-rtd-theme](https://github.com/readthedocs/sphinx_rtd_theme) and refactored with:
 
-- [github-pages](https://github.com/github/pages-gem)
 - [@primer/css](https://github.com/primer/css)
-
-Give you a native GitHub experience and solved the issue of open source project documentation site
-
-- No need to learn other programming languages for building documentation
-- No need to care about the site SEO
-- Markdown syntax extended
-- Native support for mermaid chart plugin
+- [github-pages](https://github.com/github/pages-gem) ([dependency versions](https://pages.github.com/versions/))
 
 ## Quick start
 
@@ -27,20 +20,43 @@ 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
 
-```yml
-title: Your awesome title
-lang: # default: en
-description: Write an awesome description for your new site here
+| 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
 
-## optional settings ##
 meta:
   key1: value1
   key2: value2
+  .
+  .
+  .
 
 google:
   gtag:
@@ -65,6 +81,8 @@ translate:
   warning:
   # 404
   not_found:
+  # copyright
+  revision:
   # search
   searching:
   search:
@@ -73,17 +91,12 @@ translate:
   search_results_found: # the "#" in this translate will replaced with results size!
   search_results_not_found:
 
-## optional plugins ##
 plugins:
   - jemoji
   - jekyll-avatar
   - jekyll-mentions
 ```
 
-## Writing
-
-Document writing specifications, please refer to [rundocs.io](https://rundocs.io) for details
-
 ## The license
 
 The theme is available as open source under the terms of the MIT License

data/_includes/class/_breadcrumbs.liquid

@@ -1,7 +1,7 @@
 <div class="navigation-top d-flex flex-justify-between">
     <ul class="breadcrumb" role="navigation" aria-label="breadcrumbs navigation">
         <li class="breadcrumb-item">
-            <a class="no-underline" href="{{ site.baseurl }}/">
+            <a class="no-underline" href="{{ site.baseurl }}/" title="{{ docs.source.path }}">
                 <i class="fa fa-home"></i>
             </a>
         </li>

data/_includes/class/_footer.liquid

@@ -24,18 +24,20 @@
 
 <div class="copyright text-center text-gray" role="contentinfo">
     <i class="fa fa-copyright"></i>
-    {%- assign created_time = rest_created_at | date: "%Y" -%}
-    {%- assign updated_time = rest_updated_at | date: "%Y" -%}
-    {%- if created_time == updated_time -%}
-        {{ created_time }},
-    {%- else -%}
-        {{ created_time }}-{{ updated_time }},
-    {%- endif %}
+    <span class="time">
+        {%- assign created_time = rest_created_at | date: "%Y" -%}
+        {%- assign updated_time = rest_updated_at | date: "%Y" -%}
+        {%- if created_time == updated_time -%}
+            {{- created_time -}},
+        {%- else -%}
+            {{- created_time }}-{{ updated_time -}},
+        {%- endif -%}
+    </span>
     <a class="text-gray" href="{{ docs.owner_url }}" target="_blank">
-        {{ author }}
+        {{- author -}}
     </a>
     {{ __.revision | default: "Revision" }}
     <a class="text-gray" href="{{ docs.repository_url }}/commit/{{ docs.build_revision }}" title="{{ docs.build_revision }}" target="_blank">
-        {{ docs.build_revision | slice: 0, 7 }}
+        {{- docs.build_revision | slice: 0, 7 -}}
     </a>
 </div>

data/_includes/node/links.liquid

@@ -14,11 +14,20 @@
 {%- endif -%}
 
 {% comment %} theme {% endcomment %}
-<link rel="stylesheet" href="{{ cdn }}/assets/css/theme{% if site.debug.dist != false %}.min{% endif %}.css">
+<link rel="stylesheet" href="{{ base }}/assets/css/theme{% if site.debug.dist != false %}.min{% endif %}.css">
 
 {%- if custom_scss.size > 0 -%}
     <style>{{ custom_scss | scssify | strip_newlines }}</style>
 {%- endif -%}
 
-{% comment %} icon {% endcomment %}
-<link rel="icon" type="image/svg+xml" href="{{ site.baseurl }}/favicon.svg">
+{% 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="#2980b9">
+
+{% comment %} apple-touch-icon {% endcomment %}
+<link rel="apple-touch-icon" href="{{ site.baseurl }}/assets/images/apple-touch-icon-300x300.jpg">

data/_includes/node/metadata.liquid

@@ -10,7 +10,7 @@
     <meta name="{{ meta.first }}" content="{{ meta.last }}">
 {% endfor -%}
 
-{% comment %} https://ogp.me {% endcomment %}
+{% comment %} Open Graph {% endcomment %}
 <meta property="og:title" content="{{ title }}">
 <meta property="og:description" content="{{ description }}">
 <meta property="og:locale" content="{{ lang }}">
@@ -19,3 +19,11 @@
 <meta property="article:author" content="{{ author }}">
 <meta property="article:published_time" content="{{ schema_date }}">
 <meta property="article:modified_time" content="{{ schema_modi }}">
+
+{% comment %} Twitter Card {% endcomment %}
+<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="@jekyll-rtd-theme v{{ version }}">

data/_includes/node/script.extension.liquid

@@ -3,7 +3,7 @@
     {%- if site.mermaid.custom -%}
         <script src="{{ site.mermaid.custom }}"></script>
     {%- else -%}
-        <script src="{{ cdn }}/assets/js/mermaid.min.js"></script>
+        <script src="{{ base }}/assets/js/mermaid.min.js"></script>
     {%- endif %}
     <script>
         mermaid.initialize({% if site.mermaid.initialize %}{{ site.mermaid.initialize | jsonify }}{% else %}{}{% endif %});

data/_includes/node/script.liquid

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

data/_includes/reset/content.liquid

@@ -2,4 +2,5 @@
     | replace: "’", "'"
     | replace: "“", '"'
     | replace: "”", '"'
+    | replace: "<script", '<script async'
     | replace: "highlighter-rouge", "highlighter-rouge notranslate" -%}

data/_includes/reset/variables.liquid

@@ -6,6 +6,7 @@
 {%- assign rest_created_at = rest.created_at | default: site.time -%}
 {%- assign rest_updated_at = rest.updated_at | default: site.time -%}
 
+{%- assign direction = site.direction | default: "auto" -%}
 {%- assign lang = site.lang | default: "en" -%}
 {%- assign author = docs.owner.name | default: docs.owner_name -%}
 
@@ -14,13 +15,6 @@
 {%- assign schema_modi = site.time | date_to_xmlschema -%}
 {%- assign schema_surl = page.url  | absolute_url | xml_escape -%}
 
-{% comment %} debug {% endcomment %}
-{%- if site.debug -%}
-    {%- assign cdn = site.baseurl -%}
-{%- else -%}
-    {%- assign cdn = "https://cdn.jsdelivr.net/gh/rundocs/jekyll-rtd-theme@" | append: version -%}
-{%- endif -%}
-
 {% comment %} custom {% endcomment %}
 {%- capture custom_scss -%}
     {%- include assets/custom.scss -%} {{- site.scss -}}
@@ -29,3 +23,10 @@
 {%- capture custom_script -%}
     {%- include assets/custom.js -%} {{- site.script -}}
 {%- endcapture -%}
+
+{% comment %} debug {% endcomment %}
+{%- if site.debug -%}
+    {%- assign base = site.baseurl -%}
+{%- else -%}
+    {%- assign base = "https://cdn.jsdelivr.net/gh/rundocs/jekyll-rtd-theme@" | append: version -%}
+{%- endif -%}

data/_includes/reset/version.liquid

@@ -1 +1 @@
-{%- assign version = "2.0.3" -%}
+{%- assign version = "2.0.8" -%}

data/_includes/shortcodes/danger.liquid

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

data/_includes/shortcodes/mermaid.liquid

@@ -1 +1,3 @@
-<div class="mermaid overflow-x-auto">{{ codes }}</div>
+<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

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

data/_includes/shortcodes/tip.liquid

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

data/_includes/shortcodes/warning.liquid

@@ -1,9 +1,9 @@
-<div class="admonition warning mb-3">
+<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 p-2">
+    <div class="content px-2 py-3">
         {{ codes | markdownify | strip_newlines -}}
     </div>
 </div>

data/_layouts/default.liquid

@@ -1,11 +1,11 @@
 ---
-layout: plugins/compress
+layout: tasks/compress
 ---
 
 {%- include reset/defaults.liquid -%}
 
 <!DOCTYPE html>
-<html lang="{{ lang }}">
+<html lang="{{ lang }}" dir="{{ direction }}">
     <head>
         {%- include node/metadata.liquid -%}
 

data/_layouts/{plugins → tasks}/compress.liquid

@@ -1,5 +1,5 @@
 ---
-layout: plugins/extension
+layout: tasks/shortcodes
 ---
 
 {%- if site.debug.compress == false -%}

data/_layouts/{plugins/extension.liquid → tasks/shortcodes.liquid}

@@ -2,7 +2,7 @@
 
 {%- assign shortcodes = "mermaid, warning, note, tip, danger" | split: ", " -%}
 
-{%- if site.debug.extension == false -%}
+{%- if site.debug.shortcodes == false -%}
     {{ content }}
 {%- else -%}
     {%- if content contains "<pre" -%}

data/_sass/_direction.scss

@@ -0,0 +1,92 @@
+html[dir="rtl"] {
+  // common
+  ul,
+  ol {
+    padding-right: 0;
+  }
+
+  dd {
+    margin-right: 0;
+  }
+
+  // layout
+  .menu-sm {
+    left: unset;
+    right: -$theme-menu-width-sm;
+
+    &.shift {
+      left: unset;
+      right: 0;
+    }
+  }
+  .content-wrap {
+    &.shift {
+      left: unset;
+      right: $theme-menu-width-sm;
+    }
+  }
+
+  @include breakpoint(md) {
+    .menu-md {
+      left: unset;
+      right: 0;
+    }
+
+    .content-wrap {
+      margin-left: unset;
+      margin-right: $theme-menu-width;
+
+      &.shift {
+        left: unset;
+        right: 0;
+      }
+    }
+  }
+
+  // toctree
+  .toctree {
+    .fa {
+      margin-right: unset;
+      margin-left: 2px;
+    }
+    > ul {
+      // the first level links
+      > .toc > a {
+        padding-left: unset;
+        padding-right: $spacer-4 / 2;
+      }
+    }
+  }
+
+  // toc layout
+  .toc {
+    @for $level from 1 through 11 {
+      &.level-#{$level}.current {
+        > a {
+          padding-left: unset;
+          padding-right: $spacer-4 * ($level - 1 + 0.5);
+        }
+
+        .level-#{$level + 1} > a {
+          padding-left: unset;
+          padding-right: $spacer-4 * ($level + 0.5);
+        }
+      }
+    }
+  }
+  // markdown-body
+  .markdown-body {
+    .d-lang {
+      &:after {
+        right: unset;
+        left: 0;
+      }
+    }
+
+    // improved checkbox
+    .task-list-item-checkbox {
+      margin-right: unset;
+      margin-left: 3px;
+    }
+  }
+}