monoholic 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82d9f14b72e9e12fbd2938a1e085e139cd3a8b1de2415914ee8aede7be2363b2
-  data.tar.gz: d440773f3a4ace2da0bc9906ef8ee4a847d557eee3e4967392d0d660f8b29e2f
+  metadata.gz: 7ee37aea1bd4ecf60b33567d582c4363961f49364bd2176f42e8b0de8aaa12ce
+  data.tar.gz: a00389e09ed54a0d268694fc002614cd0eca0820555d6f888d4442d22e353a34
 SHA512:
-  metadata.gz: 97ed2791cf9e2ec59c07724bfb7804565a0b71a02ca625f41f5b5fcfacf042def622fdec81d74245790907d2eb0b9932523819decd1589a8137d0e582ab6694c
-  data.tar.gz: 4773401bdc07a85bf3a819edeef94c9d20354c60c9d806db2a66c604f51c59f637f2e40e34cf753fe2d364415102a4953b845190d4c9b675e483cbb73f682cb8
+  metadata.gz: 47a614360018402b6e397fb4e8f6d16cb267919176a479dbb3c6ac58c68d4c605af839e84379fc84eca2ffb36ab77ab77c546521cd5e77cb3366ac1e561fa868
+  data.tar.gz: cd0c4518e8d0e39ddfe00c56a8311c63d375c5ee749313e15be1ad4a29316ec36321fd4219b2900b7475b9287a5e57811e8f2c685a4f3d2fbfeec85a8ffde0be

data/README.md

