jekyll-theme-endless 0.22.0 → 0.22.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.adoc +1 -1
- data/_config.yml +1 -1
- data/_includes/aside_info.html +2 -2
- data/_layouts/html.html +3 -3
- data/lib/jekyll-theme-endless/version.rb +1 -1
- data/pages_examples/showroom-asciidoc.adoc +27 -2
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 45d9b6fa2835d2da886589f693ab08be0b4982c80ed0e10aff4494f5a940eed9
|
|
4
|
+
data.tar.gz: f173fb8e45e722a6ca068b0125ca55141c1a7c3e5d65679d620cfc624e03e5fe
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: afa01141a8c7746f8ac0f77780c5d9436ff09257bf3e7560290d76fde2ff994e9094669dfb375bf2d47b7fe21fdb37b9a38836ea7f0851d5a5e0e44113f3f234
|
|
7
|
+
data.tar.gz: f705d71913dc5e4ed28696fc4d6598ded960c2b37c36c92d57615ad7b3c9ac20489cb77d7183d9f854235cd1d89f7f402690608bcfaab59aeab2b3dadb81c8e6
|
data/README.adoc
CHANGED
|
@@ -553,7 +553,7 @@ It's best practice to wrap the content in an `<aside>` element.
|
|
|
553
553
|
|
|
554
554
|
`_includes/aside_info.html`::
|
|
555
555
|
|
|
556
|
-
The third of the four elements, typically providing additional information about the blog (e.g., a link to the RSS feed).
|
|
556
|
+
The third of the four elements, typically providing additional information about the blog (e.g., a link to the RSS/Atom feed).
|
|
557
557
|
This content is also ideally wrapped in an `<aside>` element.
|
|
558
558
|
|
|
559
559
|
|
data/_config.yml
CHANGED
|
@@ -76,7 +76,7 @@ plugins:
|
|
|
76
76
|
# Local plugins are configured via the `plugins_dir` setting,
|
|
77
77
|
# which in this project has been outsourced to `_configData.yml`.
|
|
78
78
|
#- jekyll-theme-endless
|
|
79
|
-
# Generate an RSS-file with the blog-content
|
|
79
|
+
# Generate an RSS/Atom-file with the blog-content
|
|
80
80
|
# See https://github.com/jekyll/jekyll-feed for configuration
|
|
81
81
|
- jekyll-feed
|
|
82
82
|
- asciidoctor-diagram
|
data/_includes/aside_info.html
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{% comment %}
|
|
2
|
-
This file contains the third of the four elements, which provides additional information about the blog, such as a link to the RSS feed.
|
|
2
|
+
This file contains the third of the four elements, which provides additional information about the blog, such as a link to the RSS/Atom feed.
|
|
3
3
|
This content is also best organized within an <aside> element to keep it distinct from the main content.
|
|
4
4
|
{% endcomment %}
|
|
5
5
|
<aside>
|
|
6
6
|
<h3>InfoBox</h3>
|
|
7
7
|
<div class="col">
|
|
8
8
|
<p class="rss-subscribe">
|
|
9
|
-
You can also follow this blog <a href="{{ "/feed.xml" | relative_url }}" class="rss">via RSS</a>.
|
|
9
|
+
You can also follow this blog <a href="{{ "/feed.xml" | relative_url }}" class="rss">via RSS/Atom</a>.
|
|
10
10
|
</p>
|
|
11
11
|
</div>
|
|
12
12
|
</aside>
|
data/_layouts/html.html
CHANGED
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
{% if site.title %}
|
|
46
46
|
{% assign rss_title = site.title | strip_html %}
|
|
47
47
|
{% else %}
|
|
48
|
-
{% assign rss_title = "RSS Feed" %}
|
|
48
|
+
{% assign rss_title = "RSS/Atom Feed" %}
|
|
49
49
|
{% endif %}
|
|
50
50
|
|
|
51
51
|
{% if site.subtitle %}
|
|
@@ -55,8 +55,8 @@
|
|
|
55
55
|
{% if site.brand %}
|
|
56
56
|
{% assign rss_title = rss_title | append: " | " | append: site.brand | strip_html %}
|
|
57
57
|
{% endif %}
|
|
58
|
-
<!-- RSS Feed - This code adds a link to the RSS feed, enabling browsers and feed readers to detect and subscribe to site updates automatically.-->
|
|
59
|
-
<link rel="alternate" type="application/
|
|
58
|
+
<!-- RSS/Atom Feed - This code adds a link to the RSS/Atom feed, enabling browsers and feed readers to detect and subscribe to site updates automatically.-->
|
|
59
|
+
<link rel="alternate" type="application/atom+xml" title="{{ rss_title | escape_once }}" href="{{ '/feed.xml' | relative_url }}">
|
|
60
60
|
|
|
61
61
|
</head>
|
|
62
62
|
<body>
|
|
@@ -9,6 +9,11 @@
|
|
|
9
9
|
:toc: preamble
|
|
10
10
|
:toclevels: 5
|
|
11
11
|
: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."
|
|
12
|
+
// The Liquid page variable ensures that the Liquid preprocessor is also applied to AsciiDoc files.
|
|
13
|
+
// https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#enabling-liquid-preprocessing
|
|
14
|
+
// This is required in this specific case because I need to access the content of the Jekyll variable `site.destination` within this document.
|
|
15
|
+
// See the comments in the [[meme]] section for more details.
|
|
16
|
+
:page-liquid:
|
|
12
17
|
|
|
13
18
|
|
|
14
19
|
|
|
@@ -396,6 +401,9 @@ The result is:
|
|
|
396
401
|
|
|
397
402
|
== Images
|
|
398
403
|
|
|
404
|
+
// NOTE:
|
|
405
|
+
// The image originates from the theme’s assets folder and is added to your blog during the build process.
|
|
406
|
+
|
|
399
407
|
// AsciiDoc commands are not stripped/processed when used within `alt=""`.
|
|
400
408
|
:pic_1_src: /assets/images/tree-3822149_640.jpg
|
|
401
409
|
: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
|
|
|
1191
1199
|
|
|
1192
1200
|
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.
|
|
1193
1201
|
|
|
1194
|
-
|
|
1202
|
+
// In this example, I want to create a meme using an image that is packaged within the jekyll-theme-endless theme.
|
|
1203
|
+
// This image is copied into the build folder (by default `_site`) during the build process.
|
|
1204
|
+
// The meme extension needs to know the location of this image within the build directory.
|
|
1205
|
+
// Since the build path can change, for example through the `-d` parameter, you should not hardcode `_site` here.
|
|
1206
|
+
// The current build directory is stored in the Jekyll variable `site.destination`.
|
|
1207
|
+
// See: https://jekyllrb.com/docs/configuration/options/
|
|
1208
|
+
// This variable can be accessed using Liquid syntax via `{{ site.destination }}`.
|
|
1209
|
+
// However, Liquid commands are not processed in AsciiDoc documents by default.
|
|
1210
|
+
// To enable the Liquid preprocessor for this document, you need to set the `:page-liquid:` attribute in the document header.
|
|
1211
|
+
// See: https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#enabling-liquid-preprocessing
|
|
1212
|
+
// During the build process, the Liquid preprocessor runs first, followed by the AsciiDoc processor.
|
|
1213
|
+
//
|
|
1214
|
+
// I assume that this approach will rarely be needed in practice.
|
|
1215
|
+
// Nevertheless, it provides a good insight into how Jekyll builds work and how AsciiDoc files are processed.
|
|
1216
|
+
// So, unless you specifically want to use one of the images packaged with the jekyll-theme-endless theme for your memes,
|
|
1217
|
+
// you can simply remove the `:page-liquid:` attribute and specify a path without using the Liquid variable {{ site.destination }}.
|
|
1218
|
+
|
|
1219
|
+
:pic_2_src: {{ site.destination }}/assets/images/cat.jpg
|
|
1195
1220
|
|
|
1196
|
-
.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.
|
|
1221
|
+
.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}`.
|
|
1197
1222
|
meme::{pic_2_src}[Markdown? // Really?, Did you understand // a single word written here?, stroke-width=2, fill-color=white]
|
|
1198
1223
|
|
|
1199
1224
|
|