jekyll-rtd-theme 1.1.3 → 1.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17d21728bc57e4cf176a94b347ec1fa282bc3330a2fb1fafd4fae290a81c6f9a
-  data.tar.gz: 5b7a0c810f57c8c819e5eb204e05fb9a364c7ab917b8a261c3764b060901cac1
+  metadata.gz: d69e021f3df96ab3b9714d64e1d216601712e009ddb08aed35d7e7837e4ef86c
+  data.tar.gz: cf6b6baace1113759c0cffc4b1e097ae02f0369ec8d094a52ad500846aba4d8f
 SHA512:
-  metadata.gz: 25d5137a9c12bfcae20f06eccf5a63f6468be384a7e8e3d2449da2d6a042a0f57a4aef8e5238ff69328103ae85328b5f5382360de935ae712c3b2ad2082777b7
-  data.tar.gz: c98a582a2bf2f770e4d167242983832fdb3443a74d7428deee6db8cf809f04dacb8b24862e439e25ffff83cd34035ff0283a56017419312797a3b99488d15c44
+  metadata.gz: dc8d4eb1046e999f051855a27c521a043786df3d5961270fa6e1841d353875e96a02d2e0c0d5d4e329e14ba2448d62ce90fb99b54cb2a93b548bb9eb1f58a01e
+  data.tar.gz: a942afc0ac6fe9511159571c5235814a3579ac7058fd5376fc57588de94a56101bd9f49080122168b710b0db35a7d482990b14a616a0db802c796bfb5cb5d72f

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 RunDocs
+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

data/README.md

@@ -1,39 +1,85 @@
 # jekyll-rtd-theme
