jekyll-theme-nyx 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 851650d5efa1cc97127f5d3f1eddde62a88de390cfac804f024e5855b9f08d58
-  data.tar.gz: 6ce01d2cb509235544755e475e284a454391166a6a066051f5d5ce46b1858f24
+  metadata.gz: 4255ca5efed8bc6aa4c303c219117c7cd062ef2c8dc409068bdb67cb02eb7a31
+  data.tar.gz: 8db90df707ef2c6bfc92fb42eb477f869be8528534a43a602af04d6779933b9e
 SHA512:
-  metadata.gz: a5c5ca3334b4a0d834519e3c86101c20cb9f9c5bc39a40494fe6d73abf2937b394b79f5f54c6562e9f8897d573a61b5fd8eb91f03e3a2b7fa544ab2b0d3acd67
-  data.tar.gz: e8911df1667a852f94ba55a1116f2d3ea3c56faf3f92692fb27b4c90e7f0ce7ac56535eda907df7e28730d8cc89e68054c23a747ee0acf566fbbdf2c7efbab4b
+  metadata.gz: 042614cbceeeb38aeb930e4e58761fb93589b51ebfa8f573697d3fe268e255680e8c5d84ac8392ec4b2468acff3d5df2b71112cc66b1e3380c52fbede7362e33
+  data.tar.gz: fb55859fee5bbe19c7fbd7f085b2e8c9e7f9782bc3eb4645206fcba179837f74af3d0e0ad743877f0e5fb89df40c78497fcd184839e23ef56cbfc55edfb203f1

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/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/CHANGELOG.md

@@ -49,4 +49,12 @@
   - /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

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.1)
       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/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/_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/_sass/nyx/_layout.scss

@@ -75,4 +75,51 @@ main {
   margin: 0;
   color: $fg;
   line-height: 1.6;
-}
+}
+
+/* taxonomy lists (tags + categories) */
+
+.taxonomy-list {
+  list-style: none;
+  padding: 0;
+  margin: $space-4 0;
+
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(14rem, 1fr));
+  gap: $space-3;
+}
+
+.taxonomy-item {
+  background: $bg-alt;
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  border-radius: $radius;
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+
+.taxonomy-item a {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+
+  padding: $space-3;
+  text-decoration: none;
+  color: $fg;
+}
+
+.taxonomy-item:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+}
+
+.taxonomy-name {
+  font-size: 1rem;
+  font-weight: 600;
+}
+
+.taxonomy-count {
+  font-size: 0.85rem;
+  color: $muted;
+  background: rgba(255, 255, 255, 0.06);
+  padding: 0.15rem 0.5rem;
+  border-radius: 999px;
+}

data/_tabs/about.md

@@ -6,3 +6,4 @@ order: 4
 
 <h1>About</h1>
 
+This is your "about me" page, where you can add anything about yourself that you wish for the world to know. It uses the default layout rather than the post layout. Feel free to drop your work experience, resume, or just a little blurb about who you are and who you're trying to become.

data/_tabs/categories.md

@@ -6,13 +6,14 @@ order: 2
 
 <h1>Categories</h1>
 
-<div class="categories-list">
+<ul class="taxonomy-list categories-list">
   {% for category in site.categories %}
-    {% assign category_name = category[0] %}
-    <li>
-      <a href="{{ '/categories/' | append: category_name | slugify | append: '/' | relative_url }}">
-        {{ category_name }} ({{ category[1].size }})
+    {% assign name = category[0] %}
+    <li class="taxonomy-item">
+      <a href="{{ '/categories/' | append: name | downcase | append: '/' | relative_url }}">
+        <span class="taxonomy-name">{{ name }}</span>
+        <span class="taxonomy-count">{{ category[1].size }}</span>
       </a>
     </li>
   {% endfor %}
-</div>
+</ul>

data/_tabs/tags.md

@@ -6,13 +6,14 @@ order: 3
 
 <h1>Tags</h1>
 
-<div class="tags-list">
+<ul class="taxonomy-list tags-list">
   {% for tag in site.tags %}
