jekyll-theme-endless 0.18.1 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdc2e7fa0bbc121bd98c151ae080b61aa7d7d73859812642950e7e1d412732a6
-  data.tar.gz: 2efbe54fb9b326749e2c87868700e37cc58d989945a2f560dc7ccb348929d808
+  metadata.gz: 4e5ff4a4e9f3b7bb21ec91c0c9b501f299e50305551feaefe819f903a48e84c1
+  data.tar.gz: 32a9bb1812ac5eb4219fe3066a7680a7f4143b45e8409155b9e65931817bdc40
 SHA512:
-  metadata.gz: a413c6f3fedbb0cb8280e83764c93d03a639e7aa08d4417625dcb9145e99127c7169b9348e276904935a468946a20ca4ed8d75544c8385f2d6ff7569778616a3
-  data.tar.gz: f921a4f43e58ed38eb89ea3c19071819870d41328043e6aaacf5ac10dc96c3525a67285c6aff1ceecbed01fd2fe14efbd61976baf2fd85a04fc2b08757e92133
+  metadata.gz: 84a36eadac4ae05a13c9a0985857f13b8a7f6c78e1399c25a1ca914d7120a6f0c2539bc92e1683a4e83f2ed46817f4d0ee2db18d2165733165b5b1ed7493cc5f
+  data.tar.gz: d606eb76dfcdf45a8238148eb263dd2062f9ca5ee2095a5521c11f3122fd4168adc886ee66ebbfaa2c4fe4f7c34b59d85c6398bc36c5a0052009076ca9d16265

data/README.adoc

@@ -105,12 +105,12 @@ If you want to use Markdown AND have HTML-commands in the title, simply escape t
 
 == Example posts and pages
 
-The project repository contains
+The project repository contains:
 
-* Two example posts with examples and explanations on which front matter variables you can use in posts and pages, and how to use them.
+* Two example **posts** with examples and explanations on which front matter variables you can use in posts and pages, and how to use them.
 ** link:/asciidoc-example/[Example post for AsciiDoc with explanations]
 ** link:/markdown-example/[Example post for Markdown with explanations]
-* Two example pages (the showrooms) where you can explore the features of Markdown and AsciiDoc. In the source code, you can see how to implement these yourself.
+* Two example **pages** (the showrooms) where you can explore the features of Markdown and AsciiDoc. In the source code, you can see how to implement these yourself.
 ** link:/asciidoc-showroom/[AsciiDoc Showroom]
 ** link:/markdown-showroom/[Markdown Showroom]
 
@@ -387,9 +387,27 @@ I typically use this page as a layout for my "about" page.
 
 === Includes
 
+`_includes/aside_top.html`::
++
+--
+The first of four elements displayed alongside the page content (or at the end of the page on mobile devices).
+This can be used for a more complex blog navigation e.g. if you use many pages in hierarchical structures.
+It's best practice to wrap the content in an `<aside>` element, as shown below.
+
+[source, html]
+----
+<aside>
+	<h3>Page Navigation</h3>
+	<div class="col">
+		Navigation links go here
+	</div>
+</aside>
+----
+--
+
 `_includes/aside_navigation.html`::
 
-The first of three elements displayed alongside the page content (or at the end of the page on mobile devices).
+The second of four elements displayed alongside the page content (or at the end of the page on mobile devices).
 This typically contains blog navigation elements such as 'Recent Articles,' 'Tag Cloud,' etc.
 It's best practice to wrap the content in an `<aside>` element.
 
@@ -397,14 +415,14 @@ It's best practice to wrap the content in an `<aside>` element.
 
 `_includes/aside_info.html`::
 
-The second of the three elements, typically providing additional information about the blog (e.g., a link to the RSS feed).
+The third of the four elements, typically providing additional information about the blog (e.g., a link to the RSS feed).
 This content is also ideally wrapped in an `<aside>` element.
 
 
 
 `_includes/aside_more.html`::
 
-The third of the three elements is typically used to display links to partner sites, sponsorships, or advertisements relevant to the blog's audience.
+The fourth of the four elements is typically used to display links to partner sites, sponsorships, or advertisements relevant to the blog's audience.
 Similar to the other sections, this content is best organized within an `<aside>` element to ensure it complements the main content without disrupting the reader's experience.
 
 

data/_includes/aside_info.html

@@ -1,5 +1,5 @@
 {% comment %}
-This file contains the second of the three elements, which provides additional information about the blog, such as a link to the RSS feed.
+This file contains the third of the four elements, which provides additional information about the blog, such as a link to the RSS feed.
 This content is also best organized within an <aside> element to keep it distinct from the main content.
 {% endcomment %}
 <aside>

data/_includes/aside_more.html

@@ -1,5 +1,5 @@
 {% comment %}
-This file contains the third of the three elements, often used to display links to partner sites or advertisements.
+This file contains the fourth of the four elements, often used to display links to partner sites or advertisements.
 This section is intended to showcase external resources or sponsored content relevant to the blog's audience,
 and it is also best placed within an <aside> element.
 

data/_includes/aside_navigation.html