-[![](https://github.com/rundocs/jekyll-rtd-theme/workflows/CI/badge.svg)][repository]
-[![](https://img.shields.io/gem/v/jekyll-rtd-theme)][rubygem]
-[![](https://img.shields.io/gem/dt/jekyll-rtd-theme)][rubygem]
-[![](https://data.jsdelivr.com/v1/package/gh/rundocs/jekyll-rtd-theme/badge)][cdn]
-[![](https://www.codefactor.io/repository/github/rundocs/jekyll-rtd-theme/badge)][codefactor]
-[![](https://img.shields.io/badge/featured%20on-JekyllThemes-red.svg)](https://jekyll-themes.com)
-[![](https://badges.gitter.im/rundocs/jekyll-rtd-theme.svg)][gitter]
 
-GitHub-flavored docs theme for Jekyll, based on sphinx_rtd_theme
+![CI](https://github.com/rundocs/jekyll-rtd-theme/workflows/CI/badge.svg)
+![jsDelivr](https://data.jsdelivr.com/v1/package/gh/rundocs/jekyll-rtd-theme/badge)
 
-<img class="shadow-box" width="50%" alt="jekyll-rtd-theme" src="https://user-images.githubusercontent.com/68011645/89026666-ad3a8680-d35b-11ea-9f4b-d3fe26ae12ed.png">
+Opinionated github flavored standard document theme for open source projects, with few options, but everything!
+
+## What it does?
+
+This theme(`v1`) use [sphinx-rtd-theme](https://github.com/readthedocs/sphinx_rtd_theme)'s styles
+
+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
+- Native support for mermaid chart plugin
 
 ## Quick start
+
 ```yml
-remote_theme: rundocs/jekyll-rtd-theme
+remote_theme: rundocs/jekyll-rtd-theme@v1
 ```
+
 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/)
 
-## Features
-- Automatically generate nested sidebar based on directory
-- Multi-language supported
-- Search engine optimized
-- Document search (RegExp supported)
-- Support third-party comments
-- Google, Baidu, CNZZ Analytics supported
-- Just need one file `_config.yml` to configure site
-
-## Documents
-For full documentation, please refer to [rundocs.io](https://rundocs.io/), You can also view [the theme related tests documentation](https://rundocs.github.io/jekyll-rtd-theme)
-
-## License
-The theme is available as open source under the terms of the [MIT License](https://github.com/rundocs/jekyll-rtd-theme/blob/master/LICENSE).
-
-[repository]: https://github.com/rundocs/jekyll-rtd-theme
-[rubygem]: https://rubygems.org/gems/jekyll-rtd-theme
-[cdn]: https://cdn.jsdelivr.net/gh/rundocs/jekyll-rtd-theme/
-[codefactor]: https://www.codefactor.io/repository/github/rundocs/jekyll-rtd-theme
-[gitter]: https://gitter.im/rundocs/jekyll-rtd-theme?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+## Options
+
+```yml
+title: Your awesome title
+lang: # default: en
+description: Write an awesome description for your new site here
+
+readme_index:
+  with_frontmatter: true
+
+## optional settings ##
+meta:
+  key1: value1
+  key2: value2
+
+google:
+  gtag:
+  adsense:
+
+mermaid:
+  custom: # mermaid link
+  initialize: # mermaid options, default: {}
+
+# also available via file: _include/assets/custom.scss
+scss:
+
+# also available via file: _include/assets/custom.js
+script:
+
+# also available via file: _data/translate.yml
+translate:
+  # shortcodes
+  danger:
+  note:
+  tip:
+  warning:
+  # 404
+  not_found:
+  # search
+  searching:
+  search:
+  search_docs:
+  search_results:
+  search_results_found: # the "#" in this translate will replaced with results size!
+  search_results_not_found:
+
+## optional plugins ##
+plugins:
+  - jemoji
+  - jekyll-avatar
+  - jekyll-mentions
+```
+
+## Waiting
+
+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/addons/analytics.liquid

@@ -1,8 +1,11 @@
 <dl>
-    <dt>{{ __statistics }}</dt>
+    <dt>{{ __.statistics | default: "Statistics" }}</dt>
     <dd>
-        <a href="https://github.com/rundocs/analytics" target="_blank">
-            {{ __total_visits }} <span id="counter"><span class="progress"></span></span> <i class="fa fa-eye"></i>
+        <a href="https://github.com/rundocs/analytics" rel="noreferrer" target="_blank">
+            {{ __.total_visits | default: "Total visits" }}:
+            <span id="counter">
+                <span class="AnimatedEllipsis"></span>
+            </span>
         </a>
     </dd>
 </dl>

data/_includes/addons/github.liquid

@@ -1,6 +1,21 @@
 <dl>
-    <dt>{{ __github }}</dt>
-    <dd><a href="{{ repository_url }}"><i class="fa fa-github"></i> {{ __homepage }}</a></dd>
-    <dd><a href="{{ zip_url }}"><i class="fa fa-download"></i> {{ __download }}</a></dd>
-    <dd><a href="{{ issues_url }}"><i class="fa fa-question-circle-o"></i> {{ __issues }}</a></dd>
+    <dt>{{ __.github | default: "GitHub" }}</dt>
+    <dd>
+        <a href="{{ docs.repository_url }}" title="{{ __.stars | default: 'Stars' }}: {{ rest.stargazers_count }}">
+            <i class="fa fa-github"></i>
+            {{ __.homepage | default: "Homepage" }}
+        </a>
+    </dd>
+    <dd>
+        <a href="{{ docs.issues_url }}" title="{{ __.open_issues | default: 'Open issues' }}: {{ rest.open_issues }}">
+            <i class="fa fa-question-circle-o"></i>
+            {{ __.issues | default: "Issues" }}
+        </a>
+    </dd>
+    <dd>
+        <a href="{{ docs.zip_url }}" title="{{ __.size | default: 'Size' }}: {{ rest.size }} Kb">
+            <i class="fa fa-download"></i>
+            {{ __.download | default: "Download" }}
+        </a>
+    </dd>
 </dl>

data/_includes/assets/sw.caches.js

@@ -0,0 +1,43 @@
+self.addEventListener("activate", function (event) {
+  let cacheWhitelist = ["rundocs-{{ version }}"];
+
+  event.waitUntil(
+    caches.keys().then(function (keyList) {
+      return Promise.all(
+        keyList.map(function (key) {
+          if (cacheWhitelist.indexOf(key) === -1) {
+            return caches.delete(key);
+          }
+        })
+      );
+    })
+  );
+});
+
+self.addEventListener("fetch", function (e) {
+  if (
+    /^https:\/\/cdn\.jsdelivr\.net\/gh\/rundocs\/jekyll-rtd-theme@.+/.exec(
+      e.request.url
+    )
+  ) {
+    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("rundocs-{{ version }}").then(function (cache) {
+                cache.put(e.request, clone);
+              });
+              return resp;
+            })
+            .catch(console.log);
+        }
+      })
+    );
+  }
+});

data/_includes/class/_breadcrumbs.liquid

@@ -0,0 +1,28 @@
+<div role="navigation" aria-label="breadcrumbs navigation">
+    <ul class="wy-breadcrumbs">
+        <li>
+            <a href="{{ site.baseurl }}/" class="icon icon-home"></a><i class="fa fa-angle-double-right"></i>
+        </li>
+        {%- case page.url -%}
+            {%- when "/search.html" %}
+                <li>{{ __.search | default: "Search" }}</li>
+            {%- when "/404.html" %}
+                <li>404</li>
+            {%- else -%}
+                {%- assign blocks = page.path | split: "/" -%}
+                {%- for block in blocks -%}
+                    <li>
+                        {%- if forloop.last %}
+                            {{ page.name }}
+                        {%- else -%}
+                            <a href="{{ site.baseurl }}/{% for block in blocks limit: forloop.index %}{{ block }}/{% endfor %}">{{ block }}</a><i class="fa fa-angle-double-right"></i>
+                        {%- endif -%}
+                    </li>
+                {%- endfor -%}
+        {%- endcase %}
+        <li class="wy-breadcrumbs-aside">
+            <a class="fa fa-edit" href="{% github_edit_link %}" title="{{ __.edit | default: 'Edit on GitHub'}}" target="_blank"></a>
+        </li>
+    </ul>
+    <hr>
+</div>

data/_includes/class/_footer.liquid

@@ -0,0 +1,38 @@
+<footer>
+    {%- if page.url != "/search.html" and page.url != "/404.html" -%}
+        {%- if next or prev -%}
+            <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+                {%- if prev -%}
+                    <a href="{{ prev.url | relative_url }}" class="btn btn-neutral  float-left" title="{{ prev.title }}" accesskey="p" rel="prev">
+                        <span class="fa fa-arrow-circle-left"></span> {{ __.previous | default: "Previous" }}
+                    </a>
+                {%- endif -%}
+                {%- if next -%}
+                    <a href="{{ next.url | relative_url }}" class="btn btn-neutral float-right" title="{{ next.title }}" accesskey="n" rel="next">
+                        {{ __.next | default: "Next" }} <span class="fa fa-arrow-circle-right"></span>
+                    </a>
+                {%- endif -%}
+            </div>
+        {%- endif -%}
+    {%- endif -%}
+    <hr>
+    <div role="contentinfo" class="copyright">
+        <p>
+            <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 %}
+            <a href="{{ docs.owner_url }}" target="_blank">
+                {{ author }}
+            </a>
+            {{ __.revision | default: "Revision" }}
+            <a href="{{ docs.repository_url }}/commit/{{ docs.build_revision }}" title="{{ docs.build_revision }}" target="_blank">
+                {{ docs.build_revision | slice: 0, 7 }}
+            </a>
+        </p>
+    </div>
+</footer>

data/_includes/{toctree.liquid → class/_toctree.liquid}

@@ -4,15 +4,16 @@
 <ul>
     {%- for item in workdir_files -%}
         {%- assign level = item.dir | append: "temp" | replace_first: "/", "" | split: "/" | size -%}
-        {%- if site_lang != lang -%}
-            {%- assign level = level | minus: 1 -%}
-        {%- endif -%}
         {%- capture current -%}
             {%- if page.url == item.url %}current{% endif -%}
         {%- endcapture %}
-        <li class="toctree-l{{ level }} {{ current }}">
+        <li class="toctree-l{{ level }} {{ current }}" data-sort="{{ item.sort }}" data-level="{{ level }}">
             <a class="reference internal {{ current }}" href="{{ item.url | relative_url }}">
-                {{ item.title | default: item.url }}
+                {%- if item.sort and site.show_sorted != false -%}
+                    {{ item.sort }}. {{ item.title | default: item.url }}
+                {%- else -%}
+                    {{ item.title | default: item.url }}
+                {%- endif -%}
             </a>
         </li>
     {%- endfor %}

data/_includes/{addons.liquid → class/rst-versions.liquid}

@@ -1,23 +1,21 @@
 <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
     <span class="rst-current-version" data-toggle="rst-current-version">
         <span class="fa fa-book"> {{ site.title }}</span>
-        {% if site.addons_branch and site.github_metadata != false %}v: {{ branch }}{% endif %}
+        {{ docs.source.branch }}
         <span class="fa fa-caret-down"></span>
     </span>
     <div class="rst-other-versions">
-        {%- assign items = site.addons | default: addons -%}
+        {%- assign items = "github, analytics" | split: ", " -%}
         {% for item in items -%}
-            {%- if addons contains item -%}
-                {% include addons/{{ item }}.liquid %}
-            {%- endif -%}
+            {% include addons/{{ item }}.liquid %}
         {% endfor -%}
         <hr>
         <small>
             <span>
                 Built with
-                <a href="https://jekyllrb.com/">Jekyll</a>
-                using the
-                <a href="https://github.com/rundocs/jekyll-rtd-theme">jekyll-rtd-theme</a> (MIT)
+                <a href="https://github.com/rundocs/jekyll-rtd-theme" target="_blank" title="{% if site.remote_theme %}remote{% endif %} theme v{{ version }}">jekyll-rtd-theme</a>
+                provided by
+                <a href="https://rundocs.io" target="_blank">RunDocs</a>
             </span>
         </small>
     </div>

data/_includes/class/wy-nav-content.liquid

@@ -0,0 +1,15 @@
+<div class="wy-nav-content">
+    <div class="rst-content">
+        {% include class/_breadcrumbs.liquid %}
+        <div role="main" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="document" itemprop="articleBody">
+                {%- if page.url == "/search.html" -%}
+                    {{ content }}
+                {%- else -%}
+                    <div class="section">{{ content }}</div>
+                {%- endif -%}
+            </div>
+        </div>
+        {% include class/_footer.liquid %}
+    </div>
+</div>

data/_includes/class/wy-nav-side.liquid

@@ -0,0 +1,18 @@
+<nav data-toggle="wy-nav-shift" class="wy-nav-side">
+    <div class="wy-side-scroll">
+        <div class="wy-side-nav-search">
+            <a href="{{ site.baseurl }}/" class="icon icon-home">
+                {{ site.title }}
+            </a>
+            <div class="version">{{ docs.latest_release.name }}</div>
+            <div role="search">
+                <form id="rtd-search-form" class="wy-form" action="{{ site.baseurl }}/search.html" method="get" autocomplete="off">
+                    <input type="text" name="q" placeholder="{{ __.search_docs | default: 'Search docs...' }}">
+                </form>
+            </div>
+        </div>
+        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+            {% include class/_toctree.liquid %}
+        </div>
+    </div>
+</nav>

data/_includes/class/wy-nav-top.liquid

@@ -0,0 +1,8 @@
+<nav class="wy-nav-top" aria-label="top navigation">
+    <div class="flex">
+        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+        <div class="wy-nav-title">
+            <a href="{{ site.baseurl }}/">{{ site.title }}</a>
+        </div>
+    </div>
+</nav>

data/_includes/extend/list.liquid

@@ -6,10 +6,10 @@
 {%- assign size_p1 = size | plus: 1 -%}
 
 {%- assign dir = site_pages | where: "url", workdir | first %}
-{% include extend/tabs.liquid size=size %}- [{{ dir.title | default: dir.url }}]({{ dir.url | relative_url }})
+{% include reset/tabs.liquid size=size %}- [{{ dir.title | default: dir.url }}]({{ dir.url | relative_url }})
 
 {%- for item in workdir_files %}
-{% include extend/tabs.liquid size=size_p1 %}- [{{ item.title | default: item.url }}]({{ item.url | relative_url }})
+{% include reset/tabs.liquid size=size_p1 %}- [{{ item.title | default: item.url }}]({{ item.url | relative_url }})
 {%- endfor -%}
 
 {%- for workdir in workdir_dirs %}{% include extend/list.liquid %}{% endfor -%}

data/_includes/extend/toctree.liquid

@@ -2,10 +2,6 @@
 
 {% comment %} display the directory name {% endcomment %}
 {%- assign dir = site_pages | where: "url", workdir | first -%}
-{%- if site_lang != lang -%}
-    {% comment %} current in language directory (level-1) {% endcomment %}
-    {%- assign workdir_level = workdir_level | minus: 1 -%}
-{%- endif -%}
 {%- if workdir_level == 2 %}
     {% comment %} display the root sub-directory as "p.caption" {% endcomment %}
     <p class="caption"><span class="caption-text">{{ dir.title | default: dir.url }}</span></p>
@@ -20,11 +16,8 @@
         {%- capture current -%}
             {%- if page.url == item.url %}current{% endif -%}
         {%- endcapture %}
-        {%- if site_lang != lang -%}
-            {%- assign level = level | minus: 1 -%}
-        {%- endif -%}
 
-        <li class="toctree-l{{ level }} {{ current }}">
+        <li class="toctree-l{{ level }} {{ current }}" data-sort="{{ item.sort }}" data-level="{{ level }}">
             <a class="reference internal {{ current }}" href="{{ item.url | relative_url }}">
                 {%- if item.sort and site.show_sorted != false -%}
                     {{ item.sort }}. {{ item.title | default: item.url }}
@@ -38,9 +31,6 @@
     {% comment %} list dirs {% endcomment %}
     {%- for workdir in workdir_dirs -%}
         {%- assign level = workdir | append: "temp" | replace_first: "/", "" | split: "/" | size | minus: 2 %}
-        {%- if site_lang != lang -%}
-            {%- assign level = level | minus: 1 -%}
-        {%- endif -%}
         <li class="toctree-l{{ level }}">{% include extend/toctree.liquid %}</li>
     {%- endfor -%}
 </ul>

data/_includes/node/links.liquid

@@ -0,0 +1,24 @@
+{%- comment %} dns-prefetch {% endcomment %}
+<link rel="dns-prefetch" href="https://rundocs-analytics.glitch.me">
+<link rel="dns-prefetch" href="https://cdn.jsdelivr.net">
+
+{%- comment %} canonical link {% endcomment %}
+<link rel="canonical" href="{{ schema_surl }}">
+
+{%- if prev -%}
+    <link rel="prev" href="{{ prev.url | absolute_url }}">
+{%- endif -%}
+
+{%- if next -%}
+    <link rel="next" href="{{ next.url | absolute_url }}">
+{%- endif -%}
+
+{% comment %} theme {% endcomment %}
+<link rel="stylesheet" href="{{ cdn }}/assets/css/theme.min.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">