redeyed-jekyll-theme 0.1.1 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec568d39f90b463a7323f9b8a95c84b902fc7a991fe4cdd5ba1e0a97ad70a3eb
-  data.tar.gz: 86f332c1ab5b9fc60f050a2abe6872f78457e84f9ecf461b3bcf8c32196a6b3b
+  metadata.gz: c9eaec50781daec2df0305b62492505ef4148d2e35ceb4d62f761580bafe5b96
+  data.tar.gz: 24f014ae9d07bc5fa1868246764c9516dfa5f6ce852aac69f76390313bfbd304
 SHA512:
-  metadata.gz: 957e77271d6df730facb4cafb508adf07088f8e063d2dabb8330330420369ea14d05d8019631716b958eef8004b32d5e5ddfb47444f083619668ff5689026e56
-  data.tar.gz: 2ea7ab5d65af3a5ef7ff2b66b2b1e945df3d619c94c06d43aca7345bfcd20cd4d59b56c102ac92c9848fc8f40997b122080ad61ed8d10f24a316dc378911904d
+  metadata.gz: 95e453db8be74d8fffa37a36b5f4c4dbf7302b6fe012170a96ed14d04c55379ff0cb600799333502d37f575a49502398d613414b20340a98244af5aa9f8f5adc
+  data.tar.gz: 51c34950aca76fbd439d3b3e9c8544a8daa47572aa4f7e0d34afc206243ce447b05e5a6deeac0f297cb7511ae91e0d7788a819d524448ef474d7e7e4cc4d5fc0

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022 Ragdata
+Copyright © 2022 ~ Ragdata & RedEyed-RPG
 
 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,54 +1,187 @@
