jekyll-rtd-theme 0.1.0 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ec9e0b342599501734319987d2e9e126b1ec68f9fda65b68f3e8db033af4057
-  data.tar.gz: f5f5cc84de3b2676732e3cd9df4b85bdd61ec6a44814a6b9d9e1e4abb990c035
+  metadata.gz: 7147e810bfa78250ce75f3dd42eb6de5ba2b92c09331572836840d660b34acec
+  data.tar.gz: 969ba7a43596ebcd755df47107fce7934fd2ace44609d0af9e7c6dd8dd745023
 SHA512:
-  metadata.gz: 492da44c0119656b6c917da857df833b41d519a2c3a74505cdf2cb2aa702ccfdb2a015e7b7627aab4362297513033a54fca19c3fe0ee0a108397b97bb21b92a8
-  data.tar.gz: 7a42ad86878239b5afe11a02d747c2ab28c484f66064d69266559adc400b2179ae4eaf5e6c95befa7d0b860648e114add25a79d06c2940c937192e0fb29383a2
+  metadata.gz: 274f7cbe15c835a2f5194a71416937a1a4b4058f85030a51598198616503851cd500fa38084702cea1ce0b63c1bca39710c2c38441f32614f56c10f9be35b6f6
+  data.tar.gz: 6a5501806745641df092d10f8ed017809ba3aa1f732bfd49a94446e872944647663f7d1f478a363a6fcd7c1267ab9ab5a3c7ec675549955fb61439fdde54c876

data/README.md

@@ -1,43 +1,42 @@
 # jekyll-rtd-theme