@@ -6,7 +6,7 @@
 [![Gem Version](https://img.shields.io/gem/v/monoholic?color=black)](https://rubygems.org/gems/monoholic)
 [![GitHub Pages](https://img.shields.io/badge/GitHub_Pages-ready-black?logo=github&logoColor=white)](https://stiermid.github.io/monoholic)
 
-A minimal, monochrome dark Jekyll theme🧪
+A minimal, monochrome dark Jekyll theme
 
 ## Features
 
@@ -38,14 +38,27 @@ theme: monoholic
 $ bundle install
 ```
 
-### Manual Installation
+### Manual Installation (GitHub Pages)
 
 If you're running Jekyll without RubyGems or prefer to use GitHub Pages remote themes, update your `_config.yml`:
 
 ```yaml
 remote_theme: stiermid/monoholic
+plugins:
+  - jekyll-remote-theme
+  - jekyll-feed
+  - jekyll-seo-tag
 ```
 
+`jekyll-remote-theme` fetches the theme on Pages; `jekyll-feed` and `jekyll-seo-tag` are required by the theme's `head.html` (`{% feed_meta %}`, `{% seo %}`). For project sites, also set `baseurl` (e.g. `/your-repo`) and `url` (e.g. `https://<user>.github.io`). To pin a release: `remote_theme: stiermid/monoholic@v1.2.0`.
+
+> **Pages note:** Native GitHub Pages builds run Jekyll 3.9. The `monoholic` RubyGem requires Jekyll 4.4, so on GitHub Pages use `remote_theme` only (not `theme:` + `gem "monoholic"`). SCSS intentionally uses `@import` for 3.9 compatibility.
+
+| Install method                                           | Jekyll        | How                         |
+| -------------------------------------------------------- | ------------- | --------------------------- |
+| RubyGems (`theme: monoholic`)                            | 4.4           | local / CI / non-Pages host |
+| GitHub Pages (`remote_theme: stiermid/monoholic@v1.2.0`) | 3.9 via Pages | Pages only                  |
+
 Or, simply fork this repository, adapt the `_config.yml` according to your needs, and you're good to go!
 
 ## Usage
@@ -60,8 +73,8 @@ Override the default settings in your `_config.yml`. Key theme configuration opt
 
 ```yaml
 theme_config:
-  back: ".." # Text for backlink on post pages
-  date_format: "%Y%m%d" # Date format for post metadata
+  back: "Back" # Text for backlink on post pages
+  date_format: "%Y-%m-%d" # Date format for post metadata
   monochrome_images: true # Apply grayscale filter to images (default: true)
   footer: true # Show/hide site footer (default: true)
 ```
@@ -77,7 +90,7 @@ fediverse_creator: "@username@social.example.com"
 Setting `fediverse_creator` tag appends following tag to the site's header:
 
 ```html
-<meta name="fediverse:creator" content="@username@social.example.com">
+<meta name="fediverse:creator" content="@username@social.example.com" />
 ```
 
 [See Also](https://docs.joinmastodon.org/user/profile/#attribution)
@@ -142,18 +155,20 @@ Monoholic ships with a default favicon. To use your own, replace the following f
 
 ### Stylesheet
 
-Monoholic's stylesheet is written in SCSS and compiled at build time. The source lives in `_sass/` and is loaded from `assets/css/style.scss`. Compilation is handled by `jekyll-sass-converter`, which is declared as a runtime dependency in the theme's `gemspec` — so no extra setup is required when you add `gem "monoholic"` to your `Gemfile`.
+Monoholic's stylesheet is written in SCSS and compiled at build time. The source lives in `_sass/` and is imported from `assets/css/style.scss`. Compilation is handled by `jekyll-sass-converter`, which is declared as a runtime dependency in the theme's `gemspec` — so no extra setup is required when you add `gem "monoholic"` to your `Gemfile`.
 
-If you want to override or extend the styles, the recommended approach is to add your own partials in your site's `_sass/` directory and load them **after** the theme's entry point:
+If you want to override or extend the styles, the recommended approach is to add your own partials in your site's `_sass/` directory and import them **after** the theme's entry point:
 
 ```scss
 ---
 ---
 
-@use "monoholic";
-@use "your-overrides";
+@import "monoholic";
+@import "your-overrides";
 ```
 
+Note: the theme uses `@import` (not `@use`) to stay compatible with GitHub Pages' Sass stack.
+
 To override CSS custom properties (colors, spacing, fonts) without touching SCSS, redeclare the variables in your own stylesheet — they are exposed under `:root` in `_sass/_variables.scss`.
 
 ### Per-Page JavaScript

data/_includes/head.html

@@ -2,6 +2,8 @@
   <meta charset="utf-8">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="theme-color" content="#030303">
+  <meta name="color-scheme" content="dark">
 
   {%- if site.fediverse_creator -%}
     <meta
@@ -39,6 +41,7 @@
   >
   <link
     rel="apple-touch-icon"
+    sizes="180x180"
     href="{{ "/assets/apple-touch-icon.png" | relative_url }}"
   >
   {%- feed_meta -%}

data/_includes/post_list.html

@@ -8,7 +8,7 @@
         {% assign _date_fmt = site.theme_config.date_format
           | default: '%Y-%m-%d'
         %}
-        * {{ post.date | date: _date_fmt }}
+        {{ post.date | date: _date_fmt }}
       </time>
       <a href="{{ post.url | relative_url }}">
         {{ post.title | escape }}

data/_layouts/default.html

@@ -4,7 +4,9 @@
   <body class="{% if site.theme_config.monochrome_images != false %}images-monochrome{% endif %}">
     <a class="skip-link" href="#main">Skip to content</a>
     <div class="wrapper">
-      {%- include header.html -%}
+      {%- unless page.layout == 'post' -%}
+        {%- include header.html -%}
+      {%- endunless -%}
       <main id="main" class="page-content">
         {{ content }}
       </main>
@@ -17,7 +19,7 @@
     {% if page.custom_js %}
       {% for js_file in page.custom_js %}
         <script
-          type="text/javascript"
+          defer
           src="{{ '/assets/js/' | append: js_file | append: '.js' | relative_url }}"
         ></script>
       {% endfor %}

data/_sass/_components.scss

@@ -9,6 +9,13 @@
     align-items: baseline;
     gap: var(--space-md);
     flex-wrap: wrap; // Mobile safety
+
+    &::before {
+      content: "*";
+      color: var(--meta-color);
+      // Keep marker snug to the date (flex `gap` would push it too far).
+      margin-right: calc(1ch - var(--space-md));
+    }
   }
 
   .post-meta {

data/_sass/monoholic.scss

@@ -1,6 +1,6 @@
 // monoholic.scss
-@use "variables";
-@use "base";
-@use "content";
-@use "layout";
-@use "components";
+@import "variables";
+@import "base";
+@import "content";
+@import "layout";
+@import "components";

data/assets/css/style.scss

@@ -1,4 +1,4 @@
 ---
 ---
 
-@use "monoholic";
+@import "monoholic";

data/assets/favicon.svg

@@ -1,58 +1 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="32"
-   height="32"
-   viewBox="0 0 32 32"
-   version="1.1"
-   id="svg1"
-   inkscape:version="1.4.4 (dcaf3e7d9e, 2026-05-05)"
-   sodipodi:docname="icon.svg"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview1"
-     pagecolor="#505050"
-     bordercolor="#eeeeee"
-     borderopacity="1"
-     inkscape:showpageshadow="0"
-     inkscape:pageopacity="0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#505050"
-     inkscape:document-units="px"
-     inkscape:zoom="16"
-     inkscape:cx="8.125"
-     inkscape:cy="19.59375"
-     inkscape:window-width="1918"
-     inkscape:window-height="1052"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="layer1" />
-  <defs
-     id="defs1" />
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1">
-    <path
-       style="font-size:48px;font-family:Monospace;-inkscape-font-specification:Monospace"
-       d="M 4.4799998,27.981593 V 4.4984075 h 3.744 c 0,0 0.72,1.36 1.488,0.624 0.8000002,-0.736 1.8080002,-1.104 3.0240002,-1.104 1.152,0 2.128,0.336 2.928,1.008 0.8,0.672 2.496,0.672 3.264,0 0.8,-0.672 1.808,-1.008 3.024,-1.008 1.696,0 3.04,0.64 4.032,1.92 1.024,1.248 1.536,2.88 1.536,4.8960005 V 27.981593 H 23.488 V 10.786408 c 0,-1.0560005 -0.256,-1.8880005 -0.768,-2.4960005 -0.512,-0.64 -1.216,-0.96 -2.112,-0.96 -0.864,0 -1.552,0.304 -2.064,0.912 -0.512,0.608 -0.768,1.44 -0.768,2.4960005 V 27.981593 H 14.224 V 10.786408 c 0,-1.0560005 -0.256,-1.8880005 -0.768,-2.4960005 -0.512,-0.64 -1.2,-0.96 -2.064,-0.96 -0.896,0 -1.6000002,0.304 -2.1120002,0.912 -0.512,0.608 -0.768,1.44 -0.768,2.4960005 v 17.243185 z"
-       id="text2"
-       aria-label="m"
-       sodipodi:nodetypes="ccccsscscsccscsssccscssscc" />
-    <text
-       xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:48px;font-family:Monospace;-inkscape-font-specification:Monospace;writing-mode:lr-tb;direction:ltr;fill:#000000"
-       x="-171.11984"
-       y="24.041632"
-       id="text3"><tspan
-         sodipodi:role="line"
-         id="tspan2"
-         x="-171.11984"
-         y="24.041632" /></text>
-  </g>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img"><title>m</title><path fill="#fff" d="M 4.4799998,27.981593 V 4.4984075 h 3.744 c 0,0 0.72,1.36 1.488,0.624 0.8000002,-0.736 1.8080002,-1.104 3.0240002,-1.104 1.152,0 2.128,0.336 2.928,1.008 0.8,0.672 2.496,0.672 3.264,0 0.8,-0.672 1.808,-1.008 3.024,-1.008 1.696,0 3.04,0.64 4.032,1.92 1.024,1.248 1.536,2.88 1.536,4.8960005 V 27.981593 H 23.488 V 10.786408 c 0,-1.0560005 -0.256,-1.8880005 -0.768,-2.4960005 -0.512,-0.64 -1.216,-0.96 -2.112,-0.96 -0.864,0 -1.552,0.304 -2.064,0.912 -0.512,0.608 -0.768,1.44 -0.768,2.4960005 V 27.981593 H 14.224 V 10.786408 c 0,-1.0560005 -0.256,-1.8880005 -0.768,-2.4960005 -0.512,-0.64 -1.2,-0.96 -2.064,-0.96 -0.896,0 -1.6000002,0.304 -2.1120002,0.912 -0.512,0.608 -0.768,1.44 -0.768,2.4960005 v 17.243185 z"/></svg>

data/assets/js/.keep

@@ -0,0 +1,5 @@
+# Placeholder to keep assets/js/ in version control.
+# Per-page scripts referenced via `custom_js` front matter live here,
+# e.g. `assets/js/my-script.js` loaded with:
+#   custom_js:
+#     - my-script

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: monoholic
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Agil Mammadov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-12 00:00:00.000000000 Z
+date: 2026-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -93,10 +93,9 @@ files:
 - _sass/monoholic.scss
 - assets/apple-touch-icon.png
 - assets/css/style.scss
-- assets/favicon-16x16.png
-- assets/favicon-32x32.png
 - assets/favicon.ico
 - assets/favicon.svg
+- assets/js/.keep
 homepage: https://github.com/stiermid/monoholic
 licenses:
 - GPL-3.0-only