-[![Gem Version](https://badge.fury.io/rb/redeyed-jekyll-theme.svg)](https://badge.fury.io/rb/redeyed-jekyll-theme)
+<div align="center">
 
-# redeyed-jekyll-theme
+<img src="https://aever.net/images/brand/banner/RedEyedRPG-960-Red.png" alt="RedEyed RPG" />
 
-Welcome to your new Jekyll theme! In this directory, you'll find the files you need to be able to package up your theme into a gem. Put your layouts in `_layouts`, your includes in `_includes`, your sass files in `_sass` and any other assets in `assets`.
+# redeyed-jekyll-theme<br />v0.1.4
 
-To experiment with this code, add some sample content and run `bundle exec jekyll serve` – this directory is setup just like a Jekyll site!
+<em>A versatile, responsive, and powerful Jekyll Theme designed for a gaming site</em>
 
-TODO: Delete this and the text above, and describe your gem
+[**https://www.redeyed-rpg.com**](https://www.redeyed-rpg.com)
 
+#### [Contributing](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/wiki/Contributor's-Guide) &middot; [Community Guidelines](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/wiki/Contributor-Covenant-&-Code-of-Conduct) &middot; [Submit an Issue](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/issues/new/choose) &middot; [Ask a Question](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/discussions)
+
+<a href="https://patreon.com/ragdata"><img src="assets/img/social/patreon.svg" height="24" width="24"></a> &nbsp;
+<a href="https://twitter.com/RedeyedRPG"><img src="assets/img/social/twitter.svg" height="24" width="24"></a> &nbsp;
+<a href="https://reddit.com/r/redeyed"><img src="assets/img/social/reddit.svg" height="24" width="24" alt="RedEyed-RPG Subreddit"></a> &nbsp;
+<a href="https://facebook.com/RedeyedRPG"><img src="assets/img/social/facebook.svg" height="24" width="24"></a> &nbsp;
+<a href="https://redeyed-rpg.tumblr.com"><img src="assets/img/social/tumblr.svg" height="24" width="24"></a> &nbsp;
+<a href="https://github.com/redeyed-rpg"><img src="assets/img/social/github.svg" height="24" width="24"></a> &nbsp;
+<a href="https://www.guilded.gg/i/27dYX5Xk"><img src="assets/img/social/guilded.svg" height="24" width="24"></a>
+
+[![Gem Version](https://badge.fury.io/rb/redeyed-jekyll-theme.svg)](https://badge.fury.io/rb/redeyed-jekyll-theme) &nbsp;
+[![Build Status](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/workflows/build/badge.svg?branch=master&event=push)](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/actions?query=branch%3Amaster+event%3Apush) &nbsp;
+[![GitHub license](https://img.shields.io/github/license/RedEyed-RPG/redeyed-jekyll-theme.svg)](https://github.com/RedEyed-RPG/redeyed-jekyll-theme/blob/master/LICENSE) &nbsp;
+[![Repo Code Weight](https://img.shields.io/github/languages/code-size/RedEyed-RPG/redeyed-jekyll-theme)](https://github.com/RedEyed-RPG/redeyed-jekyll-theme)
+<br/>
+[![Support Me @ Patreon](https://img.shields.io/badge/Patreon-Ragdata-%23FF424D?logo=patreon)](https://patreon.com/ragdata) &nbsp;
+[![Support Me @ GitHub](https://img.shields.io/badge/Github-Sponsor_This_Project-blue?logo=Github)](https://github.com/sponsors/Ragdata) &nbsp;
+[![Buy me a Ko-fi](https://img.shields.io/badge/Ko--fi-Ragdata-%23FF5E5B?logo=ko-fi)](https://ko-fi.com/ragdata)
+<br/><br/>
+[![](https://img.shields.io/badge/Guilded-Support%20Server%20Online-%23F5C400?logo=guilded)](https://www.guilded.gg/i/27dYX5Xk)
+
+</div>
+
+## Features
+
+- Localized Layout
+- Dark/Light Theme Mode
+- Pinned Posts
+- Hierarchical Categories
+- Last Modified Date for Posts
+- Table of Contents
+- Auto-Generated Related Posts
+- Syntax Highlighting
+- Mathematical Expressions
+- Disqus/Utterances/Giscus/Gitment Comments
+- Site Search
+- Atom Feeds
+- Google Analytics
+- SEO & Performance Optimisation
+
+## Introduction
+
+<div align="center"><img src="assets/img/banner.svg" widtH="100%"></div>
+
+If you want to use the theme just as it is on your own website, you have two options:
+
+- To install this theme as part of a brand-new Jekyll site, you want the [RedEyed Jumpstarter]().
+- To add this theme to your existing website, see [this documentation]().
 
 ## Installation
 
 Add this line to your Jekyll site's `Gemfile`:
 
-```ruby
+```console
 gem "redeyed-jekyll-theme"
 ```
 
 And add this line to your Jekyll site's `_config.yml`:
 
-```yaml
+```console
 theme: redeyed-jekyll-theme
 ```
 
 And then execute:
 
-    $ bundle
+```console
+$ bundle
+```
 
 Or install it yourself as:
 
-    $ gem install redeyed-jekyll-theme
+```console
+$ gem install redeyed-jekyll-theme
+```
+
+## 📚 Developer's Quick Start
 
-## Usage
+Before you start, please ensure that you've followed the instructions in the [Jekyll Docs](https://jekyllrb.com/docs/installation/) to complete the installation of `Ruby`, `RubyGems`, `Jekyll`, and `Bundler`.  You also need to have the following packages installed:
 
-TODO: Write usage instructions here. Describe your available layouts, includes, sass and/or assets.
+- Git
+- Node.js & npm (I recommend [NVM](https://github.com/nvm-sh/nvm) regardless of your platform)
 
-## Contributing
+### 📘 1. Fork the Project
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/hello. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+The first step you have already hopefully completed before getting to this part of the instructions - you need to fork the project from Github using your favourite tools or the Github website itself.
 
-## Development
+### 📘 2. Rename & Modify the Gemspec
 
-To set up your environment to develop this theme, run `bundle install`.
+The next thing you'll want to do is rename the `redeyed-jekyll-theme.gemspec` file to reflect the name of your own project.  Then, open that file and take care of the following details:
+
+- spec.name
+- spec.version
+- spec.authors
+- spec.email
+- spec.summary
+- spec.homepage
+- spec.license
+- spec.metadata
+
+### 📘 3. Install standard-version
+
+(Yes, I know it's deprecated - I'll change this as soon as I find a suitable replacement)
+
+Install `standard-version` as a global `bin`:
+
+```console
+$ npm i -g standard-version
+```
+
+### 📘 4. Install Commitlint & Husky
+
+> If you don't need to do things your own way, Commitlint and Husky can be installed using the script I've included with this package:
+> ```console
+> $ bash bin/install-commitlint
+> ```
+> Otherwise, follow each step below and make your changes as necessary
+
+Install `commitlint` & `husky`
+
+```console
+$ npm i --save-dev --location=global @commitlint/cli @commitlint/config-conventional husky
+```
 
-Your theme is setup just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
+Configure `commitlint` to use conventional config:
+
+```console
+$ echo "module.exports = {extends: ['@commitlint/config-conventional']}" > ..commitlintrc.js
+```
+
+And then enable `husky`:
+
+```console
+$ husky install
+```
+
+Add a husky commit hook:
+
+```shell
+cat <<EEE > .husky/commit-msg
+#!/usr/bin/env bash
+. "\$(dirname "\$0")/_/husky.sh"
+npx --no -- commitlint --edit "\${1}"
+EEE
+```
+
+Make the hook executable:
+
+```console
+$ chmod a+x .husky/commit-msg
+```
+
+Make sure you check out the [Contributor's Guide - Appendices](.github/CONTRIBUTING.md#appendix-a-commitlint-commit-types) for tips on how to use commitlint, why it's useful, and examples of how to structure your own commit messages to make the best use of the package.
+
+### 📘 5. Install Dependencies
+
+Install Jekyll dependencies:
+
+```console
+$ bundle install
+```
+
+### 📘 6. Start Local Server
+
+Then, start your local server in watch mode:
+
+```console
+$ bundle exex jekyll serve --watch
+```
+
+Now, open your browser to http://localhost:4000 and make your changes
 
 When your theme is released, only the files in `_layouts`, `_includes`, `_sass` and `assets` tracked with Git will be bundled.
 To add a custom directory to your theme-gem, please edit the regexp in `redeyed-jekyll-theme.gemspec` accordingly.
 
-## License
+## 📋 License
 
 The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-

data/_config.yml

@@ -324,12 +324,11 @@ exclude:
     - '*.gem'
     - '*.gemspec'
     - .github
+    - bin
+    - gulpfile.js
     - README.md
+    - CHANGELOG.md
     - LICENSE
-    - Gemfile
-    - Gemfile.lock
-    - gulpfile.js
     - package*.json
     - node_modules
     - vendor
-    - bin

data/_data/assets/cross-origin.yml

@@ -11,7 +11,7 @@ cdns:
 
 # FONTS
 
-webfonts: https://fonts.googleapis.com/css2?family=Cormorant+Unicase:wght@300;400;500;600;700&family=Cormorant+Infant:ital,wght@0,300;0,400;0,500;0,600;0,700;1,300;1,400;1,500;1,600;1,700&family=Xanh+Mono:ital@0;1&display=swap
+webfonts: https://fonts.googleapis.com/css2?family=Cormorant+SC:wght@400;700&family=Cormorant+Upright:wght@400;700&family=Cormorant:ital,wght@0,400;0,700;1,400;1,700&family=Cormorant+Garamond:ital,wght@0,400;0,700;1,400;1,700&family=Cormorant+Unicase:wght@300;400;500;600;700&family=Cormorant+Infant:ital,wght@0,300;0,400;0,500;0,600;0,700;1,300;1,400;1,500;1,600;1,700&family=Xanh+Mono:ital@0;1&family=Alegreya+SC:ital,wght@0,400;0,700;1,400;1,700&family=Alegreya+Sans+SC:ital,wght@0,100;0,400;0,700;1,100;1,400;1,700&family=Alegreya+Sans:ital,wght@0,100;0,400;0,700;1,100;1,400;1,700&family=Alegreya:ital,wght@0,400;0,700;1,400;1,700&display=swap
 
 # LIBRARIES
 

data/_includes/{elements → components}/javascript.html

@@ -15,7 +15,7 @@
           | append: ',' | append: site.data.assets[origin].lozad.js
           | append: ',' | append: site.data.assets[origin].clipboard.js
     %}
-    {% include elements/jsdelivr-combine.html urls=_urls %}
+    {% include functions/js-combine.html urls=_urls %}
 {% endif %}
 
 {% if page.layout == 'home'
@@ -34,7 +34,7 @@
           | append: ',' | append: site.data.assets[origin].dayjs.js.relativeTime
           | append: ',' | append: site.data.assets[origin].dayjs.js.localizedFormat
     %}
-    {% include elements/jsdelivr-combine.html urls=_urls %}
+    {% include functions/js-combine.html urls=_urls %}
 {% endif %}
 
 {% if page.layout == 'home'
@@ -53,37 +53,14 @@
 {% capture script %}/assets/js/dist/{{ type }}.min.js{% endcapture %}
 <script defer src="{{ script | relative_url }}"></script>
 
-{% if page.math %}
-<!-- MathJax -->
-<script>
-  /* see: <https://docs.mathjax.org/en/latest/options/input/tex.html#tex-options> */
-  MathJax = {
-    tex: {
-      inlineMath: [              /* start/end delimiter pairs for in-line math */
-        ['$','$'],
-        ['\\(','\\)']
-      ],
-      displayMath: [             /* start/end delimiter pairs for display math */
-        ['$$', '$$'],
-        ['\\[', '\\]']
-      ]
-    }
-  };
-</script>
-<script src="{{ site.data.assets[origin].polyfill.js | relative_url }}"></script>
-<script id="MathJax-script" async src="{{ site.data.assets[origin].mathjax.js | relative_url }}">
-</script>
-{% endif %}
-
 <!-- Bootstrap JS -->
 <script src="{{ site.data.assets[origin].bootstrap.js | relative_url }}"></script>
 
 {% if jekyll.environment == 'production' %}
-<!-- PWA -->
-{% if site.pwa.enabled %}
-<script defer src="{{ '/app.js' | relative_url }}"></script>
-{% else %}
-<script defer src="{{ '/unregister.js' | relative_url }}"></script>
-{% endif %}
-
+    <!-- PWA -->
+    {% if site.pwa.enabled %}
+        <script defer src="{{ '/app.js' | relative_url }}"></script>
+    {% else %}
+        <script defer src="{{ '/unregister.js' | relative_url }}"></script>
+    {% endif %}
 {% endif %}

data/_includes/{elements → components}/navbar.html

@@ -1,6 +1,13 @@
-{% comment %} NAVBAR {% endcomment %}
+<!-- NAVBAR -->
 <nav>
+    <div class="container-fluid">
+        <ul class="navbar-nav">
+
+        </ul>
+    </div>
+
+
     {% for item in site.data.navigation %}
         <a href="{{ item.link }}" {% if page.url == item.link %}style="color: red;"{% endif %}>{{ item.name }}</a>
     {% endfor %}
-</nav>
+</nav>

data/_includes/{elements/jsdelivr-combine.html → functions/js-combine.html}

@@ -12,7 +12,7 @@
     {% elsif url contains '//' %}
         <script src="{{ url }}"></script>
     {% else %}
-        <script src="{{ url | relative_url }}"></script>
+            <script src="{{ url | relative_url }}"></script>
     {% endif %}
 {% endfor %}
 {% if combined_urls %}<script src="{{ combined_urls }}"></script>{% endif %}

data/_includes/views/header-banner.html

@@ -1 +1,9 @@
-{% comment %} HEADER-BANNER {% endcomment %}
+<!-- HEADER-BANNER -->
+
+<header id="banner">
+    <div id="header">
+        {% ifhascontent header %}
+            {% contentblock header %}
+        {% endifhascontent %}
+    </div>
+</header>

data/_includes/views/header-wide.html

@@ -1 +1,9 @@
-{% comment %} HEADER-WIDE {% endcomment %}
+<!-- HEADER-WIDE -->
+
+<header id="wide">
+    <div id="header">
+        {% ifhascontent header %}
+            {% contentblock header %}
+        {% endifhascontent %}
+    </div>
+</header>

data/_includes/views/header.html

@@ -1 +1,9 @@
-{% comment %} HEADER-REGULAR {% endcomment %}
+<!-- HEADER-REGULAR -->
+
+<header id="regular">
+    <div id="header">
+        {% ifhascontent header %}
+            {% contentblock header %}
+        {% endifhascontent %}
+    </div>
+</header>

data/_layouts/error.html

@@ -2,8 +2,8 @@
 layout: compress
 ---
 <!DOCTYPE html>
-{% include elements/lang.html %}
-{% include elements/options.html %}
+{% include components/lang.html %}
+{% include components/options.html %}
 {% capture prefer_mode %}
     {% if site.theme_mode %}
         data-mode="{{ site.theme_mode }}"
@@ -12,7 +12,7 @@ layout: compress
 <html lang="{{ page.lang | default: site.lang | default: "en" }}"{{ prefer_mode }}>
     {% include head.html %}
     <body data-spy="scroll" data-target="#toc" data-navbar-visible="true">
-        {% include elements/navbar.html %}
+        {% include components/navbar.html %}
         <div id="main-wrapper" class="d-flex justify-content-center">
             <div id="main" class="container-fluid">
                 {{ content }}
@@ -21,7 +21,7 @@ layout: compress
         {% include views/footer.html %}
         {% include views/copyright.html %}
         <div id="mask"></div>
-        {% include elements/search-results.html %}
+        {% include components/search-results.html %}
         {% if site.pwa.enabled %}
         <div id="notification" class="toast" role="alert" aria-live="assertive" aria-atomic="true"
              data-animation="true" data-autohide="false">
@@ -38,7 +38,7 @@ layout: compress
             </div>
         </div>
         {% endif %}
-        {% include elements/search-loader.html %}
-        {% include elements/javascript.html %}
+        {% include components/search-loader.html %}
+        {% include components/javascript.html %}
     </body>
 </html>