jekyll-rtd-theme 2.0.0.pre.beta1 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d5f271a444c19902ca9cef4a2a5861863fa6afa932326101d2a4d1a3db4b8d3
-  data.tar.gz: 78baf17dd546c3717a466a51862545ed22f980c935bf5b40243027f7ce98b184
+  metadata.gz: 8d6d71f3df6935ef96991206b6a224cf0a36ccd595d83478253bf9167dcbc758
+  data.tar.gz: 37b55ae967ea0f8437afc6124fa73a689c18fb9efb2120a071195e5f473188cd
 SHA512:
-  metadata.gz: aebf7861d009713ce800cb0fdef796ec33b53c743bcfbfd139a0589f3c7c46dfc15229bbd626946057a448a3bd4a1791c4f39278e7baf3749ac6d99c159281ff
-  data.tar.gz: '09f541286274d91918604f15439f9d4faeff580cf5a798322d2be370e6f5d85e73758c936fe5c104f35cc386d60b3e71ede3f7cdc81df9f84503d1f69b88ab26'
+  metadata.gz: 331dca3e55068e1a8715fcaa7986c5210ff503aef4bf6279d2af43b3ddfe2f63519d4f3d1706b62155e60cf6938bc55f1a4ba8919b9cf89db5577529a69855a9
+  data.tar.gz: e7117f6baedc395c57fe17032f2884950859c7ee7693df0ff62c7a0da44dab706eee56916f54ac68886ef8ef8f54960672d246c1760b4ceaa1721ff3715a083a

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,11 +1,23 @@
 # jekyll-rtd-theme
 