@@ -1,5 +1,5 @@
 {% comment %}
-This file contains the first of the three elements displayed alongside the page content (or at the end of the page on mobile devices).
+This file contains the second of the four elements displayed alongside the page content (or at the end of the page on mobile devices).
 It typically includes blog navigation, such as 'Recent Articles' or 'Tag Cloud,' and is ideally wrapped in an <aside> element.
 {% endcomment %}
 <aside>

data/_includes/aside_top.html

@@ -0,0 +1,14 @@
+{% comment %}
+This file contains the first of the four side elements.
+It can be used to display a more complex navigation than the one at the top of the page.
+It is also best placed within an <aside> element.
+
+	<aside>
+		<h3>Page Navigation</h3>
+		<div class="col">
+			Navigation links go here
+		</div>
+	</aside>
+
+{% endcomment %}
+

data/_layouts/default.html

@@ -73,6 +73,7 @@ layout: html
 		</div>
 
 		<div class="col-lg-4 pb-5">
+			{% include aside_top.html %}
 			{% include aside_navigation.html %}
 			{% include aside_info.html %}
 			{% include aside_more.html %}

data/_sass/adoc-experimental.scss

@@ -0,0 +1,30 @@
+/**
+ * Button styles for the output of the AsciiDoc command `btn`.
+ */
+b.button {
+	font: inherit;
+	font-weight: 600;
+	white-space: nowrap;
+	background: #f5f5f5;
+	border: 1px solid rgba(0,0,0,.12);
+	padding: .2rem .7rem;
+	border-radius: .5rem;
+}
+
+/**
+ * Styles for the output of the AsciiDoc command `kbd`.
+ */
+.keyseq kbd {
+  display: inline-block;
+  padding: 0.42em 0.71em;
+  margin: 0 0.2em;
+  background: #f5f5f5;
+  color: #000;
+  font: 600 0.85em/0.85 monospace;
+  letter-spacing: .05em;
+  white-space: nowrap;
+  border: 1px solid #bbb;
+  border-radius: .1em;
+  box-shadow: 2px 2px 0 #888;
+}
+

data/assets/css/main.scss

@@ -41,6 +41,7 @@
 @use "adoc-text";
 @use "adoc-toc";
 @use "adoc-stem";
