j1_template_mde 2018.4.10

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7bc124b982db1a45be7bbf8d719f5cd427b08536
+  data.tar.gz: 5c00d33903f3a0e9f4247e134b596d855394bd7e
+SHA512:
+  metadata.gz: 1436685971ef9f694914a84e22d8379700f91a13cee0fd6dddf295b7a6e8447caa80c82b2a2175a8c8799c42b41f28c92063de23f0f03b7d53b122c0960f8793
+  data.tar.gz: dd7d7caed65d6919381b3b9c2127f7ef4a5e71187ca752496ec4ed0389b1a67f1439669039604ad68d664e095296734f3a4f0d990c7a653b6f0b5751360972cb

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (C) 2019 Juergen Adams
+
+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,79 @@
+# J1 Template MDE
+
+Welcome to your new gem! In this directory, you'll find the files you need to
+be able to package up your newly created Template for Jekyll into a Rubie to
+be pubslished e.g. on RubyGems for the public. 
+
+## Generate the Rubie manually
+
+It easy to generate the RubyGem (is all files are in place, generated by
+the development system). Run:
+
+``` sh
+gem build your_template_name.gemspec
+```
+
+### Helpful gem commands
+
+``` sh
+create:                     gem build your_template_name.gemspec
+list all local:             gem list your_template_name --local --all
+list all remote:            gem list your_template_name --remote --all
+publish (RubyGems):         gem push your_template_name-<version>.gem
+un-publish (RubyGems):      gem yank your_template_name -v <version>
+install (local):            gem install --local your_template_name --no-ri --no-rdoc
+install (remote):           gem install your_template_name --no-ri --no-rdoc
+uninstall:                  gem uninstall your_template_name --force
+                            gem uninstall your_template_name -v <version>
+# list bundle:              bundle list your_template_name
+# run j1 exe (help):        bundle exec j1 --help
+```
+
+## Installation
+
+An local installation of the new Rubie can be done like so:
+
+``` sh
+gem install --local your_template_name --no-ri --no-rdoc
+```
+
+## Creating a Starter Web
+
+If the template has been installed, the built-in executeable `j1` can be 
+used to create a new web, a scaffold, based on the new template gem.
+
+Create (or go for) a folder your webs a stored (e.g. ~/jekyll_webs)
+
+``` sh
+mkdir ~/jekyll_webs
+cd ~/jekyll_webs
+j1 generate starter
+```
+
+This will generate a fresh web scaffold under ~/jekyll_webs/starter.
+To bring up the the site, run:
+
+*Windows*
+``` sh
+cd %HOMEDRIVE%\%HOMEPATH%\jekyll_webs\starter && j1serve.bat
+```
+
+or
+
+*Unix|Linux|MacOS*
+``` sh
+cd ~/jekyll_webs/starter && j1serve.sh
+```
+
+and you're done. 
+
+## Contributing
+
+Bug reports and pull requests are welcome at
+[GitHub](https://github.com/jekyll-one/j1_template_mde).
+
+
+## License
+
+The RubyGem is available as Open Source under the terms of the 
+[MIT License](https://github.com/jekyll-one/j1_template_mde/blob/master/LICENSE).

data/_includes/themes/j1/layouts/content_generator_app.html

@@ -0,0 +1,34 @@
+{% comment %}
+ # -----------------------------------------------------------------------------
+ #  ~/_includes/templates/j1/pages/app_content_generator.html
+ #  Liquid template to create the content portion for pages of type POST
+ #
+ #  Product/Info:
+ #  https://jekyll-one.com
+ #
+ #  Copyright (C) 2019 Juergen Adams
+ #
+ #  J1 Template is licensed under the MIT License.
+ #  See: https://github.com/jekyll-one/j1_template_mde/blob/master/LICENSE
+ #
+ # -----------------------------------------------------------------------------
+ # Test data:
+ #  liquid_var:  {{ liquid_var | debug }}
+ #
+ # -----------------------------------------------------------------------------
+{% endcomment %}
+
+{% comment %} Liquid procedures
+--------------------------------------------------------------- {% endcomment %}
+
+{% comment %} Variables
+--------------------------------------------------------------- {% endcomment %}
+
+
+{% comment %} Main
+--------------------------------------------------------------- {% endcomment %}
+  <!-- [INFO   ] [j1.layout.app.html                 ] [Begin content] -->
+  <main id="app-content" class="col-md-12" style="padding-left:60px;padding-right:60px;">
+    {{content}}
+  </main>
+  <!-- [INFO   ] [j1.layout.app.html                 ] [End content] -->

data/_includes/themes/j1/layouts/content_generator_blog_archive.html

@@ -0,0 +1,201 @@
+{% comment %}
+ # -----------------------------------------------------------------------------
+ #  ~/_includes/templates/j1/pages/blog_archive_content_generator.html
+ #  Liquid template to create the content portion for pages of type PAGE
+ #
+ #  Product/Info:
+ #  https://jekyll-one.com
+ #
+ #  Copyright (C) 2019 Juergen Adams
+ #
+ #  J1 Template is licensed under the MIT License.
+ #  See: https://github.com/jekyll-one/j1_template_mde/blob/master/LICENSE
+ #
+ # -----------------------------------------------------------------------------
+ # Test data:
+ #  liquid_var:  {{ liquid_var | debug }}
+ #
+ # -----------------------------------------------------------------------------
+{% endcomment %}
+
+{% comment %} Liquid procedures
+--------------------------------------------------------------- {% endcomment %}
+{% capture collate_list %}themes/{{site.template.name}}/procedures/posts/collate_list.proc{% endcapture %}
+{% capture collate_calendar %}themes/{{site.template.name}}/procedures/posts/collate_calendar.proc{% endcapture %}
+{% capture collate_timeline %}themes/{{site.template.name}}/procedures/posts/collate_timeline.proc{% endcapture %}
+{% capture create_navigator %}themes/{{site.template.name}}/procedures/posts/create_navigator.proc{% endcapture %}
+
+{% comment %} Variables
+--------------------------------------------------------------- {% endcomment %}
+{% assign view_config_article_navigator = site.data.builder.blog_navigator.article_navigator %}
+{% assign article_navigator_description = view_config_article_navigator.description %}
+{% assign view_config_article_previewer = site.data.builder.blog_navigator.article_previewer %}
+{% assign article_previewer_description = view_config_article_previewer.description %}
+
+{% assign previewer                     = site.data.builder.blog_navigator.previewer %}
+{% assign paginate                      = site.pagination.enabled %}
+{% assign rtext                         = site.data.j1_config.typography.rtext %}
+{% assign page_rtext                    = page.rtext %}
+{% assign page_rtext_size               = page.rtext_size %}
+
+{% comment %} rtext|size detection
+--------------------------------------------------------------- {% endcomment %}
+{% if rtext %}
+  {% assign rtext_size = site.data.j1_config.typography.rtext_size %}
+{% else %}
+  {% assign rtext_size = 0 %}
+{% endif %}
+
+
+{% comment %} Main
+--------------------------------------------------------------- {% endcomment %}
+  <!-- split page to place a sidebar e.g. the document TOC -->
+  <div class="container mb-5">
+    <div class="row">
+
+      <section class="col-md-9 col-xs-12 r-text-{{rtext_size}} js-toc-content">
+
+          {% comment %} Blog Navigator
+          ----------------------------------------------------- {% endcomment %}
+          <!-- Content placed by blog_archive_content.html -->
+          <div id="blog_navigator" class="row">
+            <div class="col-md-12" role="main">
+
+              <div id="article_navigator">
+
+                {% assign navigator_base_path = "/pages/blog/navigator" %}
+
+                {% capture archive_path %}{{navigator_base_path}}/archive{% endcapture %}
+                {% capture date_view %}{{archive_path}}/dateview/{% endcapture %}
+                {% capture category_view %}{{archive_path}}/categoryview/{% endcapture %}
+                {% capture tag_view %}{{archive_path}}/tagview/{% endcapture %}
+                {% capture all_view %}{{archive_path}}/{% endcapture %}
+
+                {% comment %} https://stackoverflow.com/questions/22763180/assign-an-array-literal-to-a-variable-in-liquid-template {% endcomment %}
+                {% assign my_array = "one|two|three" | split: "|" %}
+
+                <div class="navigator-headline">
+                  <div id="navigator" class="post-headline">
+                    <h2 id="post-headline" class="mt-4">Article Navigator</h2>
+                  </div>
+
+                  <nav class="paginator">
+                    <ul class="pagination raised-z0">
+
+                      <li class="page-item"><a class="page-link" href="{{category_view | prepend: site.baseurl}}" title="View by Category">By Category</a></li>
+                      <li class="page-item"><a class="page-link" href="{{date_view | prepend: site.baseurl}}" title="View by Date">By Date</a></li>
+                      <li class="page-item"><a class="page-link" href="{{tag_view | prepend: site.baseurl}}" title="View by Tag">By Tag</a></li>
+                      <li class="page-item"><a class="page-link" href="{{all_view | prepend: site.baseurl}}" title="View All">All Posts</a></li>
+
+                    </ul>
+                  </nav> <!-- end paginator -->
+
+                  <div class="view-description ml-3 mb-3">
+                    {{article_navigator_description}}
+                  </div>
+                 </div> <!-- end navigator headline -->
+
+              </div> <!-- end blog navigator -->
+              {% comment %} End Blog Navigator
+              ------------------------------------------------- {% endcomment %}
+
+              {% comment %} Article Previewer
+              ------------------------------------------------- {% endcomment %}
+              <!-- Add Article Previewer if paginator is enabled -->
+              {% if paginate %}
+              <div id="article_previewer">
+
+                <div class="previewer-headline">
+
+                  <div class="post-headline">
+                    <h2 id="previewer" class="mt-4">Article Previews</h2>
+                  </div>
+
+                  {% comment %} Display pagination links if any
+                  --------------------------------------------- {% endcomment %}
+                  {% if paginator.total_pages > 1 %}
+                  <nav class="paginator">
+                    <ul class="pagination raised-z0">
+                      {% if paginator.previous_page %}
+                        {% if paginator.previous_page > 1 %}
+                          {% capture page_link %}{{paginator.previous_page_path}}#previewer{% endcapture %}
+                          <li class="page-item"><a class="page-link" href="{{page_link | prepend: site.baseurl}}" title="Previous page">Previous</a></li>
+                        {% else %}
+                          {% capture page_link %}{{navigator_base_path}}/#previewer{% endcapture %}
+                          <li class="page-item"><a class="page-link" href="{{page_link | prepend: site.baseurl}}" title="First page">Previous</a></li>
+                        {% endif %}
+                      {% else %}
+                          <li class="page-item disabled"><a class="page-link">First</a></li>
+                      {% endif %}
+
+                      {% if paginator.next_page %}
+                          {% capture page_link %}{{paginator.next_page_path}}#previewer{% endcapture %}
+                          <li class="page-item"><a class="page-link" href="{{page_link | prepend: site.baseurl}}" title="Next page">Next</a></li>
+                      {% else %}
+                          <li class="page-item disabled"><a class="page-link">Last</a>
+                      {% endif %}
+                    </ul>
+                  </nav>
+                  {% endif %}
+
+                  <div class="view-description ml-3 mb-3">
+                    {{article_previewer_description}}
+                  </div>
+
+                </div>
+
+                <div id="article_preview">
+                  <!-- Previewer selected of type: {{previewer}}-->
+                  <div id="preview_content">
+                    {% assign posts_collate = paginator.posts %}
+                    {% case previewer %}
+                      {% when 'list' %}
+                        {% include {{collate_list}} header_title=page.header_title header_tagline=page.header_tagline items=posts_collate %}
+                      {% when 'calendar' %}
+                          {% include {{collate_calendar}} header_title=page.header_title header_tagline=page.header_tagline items=posts_collate %}
+                      {% when 'timeline' %}
+                        {% include {{collate_timeline}} header_title=page.header_title header_tagline=page.header_tagline items=posts_collate %}
+                      {% else %}
+                        {% include {{collate_list}} header_title=page.header_title header_tagline=page.header_tagline items=posts_collate %}
+                    {% endcase %}
+                  </div>
+                </div>
+
+              </div>
+              <!-- end article previewer -->
+              {% endif %}
+              {% comment %} End Article Previewer
+              ------------------------------------------------- {% endcomment %}
+
+            </div> <!-- end col-md-12 -->
+          </div> <!-- end row blog_navigator -->
+
+        <!-- End Content placed by blog_archive_content.html -->
+        </section> <!-- end section for split page -->
+
+        <aside class="col-md-3 visible-md visible-lg">
+        <!-- NOTE: BS Affix is used on class j1-sidebar instead of Tocbot Affix -->
+        <div id="j1-sidebar" class="j1-sidebar hidden-print affix-top">
+          <div id="j1-toc-mgr" class="toc js-toc"></div>
+        </div>
+      </aside> <!-- end ASIDE for split page -->
+
+      {% comment %} Calc|Write the Back URL
+      --------------------------------------------------------- {% endcomment %}
+      {% if site.permalink == 'none' %}
+        {% capture browser_page_url %}{{page.url | prepend: site.baseurl}}.html {% endcapture %}
+      {% else %}
+        {% capture browser_page_url %}{{page.url | prepend: site.baseurl}}{% endcapture %}
+      {% endif %}
+
+      <!-- [INFO   ] [j1.page.{{page.title}}                   ] [Save the current page to cookieUserState cookie: {{ browser_page_url }}] -->
+      <script>
+      /* Manage the current page settings */
+      $(document).ready(function() {
+          var user_state_last_page = "{{browser_page_url}}";
+          j1.setUserStateCookie( {last_page:user_state_last_page} );
+      });
+      </script>
+
+    </div> <!-- end row -->
+  </div> <!-- end container -->

data/_includes/themes/j1/layouts/content_generator_collection.html

@@ -0,0 +1,116 @@
+{% comment %}
+ # -----------------------------------------------------------------------------
+ #  ~/_includes/templates/j1/pages/collection_content_generator.html
+ #  Liquid template to create the content portion for pages of type COLLECTION
+ #
+ #  Product/Info:
+ #  https://jekyll-one.com
+ #
+ #  Copyright (C) 2019 Juergen Adams
+ #
+ #  J1 Template is licensed under the MIT License.
+ #  See: https://github.com/jekyll-one/j1_template_mde/blob/master/LICENSE
+ #
+ # -----------------------------------------------------------------------------
+ # Test data:
+ #  liquid_var:  {{ liquid_var | debug }}
+ #
+ # -----------------------------------------------------------------------------
+{% endcomment %}
+
+{% comment %} Liquid procedures
+--------------------------------------------------------------- {% endcomment %}
+  {% capture pager %}themes/{{site.template.name}}/procedures/global/pager.proc{% endcapture %}
+
+{% comment %} Variables
+--------------------------------------------------------------- {% endcomment %}
+{% assign toccer_config       = site.data.modules.j1_toccer %}
+{% assign tocbot_enabled      = toccer_config.enabled %}
+
+{% assign rtext               = site.data.j1_config.typography.rtext %}
+{% assign page_rtext          = page.rtext %}
+{% assign page_rtext_size     = page.rtext_size %}
+{% assign page_toccer         = page.toccer %}
+{% assign page_toc            = page.toc %}
+
+{% if tocbot_enabled and page_toc or page_toccer %}
+  {% assign sidebar  = true %}
+{% else %}
+  {% assign sidebar  = false %}
+{% endif %}
+
+{% if rtext %}
+  {% assign rtext_size = site.data.j1_config.typography.rtext_size %}
+{% else %}
+  {% assign rtext_size = 0 %}
+{% endif %}
+
+
+{% comment %} Main
+--------------------------------------------------------------- {% endcomment %}
+  <div class="container mb-5">
+    <div class="row">
+
+    {% comment %} COLLECTION content
+    ----------------------------------------------------------- {% endcomment %}
+    {% if sidebar == false %}
+      <!-- FULL page - no sidebar for page toc -->
+      <section class="col-md-12 col-xs-12 r-text-{{rtext_size}}">
+
+        <!-- Include a pager at top position -->
+        {% include {{pager}} %}
+        <div class="post-headline mt-4">
+          <h2 id="blog_article_navigator" class="notoc">{{ page.title }}</h2>
+        </div>
+
+        <!-- Content placed by collection_content_generator.html -->
+        {{content}}
+        <!-- End Content placed by collection_content_generator.html -->
+
+        {% comment %} CONNECTORS moved to a separate lane
+        ----------------------------------------------------- {% endcomment %}
+        <!-- Include the CONNECTOR for supported comment providers -->
+        {% comment %}
+        {% include themes/{{site.template.name}}/procedures/provider/comments %}
+        {% endcomment %}
+
+      </section> <!-- end col-md-12 -->
+    {% else %}
+      <!-- SPLIT page. Place a sidebar e.g. for the document toc -->
+      <section class="col-md-9 col-xs-12 r-text-{{rtext_size}} js-toc-content">
+
+        <!-- Include a pager at top position -->
+        {% include {{pager}} %}
+        <div class="post-headline mt-4">
+          <h2 id="blog_article_navigator" class="notoc">{{ page.title }}</h2>
+        </div>
+
+        <!-- Content placed by collection_content_generator.html -->
+        {{content}}
+        <!-- End Content placed by collection_content_generator.html -->
+
+        {% comment %} CONNECTORS moved to a separate lane
+        ----------------------------------------------------- {% endcomment %}
+        <!-- Include the CONNECTOR for supported comment providers -->
+        {% comment %}
+        {% include themes/{{site.template.name}}/procedures/provider/comments %}
+        {% endcomment %}
+
+      </section> <!-- end col-md-9 -->
+
+      <aside class="col-md-3 d-none d-md-block">
+        {% comment %} if tocbot and page_navigation  {% endcomment %}
+        <!-- NOTE: BS Affix is used on class j1-sidebar instead of Tocbot Affix -->
+        <div id="j1-sidebar" class="j1-sidebar hidden-print affix-top">
+          <div id="j1-toc-mgr" class="toc js-toc"></div>
+        </div> <!-- end ASIDE for split page -->
+      {% comment %} endif  {% endcomment %}
+      </aside> <!-- end ASIDE for split page -->
+
+    {% endif %} <!-- endif page_navigation -->
+
+    {% comment %} END COLLECTION content
+    ----------------------------------------------------------- {% endcomment %}
+
+    </div> <!-- end row -->
+  </div> <!-- end container -->