jekyll-theme-nyx 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 851650d5efa1cc97127f5d3f1eddde62a88de390cfac804f024e5855b9f08d58
-  data.tar.gz: 6ce01d2cb509235544755e475e284a454391166a6a066051f5d5ce46b1858f24
+  metadata.gz: 5ab7195379e8817b601219399c2271e9765892e7516433d6f994ed79fe38baa7
+  data.tar.gz: 825f6b09c84bbfa339a539191dc85ff886506fd69c50171379b0d3b8b29e9232
 SHA512:
-  metadata.gz: a5c5ca3334b4a0d834519e3c86101c20cb9f9c5bc39a40494fe6d73abf2937b394b79f5f54c6562e9f8897d573a61b5fd8eb91f03e3a2b7fa544ab2b0d3acd67
-  data.tar.gz: e8911df1667a852f94ba55a1116f2d3ea3c56faf3f92692fb27b4c90e7f0ce7ac56535eda907df7e28730d8cc89e68054c23a747ee0acf566fbbdf2c7efbab4b
+  metadata.gz: '097db29ccfb45115207657e35685e18120341b4038307971b1fff4e194b582e6c5875528cc27973f9d2a0d5e447ed31cc26dd4dca7093a0363d000ce6191c0ba'
+  data.tar.gz: 6bf00bb8246da8a62ee601611a2f61725be58e03ff8fe1375a6e921b1ae3ae18718e6061c7335d2d0df397eb7f7aa7ee54f36e9a9fa59224b80c2e62612992b5

data/{CHANGELOG.md → .github/CHANGELOG.md}

@@ -49,4 +49,23 @@
   - /posts/
   - /tags/
   - /categories/