+@use "adoc-experimental";
 
 /*
  * Dynamically add stylesheets as configured by the user in `_config.yml`

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

@@ -1,5 +1,5 @@
 module Jekyll
 	module Endless
-		VERSION = '0.18.1'
+		VERSION = '0.19.0'
 	end
 end

data/pages_examples/showroom-asciidoc.adoc

@@ -50,8 +50,8 @@ While counter < 5 do
 End
 ----
 
-// For detailed information see:
-// https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#literals-and-source-code
+For detailed information see the https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#literals-and-source-code[section "Literals and source code" in the AsciiDoc Syntax Quick Reference]
+
 .Python code block with annotations.
 [source,python]
 ----
@@ -99,6 +99,45 @@ include::showroom-asciidoc-code.html[lines=4..]
 
 
 
+[[text-replacements]]
+== Text replacements
+
+Also see the https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#text-replacements[section "Text replacements" in the AsciiDoc Syntax Quick Reference]
+
+* `\->` is replaced by *->*
+* `\<-` is replaced by *<-*
+* `\=>` is replaced by *=>*
+* `\<=` is replaced by *<=*
+* `\(C)` is replaced by *(C)*
+* `\(R)` is replaced by *(R)*
+* `\...` is replaced by *...*
+* `\(TM)` is replaced by *(TM)*
+* `a \-- b` is replaced by *a -- b*
+
+
+
+
+
+[[footnotes]]
+== Footnotes
+
+Also see the https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#section-footnotes[section "Footnotes" in the AsciiDoc Syntax Quick Reference]
+
+* A statement with a footnote. footnote:[Details about this statement.]
+* A statement with a footnote!footnote:xyz[A named footnote with the id 'xyz'.]
+* Another statement with the same footnote!footnote:xyz[]
+
+[source, asciidoc]
+----
+* A statement with a footnote. footnote:[Details about this statement.]
+* A statement with a footnote!footnote:xyz[A named footnote with the id 'xyz'.]
+* Another statement with the same footnote!footnote:xyz[]
+----
+
+
+
+
+
 [[links]]
 == Links
 
@@ -115,13 +154,27 @@ include::showroom-asciidoc-code.html[lines=4..]
 
 
 
-== Keyboard shortcuts and menu paths
+[[experimental]]
+== Keyboard shortcuts, buttons and menu paths
+
+Also see the https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#keyboard-button-and-menu-macros[section "Keyboard, button, and menu macros" in the AsciiDoc Syntax Quick Reference]
 
-kbd:[Ctrl + Alt + Del]
+IMPORTANT: You must add the `:experimental:` attribute to the document header to enable these macros.
 
-menu:View[Appearance > Full Screen]
+[cols="1,1", options="header"]
+|===
+| AsciiDoc Code
+| Result
+
+| `\kbd:[Ctrl + Alt + Del]`
+| kbd:[Ctrl + Alt + Del]
 
+| `\menu:View[Appearance > Full Screen]`
+| menu:View[Appearance > Full Screen]
 
+| `\btn:[Submit]`
+| btn:[Submit]
+|===
 
 
 
@@ -159,6 +212,27 @@ CAUTION: Admonition: `CAUTION`.
 WARNING: Admonition: `WARNING`.
 
 
+Code for the *inline* command (here for a TIP):
+
+[source, asciidoc]
+----
+TIP: Admonition: `TIP`.
+----
+
+
+Code for the *block* command (here for a NOTE):
+
+[source, asciidoc]
+----
+[NOTE]
+====
+...
+====
+----
+
+
+
+
 
 
 
@@ -211,6 +285,37 @@ WARNING: Admonition: `WARNING`.
 
 
 
+[[passthrough-blocks]]
+== Passthrough blocks
+
+With passthrough blocks (delimited with `&#43;&#43;&#43;&#43;`), you can embed raw HTML code directly into your AsciiDoc document. Common examples are the inclusion of an HTML form, CSS and JavaScript snippets.
+
+To add a form to your document, you can use:
+
+[source, asciidoc]
+----
+++++
+<form onsubmit="alert('Thank you for subscribing!'); return false;">
+  <input type="email" required placeholder="name@example.com">
+  <button type="submit">Subscribe</button>
+</form>
+++++
+----
+
+The result is:
+
+++++
+<form onsubmit="alert('Thank you for subscribing!'); return false;">
+  <input type="email" required placeholder="name@example.com">
+  <button type="submit">Subscribe</button>
+</form>
+++++
+
+
+
+
+
+
 == Images
 
 // AsciiDoc commands are not stripped/processed when used within `alt=""`.
@@ -511,6 +616,45 @@ Bob->Alice : hello
 Alice --> Bob : hi
 ----
 
+[[mindmap-example]]
+.Example of a mind map illustrating concepts in the field of Artificial Intelligence (AI) and Machine Learning (ML).
+[plantuml, format=svg]
+----
+@startmindmap
+* Artificial Intelligence (AI)
+** Symbolic AI
+*** Logic / Knowledge Representation
+*** Expert Systems
+** Machine Learning (ML)
+*** Supervised Learning
+**** Classification
+***** Decision Trees
+***** Neural Networks
+***** Support Vector Machines (SVM)
+**** Regression
+***** Linear Regression
+***** Logistic Regression
+*** Unsupervised Learning
+**** Clustering
+***** K-Means
+***** DBSCAN
+**** Dimensionality Reduction
+***** PCA (Principal Component Analysis)
+***** t-SNE / UMAP
+*** Reinforcement Learning
+**** Q-Learning
+**** Deep Q-Networks (DQN)
+**** Policy Gradient Methods
+*** Deep Learning
+**** CNN (Convolutional Neural Networks)
+**** RNN (Recurrent Neural Networks)
+**** LSTM / GRU
+**** Transformer
+***** BERT
+***** GPT
+@endmindmap
+----
+
 
 
 === Graphviz
@@ -609,11 +753,11 @@ LilyPond is a music engraving program that enables users to create beautifully t
 
 
 [[barcodes]]
-== QR codes and Barcodes
+=== QR codes and Barcodes
 
 For details on how to use the QR code and barcode features, see the https://docs.asciidoctor.org/diagram-extension/latest/diagram_types/barcode/[Asciidoctor Diagram documentation on Barcodes and QR Codes].
 
-=== Block version of QR Codes (PNG and SVG)
+==== Block version of QR Codes (PNG and SVG)
 
 // Barcode block
 .QR code in SVG format using a code block and a specified x-dimension (value of `7`).
@@ -628,7 +772,7 @@ qrcode::This QR code is generated with Asciidoctor Diagram and presented in PNG
 
 
 
-=== Inline version of Barcodes and QR codes (PNG)
+==== Inline version of Barcodes and QR codes (PNG)
 
 * qrcode:   qrcode:HelloWorld![png, xdim=4]
 * code128:  code128:HelloWorld![png, height=40]

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-endless
 version: !ruby/object:Gem::Version
-  version: 0.18.1
+  version: 0.19.0
 platform: ruby
 authors:
 - Sven Boekhoff
 bindir: bin
 cert_chain: []
-date: 2025-06-13 00:00:00.000000000 Z
+date: 2025-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll-asciidoc
@@ -229,6 +229,7 @@ files:
 - _includes/aside_info.html
 - _includes/aside_more.html
 - _includes/aside_navigation.html
+- _includes/aside_top.html
 - _includes/container_end-of-document.html
 - _includes/container_end-of-main.html
 - _includes/container_end-of-page.html
@@ -265,6 +266,7 @@ files:
 - _sass/address.scss
 - _sass/adoc-admonition.scss
 - _sass/adoc-code.scss
+- _sass/adoc-experimental.scss
 - _sass/adoc-images.scss
 - _sass/adoc-lists.scss
 - _sass/adoc-quote.scss