-![Gem Version](https://badge.fury.io/rb/jekyll-rtd-theme.svg)
-![Gem Downloads](https://img.shields.io/gem/dt/jekyll-rtd-theme)
-![Users](https://img.shields.io/endpoint?url=https://rundocs-analytics.glitch.me/shields)
+[![](https://github.com/rundocs/jekyll-rtd-theme/workflows/gh-pages/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]
 
 Just another Jekyll theme for GitHub Pages based on ReadtheDocs's sphinx_rtd_theme styles
 
-## Installation
-There are two ways to install: as a gem-based theme, as a remote theme (GitHub Pages compatible)
-
-#### Gem-based method
-1. Add the following to your github repository's `Gemfile`
-    ```ruby
-    source "https://rubygems.org"
-    gem "jekyll-rtd-theme"
-    gem "github-pages", group: :jekyll_plugins
-    ```
-2. Add the following to your github repository's `_config.yml`
-    ```yml
-    theme: jekyll-rtd-theme
-    ```
-
-#### Remote theme method
-1. Add the following to your site's `_config.yml`
-    ```yml
-    remote_theme: rundocs/jekyll-rtd-theme
-    ```
-2. Remove any other `theme` or `remote_theme` entry
-
+![][demo]
+
+## Notable features
+- Write documents directly, like docsify!
+- Only need one file `_config.yml` to configure site
+- Bundled as a "theme gem" for easier installation/upgrading.
+- Compatible with GitHub Pages.
+- Optimized for search engines with support for Open Graph data.
+- Optimized for search engines with `robots.txt` and `sitemap.xml`.
+- Search engine support
+- Commenting support
+- Google,Baidu,CNZZ Analytics support.
+- UI localized text in English(default), Chinese(中文)
+- And many features waiting for you to discover.
 
 ## Roadmap
 See the [open issues][issues] for a list of proposed features (and known issues).
 
+## Documents
+For full documentation, see: [https://rundocs.github.io/jekyll-rtd-theme][site]
 
-## Contributing
-1. Clone down the theme's repository (`git clone https://github.com/rundocs/jekyll-rtd-theme.git`)
-2. `cd` into the theme's directory
-3. Run `bundle` to install the necessary dependencies
-4. Run `bundle exec jekyll server` to start the preview server
-5. Visit [`http://localhost:4000`](http://localhost:4000) in your browser to preview the theme
+## The License
+The theme is available as open source under the terms of the [MIT License][license].
 
 
-[issues]: https://github.com/rundocs/jekyll-rtd-theme/issues
+[repository]: https://github.com/rundocs/jekyll-rtd-theme
+[issues]:     https://github.com/rundocs/jekyll-rtd-theme/issues
+[license]:    https://github.com/rundocs/jekyll-rtd-theme/blob/master/LICENSE
+[site]: https://rundocs.github.io/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
+[demo]: https://user-images.githubusercontent.com/68011645/88376699-87980500-cdd0-11ea-8900-7bab8c811bc9.png

data/_includes/{versions.liquid → addons.liquid}

@@ -1,13 +1,13 @@
 <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>
-        {{ commit }}
+        {% if site.addons_commit %}{{ commit }}{% endif %}
         <span class="fa fa-caret-down"></span>
     </span>
     <div class="rst-other-versions">
-        {%- assign addons = "github,gems,analytics" | split: "," -%}
-        {% for name in addons -%}
-            {% include addons/source/{{ name }}.liquid %}
+        {%- assign items = site.addons | default: addons -%}
+        {% for item in items -%}
+            {% include addons/source/{{ item }}.liquid %}
         {% endfor -%}
         <hr>
         <small>

data/_includes/addons/comments/disqus.liquid

@@ -0,0 +1,10 @@
+{% if site.disqus %}
+<div id="disqus_thread" class="articleComments"></div>
+<script>
+    (function(script) {
+        script.src = "https://{{ site.disqus }}.disqus.com/embed.js";
+        script.setAttribute("data-timestamp", +new Date());
+        document.head.appendChild(script);
+    })(document.createElement("script"));
+</script>
+{% endif %}

data/_includes/addons/source/github.liquid

@@ -1,12 +1,6 @@
 <dl>
     <dt>{{ __github }}</dt>
-    {%- if jekyll.environment == "production" -%}
-        <dd><a href="{{ site.github.repository_url }}"><i class="fa fa-github"></i> {{ __homepage }}</a></dd>
-        <dd><a href="{{ site.github.zip_url }}"><i class="fa fa-download"></i> {{ __download }}</a></dd>
-        <dd><a href="{{ site.github.issues_url }}"><i class="fa fa-question-circle-o"></i> {{ __issues }}</a></dd>
-    {%- else -%}
-        <dd><a href="#"><i class="fa fa-github"></i> {{ __homepage }}</a></dd>
-        <dd><a href="#"><i class="fa fa-download"></i> {{ __download }}</a></dd>
-        <dd><a href="#"><i class="fa fa-question-circle-o"></i> {{ __issues }}</a></dd>
-    {%- endif -%}
+    <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>
 </dl>

data/_includes/assets/js/script.js

@@ -59,6 +59,7 @@ $(document).ready(function() {
         $.getJSON("{{ site.baseurl }}/data.json", search);
     }
     admonition();
+    anchors.add();
     SphinxRtdTheme.Navigation.reset = reset;
     SphinxRtdTheme.Navigation.enable(true);
 });

data/_includes/breadcrumbs.liquid

@@ -1,33 +1,37 @@
 <div role="navigation" aria-label="breadcrumbs navigation">
     <ul class="wy-breadcrumbs">
-        <li><a href="{{ site.baseurl }}/" class="icon icon-home"></a>&raquo;</li>
-        {% case page.url %}
-            {% when "/search.html" %}
+        <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 }}</li>
-            {% when "/404.html" %}
+            {%- when "/404.html" %}
                 <li>{{ __404 }}</li>
-            {% else %}
-                {% assign blocks = page.path | split: "/" %}
-                {% assign length = blocks | size %}
-                {% if page.dir == page.url and page.url != "/" %}
-                    {% assign length = blocks | size | minus: 1 %}
-                {% endif %}
-                {% for block in blocks limit: length %}
-                    {% if forloop.last %}
-                        <li>{{ page.title }}</li>
-                    {% else %}
-                        {% capture href %}{{ site.baseurl }}/{% for block in blocks limit: forloop.index %}{{ block | append: "/" }}{% endfor %}{% endcapture %}
-                        <li><a href="{{ href }}">{{ block | capitalize }}</a> &raquo;</li>
-                    {% endif %}
-                {% endfor %}
-        {% endcase %}
-        <li class="wy-breadcrumbs-aside">
-            {%- if jekyll.environment == "production" -%}
-                <a href="{% github_edit_link %}" class="fa fa-github" target="_blank"> {{ __edit }}</a>
             {%- else -%}
-                <a href="#" class="fa fa-github" target="_blank"> {{ __edit }}</a>
-            {%- endif -%}
-        </li>
+                {%- assign blocks = page.path | split: "/" -%}
+                {%- assign length = blocks | size -%}
+                {%- if page.dir == page.url and page.url != "/" -%}
+                    {%- assign length = blocks | size | minus: 1 -%}
+                {%- endif -%}
+                {%- for block in blocks limit: length -%}
+                    {%- if forloop.last %}
+                        <li>{{ page.title }}</li>
+                    {%- else -%}
+                        {%- capture href -%}
+                            {{ site.baseurl }}/{% for block in blocks limit: forloop.index %}{{ block | append: "/" }}{% endfor %}
+                        {%- endcapture %}
+                        <li>
+                            <a href="{{ href }}">{{ block | split: "." | last | capitalize }}</a><i class="fa fa-angle-double-right"></i>
+                        </li>
+                    {%- endif -%}
+                {%- endfor -%}
+        {%- endcase %}
+        {%- if site.edit -%}
+            <li class="wy-breadcrumbs-aside">
+                <a href="{{ github_edit_link }}" class="fa fa-github" target="_blank"> {{ __edit }}</a>
+            </li>
+        {%- endif -%}
     </ul>
     <hr>
 </div>

data/_includes/extend/list.liquid

@@ -0,0 +1,15 @@
+{%- include reset/html.liquid -%}
+{%- include reset/workspace.liquid -%}
+
+{%- assign base = page.dir | append: "temp/" | split: "/" | size -%}
+{%- assign size = workspace_level | minus: base -%}
+{%- assign size_p1 = size | plus: 1 -%}
+
+{%- assign dir = html_pages | where: "url", workspace | first %}
+{% include extend/tabs.liquid size=size %}- [{{ dir.title | default: dir.url }}]({{ site.baseurl | append: dir.url }})
+
+{%- for item in workspace_files %}
+{% include extend/tabs.liquid size=size_p1 %}- [{{ item.title | default: item.url }}]({{ site.baseurl | append: item.url }})
+{%- endfor -%}
+
+{%- for workspace in workspace_dirs %}{% include extend/list.liquid %}{% endfor -%}

data/_includes/extend/tabs.liquid

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

data/_includes/extend/toctree.liquid

@@ -0,0 +1,29 @@
+{%- include reset/workspace.liquid %}
+
+{%- assign dir = html_pages | where: "url", workspace | first -%}
+{%- if workspace_level == 2 %}
+    <p class="caption"><span class="caption-text">{{ dir.title | default: dir.url }}</span></p>
+{%- else %}
+    <a class="reference internal" href="{{ site.baseurl | append: dir.url }}">{{ dir.title | default: dir.url }}</a>
+{%- endif -%}
+
+<ul>
+    {%- for item in workspace_files -%}
+        {%- assign level = item.dir | append: "temp/" | split: "/" | size | minus: 2 -%}
+        {%- capture current -%}
+            {%- if page.url == item.url %}current{% endif -%}
+        {%- endcapture %}
+        <li class="toctree-l{{ level }} {{ current }}">
+            <a class="reference internal {{ current }}" href="{{ site.baseurl | append: item.url }}">
+                {%- if item.sort -%}
+                    {{ item.sort }}.
+                {%- endif %}
+                {{ item.title | default: item.url }}
+            </a>
+        </li>
+    {%- endfor -%}
+    {%- for workspace in workspace_dirs -%}
+        {%- assign level = workspace | append: "temp/" | split: "/" | size | minus: 3 %}
+        <li class="toctree-l{{ level }}">{% include extend/toctree.liquid %}</li>
+    {%- endfor -%}
+</ul>

data/_includes/footer.liquid

@@ -14,14 +14,21 @@
         </div>
     {%- endif -%}
     <hr>
-    <div role="contentinfo" class="copyright">
-        <p>
-            <i class="fa fa-copyright"></i> {{ __copyright }}
-            {{ site.time | date: "%Y" }},
-            {{ site.copyright | default: site.github.owner_name }}
-            <span class="commit">
-                {{ __revision }} <code>{{ commit }}</code>
-            </span>
-        </p>
-    </div>
+    {%- if site.copyright -%}
+        <div role="contentinfo" class="copyright">
+            <p>
+                <i class="fa fa-copyright"></i> {{ __copyright }}
+                {% if site.copyright.since -%}
+                    {{ site.copyright.since | append: "-" }}
+                {%- endif -%}
+                {{ site.time | date: "%Y" }},
+                {{ author }}
+                {% if site.copyright.revision -%}
+                    <span class="commit">
+                        {{ __revision }} <code>{{ commit }}</code>
+                    </span>
+                {%- endif -%}
+            </p>
+        </div>
+    {%- endif -%}
 </footer>

data/_includes/list.liquid

@@ -0,0 +1,10 @@
+{%- include reset/html.liquid -%}
+{%- include reset/workspace.liquid workspace=page.dir -%}
+
+{%- for item in workspace_files %}
+- [{{ item.title | default: item.url }}]({{ site.baseurl | append: item.url }})
+{%- endfor -%}
+
+{%- if include.all -%}
+    {%- for workspace in workspace_dirs %}{% include extend/list.liquid %}{% endfor -%}
+{%- endif -%}

data/_includes/reset/html.liquid

@@ -1,5 +1,6 @@
 {%- assign html_pages = site.html_pages
     | sort: "path"
+    | sort: "sort"
     | where_exp: "item", "item.url != '/404.html'"
     | where_exp: "item", "item.url != '/search.html'" -%}
 {%- assign html_dirs  = html_pages

data/_includes/reset/snippets.liquid

@@ -1,3 +1,11 @@
-{%- assign  site_style = '@import "style.scss";' -%}
-{%- assign  site_fluid = '@import "fluid.scss";' -%}
-{%- capture site_script %}{% include assets/js/script.js %}{% endcapture -%}
+{%- capture site_style -%}
+    @import "style.scss";
+    @import "rougify/{{ site.rougify | default: 'github' }}.scss";
+    {%- if site.fluid -%}
+        @import "fluid.scss";
+    {%- endif -%}
+{%- endcapture -%}
+
+{%- capture site_script %}
+    {% include assets/js/script.js %}
+{%- endcapture -%}

data/_includes/reset/variables.liquid

@@ -1,8 +1,28 @@
 {%- assign description = content | strip_html | split: " " | join: " " | escape | truncate: 150 -%}
-{%- assign author = site.github.owner_name -%}
-{%- assign commit = site.github.build_revision | slice: 0, 7 -%}
 {%- assign schema_url = page.url | absolute_url | xml_escape -%}
 {%- assign schema_lastmod = site.time | date_to_xmlschema -%}
-{%- assign npm = "https://cdn.jsdelivr.net/npm" -%}
-{%- assign cdn = "https://cdn.jsdelivr.net/gh/rundocs/static" -%}
-{%- assign rouge_style = site.rouge_style | default: "github" -%}
+{%- assign version = "0.1.6" -%}
+
+{%- if site.debug -%}
+    {%- assign cdn = site.baseurl -%}
+{%- else -%}
+    {%- assign cdn = "https://cdn.jsdelivr.net/gh/rundocs/jekyll-rtd-theme@" | append: version -%}
+{%- endif -%}
+
+{%- if jekyll.environment == "production" -%}
+    {%- assign author = site.author | default: site.github.owner_name -%}
+    {%- assign commit = site.github.build_revision | slice: 0, 7 -%}
+    {%- assign repository_url = site.github.repository_url -%}
+    {%- assign issues_url = site.github.issues_url -%}
+    {%- assign zip_url = site.github.zip_url -%}
+    {%- capture github_edit_link %}{% github_edit_link %}{% endcapture -%}
+{%- else -%}
+    {%- assign author = site.author | default: "[author]" -%}
+    {%- assign commit = "[commit]" -%}
+    {%- assign repository_url = "#" -%}
+    {%- assign issues_url = "#" -%}
+    {%- assign zip_url = "#" -%}
+    {%- assign github_edit_link = "#" -%}
+{%- endif -%}
+
+{%- assign addons = "github, gems, analytics" | split: ", " -%}

data/_includes/reset/workspace.liquid

@@ -0,0 +1,17 @@
+{%- assign workspace = include.workspace | default: "/" -%}
+{%- assign workspace_level = workspace | append: "temp/" | split: "/" | size | minus: 1 -%}
+{%- assign workspace_files = html_files | where_exp: "item", "item.dir == workspace" -%}
+
+{%- capture items -%}
+    {%- for item in html_dirs -%}
+        {%- assign current_m1 = item.dir | append: "temp/" | split: "/" | size | minus: 2 -%}
+        {%- if workspace_level == current_m1 -%}
+            {%- assign temp = workspace | append: "@@" -%}
+            {%- assign dir = item.dir | replace: workspace, temp | split: "@@" | first -%}
+            {%- if workspace == dir -%}
+                {{ item.dir }}|
+            {%- endif -%}
+        {%- endif -%}
+    {%- endfor -%}
+{%- endcapture -%}
+{%- assign workspace_dirs = items | split: "|" -%}

data/_includes/toctree.liquid

@@ -0,0 +1,17 @@
+{%- include reset/workspace.liquid %}
+
+<ul>
+    {%- for item in workspace_files -%}
+        {%- assign level = item.dir | append: "temp/" | split: "/" | size | minus: 1 -%}
+        {%- capture current -%}
+            {%- if page.url == item.url %}current{% endif -%}
+        {%- endcapture %}
+        <li class="toctree-l{{ level }} {{ current }}">
+            <a class="reference internal {{ current }}" href="{{ site.baseurl | append: item.url }}">
+                {{ item.title | default: item.url }}
+            </a>
+        </li>
+    {%- endfor %}
+</ul>
+
+{%- for workspace in workspace_dirs %}{% include extend/toctree.liquid %}{% endfor -%}

data/_layouts/default.liquid

@@ -5,6 +5,15 @@ layout: plugins/compress
 {%- include reset/start.liquid -%}
 
 <!DOCTYPE html>
+
+<!--
+    {% if site.remote_theme -%}
+        remote_theme: {{ site.remote_theme }}
+    {%- else -%}
+        theme: {{ site.theme }} v{{ version }}
+    {%- endif %}
+-->
+
 <html class="writer-html5" lang="{{ lang }}">
 
 <head>
@@ -15,7 +24,7 @@ layout: plugins/compress
     <meta name="description" content="{{ description }}">
     <meta name="author" content="{{ author }}">
     <meta name="revised" content="{{ commit }}">
-    <meta name="generator" content="Jekyll v{{ jekyll.version }}">
+    <meta name="generator" content="jekyll-rtd-theme v{{ version }}">
     <!-- custom meta -->
     {% for meta in site.meta -%}
         <meta name="{{ meta.first }}" content="{{ meta.last }}">
@@ -33,18 +42,15 @@ layout: plugins/compress
     {%- endif -%}
     <link rel="canonical" href="{{ schema_url }}">
     <!-- theme -->
-    <link rel="stylesheet" href="{{ cdn }}/css/theme.css">
-    <link rel="stylesheet" href="{{ cdn }}/css/rouge/{{ rouge_style }}.css">
-    <style>{{ site.style | default: site_style | scssify }}</style>
-    {%- if site.fluid -%}
-        <style>{{ site_fluid | scssify }}</style>
-    {%- endif %}
+    <link rel="stylesheet" href="{{ cdn }}/assets/css/theme.css">
+    <style>{{ site_style | scssify }}</style>
     <!-- icon -->
-    <link rel="icon" href="{{ site.baseurl }}/assets/favicon.png">
+    <link rel="icon" type="image/svg+xml" href="{{ site.baseurl }}/assets/favicon.svg">
     <!-- script -->
-    <script src="{{ npm }}/jquery/dist/jquery.min.js"></script>
-    <script src="{{ cdn }}/js/theme.js"></script>
-    <script>{{ site.script | default : site_script }}</script>
+    <script src="{{ cdn }}/assets/js/jquery.min.js"></script>
+    <script src="{{ cdn }}/assets/js/theme.js"></script>
+    <script src="{{ cdn }}/assets/js/anchor.min.js"></script>
+    <script>{{ site_script }}</script>
 </head>
 
 <body class="wy-body-for-nav">
@@ -53,13 +59,17 @@ layout: plugins/compress
         <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>
+                    {% if site.logo %}
+                        <a href="{{ site.baseurl }}/">
+                            <img src="{{ site.baseurl }}/{{ site.logo }}" class="logo" alt="{{ site.title }}">
+                        </a>
+                    {% else %}
+                        <a href="{{ site.baseurl }}/" class="icon icon-home"> {{ site.title }}</a>
+                    {% endif %}
                     {% include searchbox.liquid %}
                 </div>
                 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                    {% include sidebar.liquid %}
+                    {% include toctree.liquid %}
                 </div>
                 {%- if site.embed -%}
                 <div class="wy-embed-wrap">
@@ -85,14 +95,14 @@ layout: plugins/compress
                                 <div class="section">{{ content }}</div>
                             {%- endif %}
                         </div>
-                        <div class="articleComments"></div>
+                        {% include addons/comments/disqus.liquid %}
                     </div>
                     {% include footer.liquid %}
                 </div>
             </div>
         </section>
     </div>
-    {%- include versions.liquid -%}
+    {%- if site.addons %}{% include addons.liquid %}{% endif %}
     <!-- analytics -->
     {%- include addons/analytics/baidu.liquid -%}
     {%- include addons/analytics/cnzz.liquid -%}