jekyll-theme-endless 0.22.1 → 0.22.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2bf0edf38013ffa34b724a1046c264cbfa759a9fb31e76e3068e7edca0685718
-  data.tar.gz: 6b1eed3a9e25ce6d612aba9afbc5ee515182ca2a3e9683567c16727ee3389a18
+  metadata.gz: 45d9b6fa2835d2da886589f693ab08be0b4982c80ed0e10aff4494f5a940eed9
+  data.tar.gz: f173fb8e45e722a6ca068b0125ca55141c1a7c3e5d65679d620cfc624e03e5fe
 SHA512:
-  metadata.gz: af969c9e3f68aa43bccb44b1d6529b84955d7e359e2485677a8a21a0624f6497b53ba55eb8357cffc27484ed929ea811f1fd99aab7be0b0f29988dfb641b608f
-  data.tar.gz: 0b2ff329554f10fbe13e7b163d21de205f09e5ea785e14d2ca3d218f7986c45b3044686fcad740149dbf0cd0de69f568074b3816bce1b97da5aa105d55afdda9
+  metadata.gz: afa01141a8c7746f8ac0f77780c5d9436ff09257bf3e7560290d76fde2ff994e9094669dfb375bf2d47b7fe21fdb37b9a38836ea7f0851d5a5e0e44113f3f234
+  data.tar.gz: f705d71913dc5e4ed28696fc4d6598ded960c2b37c36c92d57615ad7b3c9ac20489cb77d7183d9f854235cd1d89f7f402690608bcfaab59aeab2b3dadb81c8e6

data/lib/jekyll-theme-endless/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
 	module Endless
-		VERSION = '0.22.1'
+		VERSION = '0.22.2'
 	end
 end

data/pages_examples/showroom-asciidoc.adoc

@@ -9,6 +9,11 @@
 :toc: preamble
 :toclevels: 5
 :page-summary: "Discover the AsciiDoc showroom: See what's possible with AsciiDoc in this theme, including code, tables, lists, quotes, and more for advanced formatting."
+// The Liquid page variable ensures that the Liquid preprocessor is also applied to AsciiDoc files.
+// https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#enabling-liquid-preprocessing
+// This is required in this specific case because I need to access the content of the Jekyll variable `site.destination` within this document.
+// See the comments in the [[meme]] section for more details.
+:page-liquid:
 
 
 
@@ -396,6 +401,9 @@ The result is:
 
 == Images
 
+// NOTE:
+// The image originates from the theme’s assets folder and is added to your blog during the build process.
+
 // AsciiDoc commands are not stripped/processed when used within `alt=""`.
 :pic_1_src: /assets/images/tree-3822149_640.jpg
 :pic_1_title: Image by https://pixabay.com/de/users/jplenio-7645255/[jplenio] published on https://pixabay.com/de/[Pixabay].
@@ -1191,9 +1199,26 @@ qrcode::This QR code is generated with Asciidoctor Diagram and presented in PNG
 
 The https://docs.asciidoctor.org/diagram-extension/latest/diagram_types/meme/[meme extension] is based on https://imagemagick.org/[ImageMagick] and is used to create simple memes with text overlaid on images.
 
-:pic_2_src: ../assets/images/cat.jpg
+// In this example, I want to create a meme using an image that is packaged within the jekyll-theme-endless theme.
+// This image is copied into the build folder (by default `_site`) during the build process.
+// The meme extension needs to know the location of this image within the build directory.
+// Since the build path can change, for example through the `-d` parameter, you should not hardcode `_site` here.
+// The current build directory is stored in the Jekyll variable `site.destination`.
+// See: https://jekyllrb.com/docs/configuration/options/
+// This variable can be accessed using Liquid syntax via `{{ site.destination }}`.
+// However, Liquid commands are not processed in AsciiDoc documents by default.
+// To enable the Liquid preprocessor for this document, you need to set the `:page-liquid:` attribute in the document header.
+// See: https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#enabling-liquid-preprocessing
+// During the build process, the Liquid preprocessor runs first, followed by the AsciiDoc processor.
+//
+// I assume that this approach will rarely be needed in practice.
+// Nevertheless, it provides a good insight into how Jekyll builds work and how AsciiDoc files are processed.
+// So, unless you specifically want to use one of the images packaged with the jekyll-theme-endless theme for your memes,
+// you can simply remove the `:page-liquid:` attribute and specify a path without using the Liquid variable {{ site.destination }}.
+
+:pic_2_src: {{ site.destination }}/assets/images/cat.jpg
 
-.Example of a meme created with the Meme diagram type, featuring an image of a cat with overlaid text at the top and bottom. The text is styled with a stroke width of 2 and a white fill color to enhance visibility against the background image.
+.Example of a meme created with the Meme diagram type, featuring an image of a cat with overlaid text at the top and bottom. The text is styled with a stroke width of 2 and a white fill color to enhance visibility against the background image. During the build process the source image was available at: `{pic_2_src}`.
 meme::{pic_2_src}[Markdown? // Really?, Did you understand // a single word written here?, stroke-width=2, fill-color=white]
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-endless
 version: !ruby/object:Gem::Version
-  version: 0.22.1
+  version: 0.22.2
 platform: ruby
 authors:
 - Sven Boekhoff