-    {% assign tag_name = tag[0] %}
-    <li>
-      <a href="{{ '/tags/' | append: tag_name | slugify | append: '/' | relative_url }}">
-        {{ tag_name }} ({{ tag[1].size }})
+    {% assign name = tag[0] %}
+    <li class="taxonomy-item">
+      <a href="{{ '/tags/' | append: name | append: '/' | relative_url }}">
+        <span class="taxonomy-name">{{ name }}</span>
+        <span class="taxonomy-count">{{ tag[1].size }}</span>
       </a>
     </li>
   {% endfor %}
-</div>
+</ul>

data/jekyll-theme-nyx.gemspec

@@ -1,44 +1,42 @@
 # frozen_string_literal: true
 
 Gem::Specification.new do |spec|
-  spec.name = "jekyll-theme-nyx"
-  spec.version = "0.3.0"
-  spec.authors = ["Slavetomints"]
-  spec.email = ["me@slavetomints.com"]
+  spec.name = 'jekyll-theme-nyx'
+  spec.version = '0.3.1'
+  spec.authors = ['Slavetomints']
+  spec.email = ['me@slavetomints.com']
 
-  spec.summary = "Simple Jekyll Theme"
+  spec.summary = 'Simple Jekyll Theme'
   spec.description = <<~DESC
-  Nyx is a dark mode based Jekyll theme focused on readability,
-  clean typography, and simple blogging.
+    Nyx is a dark mode based Jekyll theme focused on readability,
+    clean typography, and simple blogging.
   DESC
-  spec.homepage = "https://github.com/Slavetomints/jekyll-theme-nyx"  
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.homepage = 'https://github.com/Slavetomints/jekyll-theme-nyx'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 3.1.0'
 
-  spec.metadata["rubygems_mfa_required"] = "true"
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
-  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
-  spec.metadata["documentation_uri"] = "#{spec.homepage}#readme"
-  spec.metadata["theme"] = "true"
-  spec.metadata["jekyll_theme"] = "true"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
+  spec.metadata['documentation_uri'] = "#{spec.homepage}#readme"
+  spec.metadata['theme'] = 'true'
+  spec.metadata['jekyll_theme'] = 'true'
 
-  
-  spec.add_runtime_dependency "jekyll", "~> 4.0"
+  spec.add_dependency 'jekyll', '~> 4.0'
 
   spec.cert_chain  = ['certs/slavetomints.pem']
-  spec.signing_key = File.expand_path("~/.ssh/gem-private_key.pem") if $0 =~ /gem\z/
+  spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem') if $0 =~ /gem\z/
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
-  ls.readlines("\x0", chomp: true).select do |f|
-    # Only include files that actually exist
-    File.file?(File.join(__dir__, f))
+    ls.readlines("\x0", chomp: true).select do |f|
+      # Only include files that actually exist
+      File.file?(File.join(__dir__, f))
     end
   end
 
-  spec.require_paths = ["lib"]
-
+  spec.require_paths = ['lib']
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-nyx
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Slavetomints
@@ -60,9 +60,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/ISSUE_TEMPLATE/bug_report.md"
-- ".github/ISSUE_TEMPLATE/feature_request.md"
-- ".github/workflows/main.yml"
+- ".github/CONTRIBUTING.MD"
+- ".github/ISSUE_TEMPLATE/bug_report.yml"
+- ".github/ISSUE_TEMPLATE/config.yml"
+- ".github/ISSUE_TEMPLATE/feature_request.yml"
+- ".github/pull_request_template.md"
+- ".github/workflows/build-and-deploy.yml"
 - ".gitignore"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -71,10 +74,14 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- SECURITY.md
 - _config.yml
 - _includes/header.html
+- _layouts/category.html
 - _layouts/default.html
 - _layouts/post.md
+- _layouts/tag.html
+- _plugins/taxonomy_pages.rb
 - _posts/2026-01-02-markdown-showcase.md
 - _sass/nyx/_base.scss
 - _sass/nyx/_code.scss

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,38 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.