-  - /about/
+  - /about/
+
+#### [0.3.1] - 2026-01-06
+- Added Pull Request Templates
+- Moved the Issue templates to `yml`
+- Create plugin to generate subpages for tags and categories
+  - added styling for tag and category tabs
+- Added Contribution guide
+- Added Security policy
+
+#### [0.3.2] - 2026-01-09
+
+**BUGS**
+- Fixed [Issue with selecting post in the posts tab](https://github.com/Slavetomints/jekyll-theme-nyx/issues/13)
+
+**ENHANCEMENTS**
+- Implemented [Add more demo posts](https://github.com/Slavetomints/jekyll-theme-nyx/issues/14)
+
+**MISC**
+- Cleaned up repo root by moving files to `.github`

data/.github/CONTRIBUTING.MD

@@ -0,0 +1,107 @@
+# Contributing to Nyx
+
+First of all, thanks for contributing!
+
+## How to Contribute (High Level)
+
+1. **Identify a problem or improvement**
+2. **Open or claim an issue**
+3. **Fork the repo**
+4. **Create a branch**
+5. **Make your changes**
+6. **Open a pull request**
+
+If you do not open or claim an issue, your pull request will likely be rejected.
+
+---
+
+## Issues Come First
+
+Before you open a PR, **there should be an issue**.
+
+This applies if you are:
+- Fixing a bug
+- Adding a feature
+- Refactoring existing behavior
+- Changing styling, layout, or structure in a non-trivial way
+
+### Why?
+- It prevents duplicate work
+- It lets us agree on direction before code is written
+- It gives context to your PR
+- It creates a paper trail for future contributors
+
+### What to do:
+- If an issue already exists comment on it and say you’re working on it
+- If no issue exists open one
+- If you’re unsure open an issue anyway and ask
+
+> Small things like typo fixes can skip the issue step. Use your judgment.
+
+---
+
+## Fork & Branch
+
+1. Fork the repository
+2. Clone your fork locally
+3. Create a branch from `main`
+
+```bash
+git checkout -b fix/my-short-description
+```
+
+Please use clear branch names.
+
+## Making Changes
+
+A few expectations:
+
+- Follow the existing code style
+- Don’t reformat unrelated files
+- Keep commits focused and meaningful
+- If you change behavior, explain why in the commit or PR
+
+If your change affects:
+- layout
+- tags/categories
+- syntax highlighting
+- build behavior
+
+…please call that out clearly in your PR description.
+## Testing
+
+Before opening a PR:
+
+- Run the site locally with `bundle exec jekyll serve`
+- Click around
+- Check mobile widths
+- Verify tags, categories, and posts still render correctly
+
+## Opening a Pull Request
+
+When opening your PR:
+
+- Reference the issue it fixes (e.g. Fixes #12)
+- Explain what you changed
+- Explain why you changed it
+- Include screenshots if it’s visual
+- Keep it scoped — one PR, one purpose
+
+Please fill out the PR template when opening a pull request. That helps us with understanding what your PR is trying to do. PRs without context or without an associated issue may be closed or sent back for clarification.
+
+# Philosophy
+
+Nyx aims to be:
+
+- Minimal
+- Understandable
+- Hackable without too many plugins
+- Predictable in structure
+
+If your contribution makes things more magical but harder to reason about, it probably doesn’t fit. If you’re unsure, open an issue and ask.
+
+---
+
+Thanks again for contributing 💜
+
+---

data/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug Report
+description: Create a report to help us improve
+labels:
+  - bug
+body:
+  - type: textarea
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps To Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. In this environment...
+        2. With this config...
+        3. Run '...'
+        4. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected Behavior
+      description: A concise description of what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Environment
+      value: |
+        - Ruby: <!-- run `ruby -v` -->
+        - Jekyll: <!-- run `bundle exec jekyll -v` -->
+        - Nyx: <!-- run `bundle info jekyll-theme-nyx` -->
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Anything else?
+      description: |
+        Add any extra context here.
+        Logs, screenshots, or weird edge cases welcome.

data/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

data/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,28 @@
+name: Feature Request
+description: Suggest an idea for this project
+labels:
+  - enhancement
+body:
+  - type: textarea
+    attributes:
+      label: Is your feature request related to a problem? Please describe
+      description: A clear and concise description of what the problem is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.

data/.github/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported Versions
+
+<!--| Version | Supported          |
+| ------- | ------------------ |
+| 5.1.x   | :white_check_mark: |
+| 5.0.x   | :x:                |
+| 4.0.x   | :white_check_mark: |
+| < 4.0   | :x:                |-->
+
+The most recent major release is supported.
+
+## Reporting a Vulnerability
+
+If you find a vulnerability, please email me at me@slavetomints.com. You can expect to receive a response within a week. If your vulnerability is accepted you will be credited on the demo site after it has been patched.

data/.github/pull_request_template.md

@@ -0,0 +1,31 @@
+## jekyll-theme-nyx Pull Request
+
+Thanks for contributing. Fill this out so future-you doesn't hate past-you.
+
+## What does this PR do?
+<!-- Short, clear explanation of the change. -->
+
+
+## Link to the relevant issue
+<!-- All changes must be discussed in an issue first. Failure to do so may result in your Pull Request being rejected -->
+fixes #<!--issue ID here-->
+
+## List the main changes.
+<!-- For example: "Added new tab layout", "Fixed Rouge highlighting", "Cleaned up SCSS variables" -->
+
+
+## Type of Change
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Refactor / Cleanup
+- [ ] Docs only
+
+## Checklist
+
+- [ ] Code builds without errors (`rake site`)
+- [ ] Tested locally with Jekyll
+- [ ] No unnecessary files committed
+
+## Additional Notes
+<!-- Anything reviewers should know? Edge cases, follow-ups, known issues. -->

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in jekyll-theme-nyx.gemspec
-gemspec
+gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    jekyll-theme-nyx (0.3.0)
+    jekyll-theme-nyx (0.3.2)
       jekyll (~> 4.0)
 
 GEM

data/Rakefile

@@ -1,46 +1,46 @@
 # frozen_string_literal: true
 
-require "rake"
-require "fileutils"
+require 'rake'
+require 'fileutils'
 
-GEMSPEC = "jekyll-theme-nyx.gemspec"
+GEMSPEC = 'jekyll-theme-nyx.gemspec'
 
 # Helper to get current version from gemspec
 def current_version
   File.read(GEMSPEC)[/spec\.version\s*=\s*["'](.*?)["']/, 1]
 end
 
-GEM_NAME = GEMSPEC.sub(/\.gemspec$/, "")
-GEM_FILE = "#{GEM_NAME}-#{current_version}.gem"
+GEM_NAME = GEMSPEC.sub(/\.gemspec$/, '')
+GEM_FILE = "#{GEM_NAME}-#{current_version}.gem".freeze
 
-desc "Build dummy site to verify theme"
+desc 'Build dummy site to verify theme'
 task :site do
-  sh "bundle install"
-  sh "bundle exec jekyll build"
-  puts "[+] Dummy site builds successfully"
+  sh 'bundle install'
+  sh 'bundle exec jekyll build'
+  puts '[+] Dummy site builds successfully'
 end
 
-desc "Build the gem"
+desc 'Build the gem'
 task :build do
   sh "gem build #{GEMSPEC}"
   puts "[+] Built #{GEM_FILE}"
 end
 
-desc "Push gem to RubyGems"
+desc 'Push gem to RubyGems'
 task :push do
   sh "gem push #{GEM_FILE}"
 end
 
-desc "Create and push git tag"
+desc 'Create and push git tag'
 task :tag do
   sh "git tag v#{current_version}"
   sh "git push origin v#{current_version}"
 end
 
-desc "Full release: site build, gem build, push, tag"
+desc 'Full release: site build, gem build, push, tag'
 task release: [:site] do
-  sh "rake build"
-  sh "rake push"
-  sh "rake tag"
+  sh 'rake build'
+  sh 'rake push'
+  sh 'rake tag'
   puts "[+] Released #{GEM_NAME} v#{current_version}"
 end

data/_config.yml

@@ -24,3 +24,11 @@ collections:
     output: true
     permalink: /:name/
     sort_by: order
+
+defaults:
+  - scope:
+      path: ""
+      type: posts
+    values: 
+      layout: post
+      permalink: /posts/:title/

data/_layouts/category.html

@@ -0,0 +1,19 @@
+---
+layout: default
+---
+
+<h1>Category: {{ page.category }}</h1>
+
+<ul class="post-list">
+  {% for post in page.posts %}
+    <li class="post-item">
+      <h2>
+        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+      </h2>
+      <time>{{ post.date | date: "%B %d, %Y" }}</time>
+      {% if post.description %}
+        <p>{{ post.description | strip_html }}</p>
+      {% endif %}
+    </li>
+  {% endfor %}
+</ul>

data/_layouts/tag.html

@@ -0,0 +1,19 @@
+---
+layout: default
+---
+
+<h1>Tag: {{ page.tag }}</h1>
+
+<ul class="post-list">
+  {% for post in page.posts %}
+    <li class="post-item">
+      <h2>
+        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+      </h2>
+      <time>{{ post.date | date: "%B %d, %Y" }}</time>
+      {% if post.description %}
+        <p>{{ post.description | strip_html }}</p>
+      {% endif %}
+    </li>
+  {% endfor %}
+</ul>

data/_plugins/taxonomy_pages.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Jekyll
+  class TaxonomyPages < Generator
+    safe true
+
+    def generate(site)
+      site.tags.each do |tag, posts|
+        site.pages << TaxonomyPage.new(
+          site,
+          site.source,
+          File.join('tags', tag.downcase.gsub(' ', '-')),
+          'tag.html',
+          tag,
+          posts
+        )
+      end
+
+      site.categories.each do |category, posts|
+        site.pages << TaxonomyPage.new(
+          site,
+          site.source,
+          File.join('categories', category.downcase.gsub(' ', '-')),
+          'category.html',
+          category,
+          posts
+        )
+      end
+    end
+  end
+
+  class TaxonomyPage < Page
+    def initialize(site, base, dir, layout, name, posts)
+      @site = site
+      @base = base
+      @dir  = dir
+      @name = 'index.html'
+
+      process(@name)
+      read_yaml(File.join(base, '_layouts'), layout)
+
+      data['posts'] = posts
+      data[layout.sub('.html', '')] = name
+      data['title'] = name
+    end
+  end
+end

data/_posts/{2026-01-02-markdown-showcase.md → 2026-01-02-showcase-post.md}

@@ -1,11 +1,10 @@
 ---
-title: Markdown Showcase
-layout: post
+title: Post Showcase
 author: Slavetomints
 date: 2026-01-02
-categories: [Blog]
-tags: [blog, help]
-description: Showcase of the how markdown looks on this site
+categories: [Demos]
+tags: [demo, markdown]
+description: Showcase of the how posts look on this site
 ---
 
 ## Headers