-![CI](https://github.com/rundocs/jekyll-rtd-theme/workflows/CI/badge.svg)
+![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 documentation theme for open source projects, with few options, just use it!
+Opinionated github flavored standard document theme for open source projects, with few options, but everything!
 
-# Waiting for your contribution 2.0
+## 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
 
 ## Quick start
 
@@ -19,21 +31,16 @@ You can [generate](https://github.com/rundocs/starter-slim/generate) with the sa
 
 ```yml
 title: Your awesome title
-lang: en
+lang: # default: en
 description: Write an awesome description for your new site here
 
-# plugin options
 readme_index:
   with_frontmatter: true
 
-
-# optional settings
+## optional settings ##
 meta:
   key1: value1
   key2: value2
-  .
-  .
-  .
 
 google:
   gtag:
@@ -41,16 +48,42 @@ google:
 
 mermaid:
   custom: # mermaid link
-  initialize: # mermaid options
-
-
-# optional plugins
+  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
 ```
 
+## 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/addons → addons}/analytics.liquid

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

data/_includes/assets/sw.caches.js

@@ -1,11 +1,11 @@
 self.addEventListener("activate", function (event) {
-  let cacheWhitelist = ["rundocs-{{ version }}"];
+  const current = ["rundocs-{{ version }}"];
 
   event.waitUntil(
     caches.keys().then(function (keyList) {
       return Promise.all(
         keyList.map(function (key) {
-          if (cacheWhitelist.indexOf(key) === -1) {
+          if (current.indexOf(key) === -1) {
             return caches.delete(key);
           }
         })
@@ -15,11 +15,7 @@ self.addEventListener("activate", function (event) {
 });
 
 self.addEventListener("fetch", function (e) {
-  if (
-    /^https:\/\/cdn\.jsdelivr\.net\/gh\/rundocs\/jekyll-rtd-theme@.+/.exec(
-      e.request.url
-    )
-  ) {
+  if (e.request.url.match("rundocs/jekyll-rtd-theme@{{ version }}")) {
     e.respondWith(
       caches.match(e.request).then(function (resp) {
         if (resp !== undefined) {

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 href="{{ site.baseurl }}/">
+            <a class="no-underline" href="{{ site.baseurl }}/">
                 <i class="fa fa-home"></i>
             </a>
         </li>
@@ -17,7 +17,7 @@
             {%- else -%}
                 {%- assign blocks = page.path | split: "/" -%}
                 {%- for block in blocks -%}
-                    <li class="breadcrumb-item" {% if forloop.last %}aria-current{% endif %}>
+                    <li class="breadcrumb-item" {% if forloop.last %}aria-current="page"{% endif %}>
                         {%- if forloop.last -%}
                             {{ page.name }}
                         {%- else -%}
@@ -27,7 +27,7 @@
                 {%- endfor -%}
         {%- endcase -%}
     </ul>
-    <a class="edit" href="{% github_edit_link %}" title="{{ __.edit | default: 'Edit on GitHub'}}" target="_blank">
+    <a class="edit" href="{% github_edit_link %}" title="{{ __.edit | default: 'Edit on GitHub'}}" rel="noreferrer" target="_blank">
         <i class="fa fa-edit"></i>
     </a>
 </div>

data/_includes/class/_toctree.liquid

@@ -1,4 +1,4 @@
-{%- include assets/workdir.liquid %}
+{%- include reset/workdir.liquid %}
 
 {% comment %} list the root files {% endcomment %}
 <ul>
@@ -10,9 +10,9 @@
         <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.url }}
+                    {{ item.sort }}. {{ item.title | default: item.name }}
                 {%- else -%}
-                    {{ item.title | default: item.url }}
+                    {{ item.title | default: item.name }}
                 {%- endif -%}
             </a>
         </li>
@@ -20,4 +20,4 @@
 </ul>
 
 {% comment %} list the root dirs {% endcomment %}
-{%- for workdir in workdir_dirs %}{% include class/_toctree.extend.liquid %}{% endfor -%}
+{%- for workdir in workdir_dirs %}{% include extend/toctree.liquid %}{% endfor -%}

data/_includes/class/addons-wrap.liquid

@@ -13,7 +13,7 @@
     <div class="addons d-flex flex-column height-full p-2 d-none">
         {%- assign items = "github, analytics" | split: ", " -%}
         {% for item in items -%}
-            {% include class/addons/{{ item }}.liquid %}
+            {% include addons/{{ item }}.liquid %}
         {% endfor -%}
         <hr>
         <div class="generator f6 pb-2">

data/_includes/class/content-wrap.liquid

@@ -3,11 +3,11 @@
         <button id="toggle" class="btn-octicon p-2 m-0 text-white" type="button">
             <i class="fa fa-bars"></i>
         </button>
-        <div class="title flex-1 no-underline d-flex flex-justify-center">
-            <a class="h4 py-1 px-2 rounded-1" href="{{ site.baseurl }}/">{{ site.title }}</a>
+        <div class="title flex-1 d-flex flex-justify-center">
+            <a class="h4 no-underline py-1 px-2 rounded-1" href="{{ site.baseurl }}/">{{ site.title }}</a>
         </div>
     </div>
-    <div class="content p-5">
+    <div class="content p-3 p-sm-5">
         {% include class/_breadcrumbs.liquid %}
         <hr>
         <div role="main" itemscope="itemscope" itemtype="http://schema.org/Article">

data/_includes/class/sidebar-wrap.liquid

@@ -1,12 +1,12 @@
 <div class="sidebar-wrap overflow-hidden">
-    <div class="sidebar d-flex flex-column height-full overflow-y-scroll overflow-x-hidden">
+    <div class="sidebar height-full overflow-y-scroll overflow-x-hidden">
         <div class="header d-flex flex-column p-3 text-center">
-            <div class="title pb-1 no-underline">
-                <a class="h4 py-1 px-2 rounded-1" href="{{ site.baseurl }}/" title="{{ site.description }}">
+            <div class="title pb-1">
+                <a class="h4 no-underline py-1 px-2 rounded-1" href="{{ site.baseurl }}/" title="{{ site.description }}">
                     <i class="fa fa-home"></i> {{ site.title }}
                 </a>
             </div>
-            <span class="version text-gray">{{ docs.latest_release.name }}</span>
+            <span class="version">{{ docs.latest_release.name }}</span>
             <form class="search pt-2" action="{{ site.baseurl }}/search.html" method="get" autocomplete="off">
                 <input class="form-control input-block input-sm" type="text" name="q" placeholder="{{ __.search_docs | default: 'Search docs...' }}">
             </form>

data/_includes/extend/list.liquid

@@ -0,0 +1,15 @@
+{%- include reset/site_pages.liquid -%}
+{%- include reset/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 reset/tabs.liquid size=size %}- [{{ dir.title | default: dir.url }}]({{ dir.url | relative_url }})
+
+{%- for item in workdir_files %}
+{% include reset/tabs.liquid size=size_p1 %}- [{{ item.title | default: item.name }}]({{ item.url | relative_url }})
+{%- endfor -%}
+
+{%- for workdir in workdir_dirs %}{% include extend/list.liquid %}{% endfor -%}

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

@@ -1,13 +1,17 @@
-{%- include assets/workdir.liquid %}
+{%- include reset/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 %}
-    <p class="caption text-uppercase no-wrap px-2 mb-0">{{ dir.title | default: dir.url }}</p>
+    <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>
+    <a class="d-flex flex-items-baseline" href="{{ dir.url | relative_url }}">
+        {{ dir.title | default: dir.url }}
+    </a>
 {%- endif -%}
 
 <ul>
@@ -21,9 +25,9 @@
         <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.url }}
+                    {{ item.sort }}. {{ item.title | default: item.name }}
                 {%- else -%}
-                    {{ item.title | default: item.url }}
+                    {{ item.title | default: item.name }}
                 {%- endif -%}
             </a>
         </li>
@@ -32,6 +36,6 @@
     {% 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 class/_toctree.extend.liquid %}</li>
+        <li class="toc level-{{ level }}">{% include extend/toctree.liquid %}</li>
     {%- endfor -%}
 </ul>

data/_includes/list.liquid

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

data/_includes/{head → node}/links.liquid

@@ -1,3 +1,7 @@
+{%- 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 }}">
 
@@ -12,5 +16,9 @@
 {% comment %} theme {% endcomment %}
 <link rel="stylesheet" href="{{ cdn }}/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">

data/_includes/{head → node}/script.extension.liquid

@@ -22,3 +22,8 @@
         gtag("config", "{{ site.google.gtag }}");
     </script>
 {%- endif -%}
+
+{% comment %} Google AdSense {% endcomment %}
+{%- 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/{head → node}/script.liquid

@@ -1,11 +1,9 @@
 <script>
     window.ui = {
+        collect: new URL("{{ collect }}?v={{ version }}&lang={{ lang }}"),
         title: "{{ site.title }}",
-        lang: "{{ site.lang }}",
-        version: "{{ version }}",
         baseurl: "{{ site.baseurl }}",
         i18n: {
-            search_docs: "{{ __.search_docs | default: 'Search Docs' }}",
             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!' }}"
@@ -13,4 +11,9 @@
     };
 </script>
 <script src="{{ cdn }}/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>

data/_includes/reset/content.liquid

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

data/_includes/reset/defaults.liquid

@@ -0,0 +1,11 @@
+{%- include reset/site_pages.liquid -%}
+{%- include reset/i18n.liquid -%}
+{%- include reset/version.liquid -%}
+
+{%- include reset/variables.liquid -%}
+
+{%- include reset/content.liquid -%}
+
+{%- include reset/navigation.liquid -%}
+{%- include reset/title.liquid -%}
+{%- include reset/description.liquid -%}

data/_includes/reset/description.liquid

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

data/_includes/reset/navigation.liquid

@@ -0,0 +1,20 @@
+{%- include reset/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 -%}