jekyll-theme-endless 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c44a8b0b77f57bf3ef8c3107d45d5993590b951bafe7123b7a3d43aff1755e0f
-  data.tar.gz: ec822eb3c232ed9e4bceae9459c9ec6d0dc93c366269bf88ce046a61bc17d49e
+  metadata.gz: e5f07f885402f2e5f0e3431fb93102b8cbd9be1f0a0e7a6e42b0fbe59927b911
+  data.tar.gz: 2fb7e64709edac7b386f964305023d497081a11649f85d118af860a7931a7aaa
 SHA512:
-  metadata.gz: 2eb544cacc56b869f3d57935b580d824b11116649541ae2c4b508bd30f245a8e4a933719946f8c46fdcde7cc782e61a4fbaa6ab52f59b016202696d41a484e7e
-  data.tar.gz: 3a4fd8c1fa675898414c9618d0f4f91dded12bde8bb51e91525a96291b34452fe84f09573dc9c216fd29b1341c54661f3e4ad27916e7693797e0644905b5a938
+  metadata.gz: 52e24e161c592c799bead922df6265fd594a17b12e19b83856369e5742fbe4c405735e32e36656da61807961570b4a4a79d593672ab210827335284c287f59e7
+  data.tar.gz: 9d80abc86bd11686c49d65b38fa3d5b022b4deab9597d59abf0f729c3781f719d1745ba5d83896b0f4ced4684136e501331b09bc6fbfcee9170d8c53620aaf5c

data/README.adoc

@@ -7,6 +7,7 @@
 `jekyll-theme-endless` is a theme for the static site generator https://jekyllrb.com/[Jekyll].
 The theme is ready to be used with posts written in https://asciidoctor.org/[AsciiDoc] using the
 https://github.com/asciidoctor/jekyll-asciidoc[Jekyll AsciiDoc plugin].
+Moreover, it is shipped with a plugin that generates a *tag cloud*.
 The syntax of source code is highlighted using https://github.com/rouge-ruby/rouge/wiki/List-of-supported-languages-and-lexers[Rouge].
 
 The repository of this Jekyll theme is located at:
@@ -73,7 +74,21 @@ If you want to use Markdown AND have HTML-commands in the title, simply escape t
 
 == Usage
 
-Here I describe available layouts, includes, sass and/or assets here.
+Here I describe available layouts, includes, SASS- and other assets.
+
+To copy all the files of the theme into a folder,
+you can use the following command (in the root directory of your Jekyll project):
+
+[source,bash]
+----
+cp -r $(bundle show jekyll-theme-endless)/ .
+----
+
+This will copy the theme-folder containing all its files into the current directory.
+From there, you can selectively move files to your project and modify them as needed.
+Your (modified) copy will afterwards overwrite the contents provided by the theme.
+
+
 
 === Layouts
 
@@ -167,14 +182,29 @@ Layout of page-content with a list of blog posts at the end.
 Layout of pages containing a list of those posts being tagged with a given tag.
 This file is required by the `generate-tagpages`-plugin.
 
+[IMPORTANT]
+====
 It seems that plugins cannot read the files provided by themes.
 Thus, the file has to be created in the `_layouts` folder in every Jekyll project.
+
+For simplicity, I have designed a basic layout in the file `page-tag-template.html` that you can include.
+Alternatively, you can copy the content of `page-tag-template.html` into your `page-tags.html`.
+
 The content can be for example the following:
 
 [source, liquid]
 ----
 include::_layouts/page-tag.html[]
 ----
+====
+--
+
+
+`_layouts/page-tag-template.html`::
++
+--
+Simple page that allows you to define the content of the tag pages.
+This file is a template layout that can be included in `page-tag.html`.
 --
 
 
@@ -214,6 +244,16 @@ Content
 
 
 
+`_layouts/statistics.html`::
++
+--
+Simple page that displays statistics about the blog (such as the number of posts, number of tags, etc.),
+as well as potential issues (e.g., "posts without a tag").
+I typically use this page as a layout for my "about" page.
+--
+
+
+
 === Includes
 
 `_includes/container_end-of-document.html`::
@@ -233,10 +273,11 @@ The text of the link is the title of the page.
 If the text should be different from the page-title, set the page variable `menu_label`.
 In AsciiDoc files this could be e.g.: `:page-menu_label: 'AnotherText'`.
 
-The order of the links can be determined with the help of the page variable `menu_label`
+By default, the links in the menu are ordered alphabetically.
+The order of the links can be explicitly determined using the page variable `menu_position`
 (in AsciiDoc e.g. `:page-menu_position: 100`; in frontmatter e.g. `menu_position: 50`).
 Pages with higher numbers appear on the left side of the menu.
-Pages with a negative value for `menu_label` will be hidden from the menu.
+Pages with a negative value for `menu_position` will be hidden from the menu.
 This can be useful for your 404 page, which should be generated by Jekyll, but not visible in the menu.
 --
 
@@ -324,9 +365,62 @@ tag_title_prefix: "Posts tagged with: "
 
 === Styles
 
-In order to contribute SCSS-code, simply add a file `_sass/user.scss`, containing your SCCS-code.
+In order to contribute SCSS-code, simply add a file `_sass/user.scss`, containing your SCSS-code.
 This file is included by `assets/css/main.scss`.
 
+Since version 0.10.0, you can also add stylesheets dynamically to `assets/css/main.scss`
+using the site-variable `additional-stylesheets` in `_config.yml`.
+Example
+
+[source, yml]
+----
+# You can dynamically add import statements to assets/css/main.css
+# Just add the path (relative to the folder `_sass`) to this array
+# CAUTION: omit the ending ".scss"
+additional-stylesheets:
+  - "../theme-specific/debug"
+----
+
+
+=== Data-files
+
+`_data/tag-description.yml`::
++
+--
+You have the option to store descriptions for your tags in a YAML file.
+This is useful to ensure that everyone has the same understanding of each tag.
+In the current theme, the descriptions are used in two places:
+
+* On the tag page, below the page header
+* As the title of each tag in the tag cloud
+
+The format of the YAML file is:
+
+[source, yml]
+----
+Tag:
+  short: "Short description for the tag 'Tag'."
+AsciiDoc:
+  short: "A lightweight but feature-rich markup language used for writing documentation in plain text."
+Bootstrap:
+  short: "A popular front-end framework for building responsive, mobile-first websites using CSS and JavaScript components."
+CSS:
+  short: "Cascading Style Sheets, a language used for describing the presentation of a web page, including layout, colors, and fonts."
+----
+
+CAUTION: Be aware that the tags are case-sensitive!
+
+To check if you haven't created a description for a tag, you can simply create a style
+for the class `no-tag-description` in the `_sass/user.scss` file.
+I use, for example:
+
+[source, css]
+----
+.no-tag-description {
+	background-color: lightcoral;
+}
+----
+--
 
 
 == Settings
@@ -344,7 +438,7 @@ The default is `en`.
 
 == Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://gitlab.com/jekyll-theme-endless/jekyll-theme-endless.gitlab.io.
+Bug reports and pull requests are welcome on GitLab at https://gitlab.com/jekyll-theme-endless/jekyll-theme-endless.gitlab.io.
 This project is intended to be a safe, welcoming space for collaboration,
 and contributors are expected to adhere to the http://contributor-covenant.org[Contributor Covenant] code of conduct.
 

data/_config.yml

@@ -11,8 +11,13 @@
 # If you need help with YAML syntax, here are some quick references for you:
 # https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
 # https://learnxinyminutes.com/docs/yaml/
-#
+
+
+
+
+
 # Site settings
+###############################################################################
 # These are used to personalize your new site. If you look in the HTML files,
 # you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
 # You can create any custom variable you would like, and they will be accessible
@@ -23,7 +28,10 @@ url: "" # the base hostname & protocol for your site, e.g. http://example.com
 
 
 
+
+
 # AsciiDoc settings
+###############################################################################
 asciidoctor:
   attributes:
     # Highlighting source code using rouge
@@ -36,27 +44,34 @@ asciidoctor:
 
 
 
-# Theme specific settings
-# Find example data in _data.yml of the theme repository.
-# Run `bundle exec jekyll serve --config _config.yml,_data.yml`
 
 
 # Build settings
-#theme: minima
+###############################################################################
+# Load data (e.g. layouts) from a theme that is installed using bundler
+# Not required in this repository, since it provides the theme ("jekyll-theme-endless")
+#theme: jekyll-theme-endless
+
+# `plugins` specifies the list of plugins that are installed via RubyGems and managed through Bundler.
+# These are typically shared or third-party plugins available in the RubyGems ecosystem.
 #plugins:
+  # Required to load the plugin that generates the tag pages.
+  # jekyll-theme-endless is both a theme AND a plugin.
+  # NOT required in the repository that provides the plugin.
+  # Instead, the plugin can be loaded from the `./lib` directory.
+  # Local plugins are configured via the `plugins_dir` setting,
+  # which in this project has been outsourced to `_data.yml`.
+  #- jekyll-theme-endless
+  # Feed plugin currently not used
 #  - jekyll-feed
 
-# Exclude from processing.
-# The following items will not be processed, by default.
-# Any item listed under the `exclude:` key here will be automatically added to
-# the internal "default list".
+# Exclude files from processing.
 #
 # Excluded items can be processed by explicitly listing the directories or
 # their entries' file path in the `include:` list.
 #
 exclude:
-  - '*.gemspec'
-  - LICENSE.txt
+## The following items are not processed, by default.
 #   - .sass-cache/
 #   - .jekyll-cache/
 #   - gemfiles/
@@ -67,5 +82,24 @@ exclude:
 #   - vendor/cache/
 #   - vendor/gems/
 #   - vendor/ruby/
+## Your excludes:
+## Any item listed under the `exclude:` key here will be automatically added to
+## the internal "default list".
+  - '*.gemspec'
+  - LICENSE.txt
+  - .gitlab-ci.yml
+  - .gitignore
+  - .editorconfig
+
+
+
+
+
+# Settings for: jekyll-theme-endless
+###############################################################################
+# These settings have been outsourced into the file `_data.yml` in this project.
+# You can find example data in the `_data.yml` file of the theme repository.
+# If you want to build the theme website, you need to start the Jekyll server with two configuration files:
+# `bundle exec jekyll serve --config _config.yml,_data.yml`
 
 

data/_data/tag-description.yml

@@ -0,0 +1,91 @@
+SASS:
+  short: "SASS (Syntactically Awesome Stylesheets) is a CSS preprocessor that adds advanced features like variables, nested rules, and mixins to standard CSS. SASS has two syntax options: the older indented syntax (SASS) and the newer, more CSS-like syntax (SCSS). The SASS syntax uses indentation instead of curly braces and semicolons, while SCSS is more similar to traditional CSS and is often preferred for its familiarity."
+cleanup:
+  short: "The process of removing unnecessary or temporary files, obsolete code, or outdated data from a system or project to improve performance or maintainability."
+_data.yml:
+  short: "A YAML file used to store settings required for the theme website. They were outsourced from the _config.yml file to prevent them from being loaded as default values when using the theme."
+dependencies:
+  short: "External libraries, modules, or packages required by a project or software to function properly, typically managed by package managers like bundler."
+bash:
+  short: "A popular Unix shell and command language, commonly used for scripting and automating tasks in Linux and macOS environments."
+deployment:
+  short: "The process of releasing or distributing software to a production environment, making it available for use by end users."
+
+statistics:
+  short: "Data or numerical insights gathered from various sources, often used to analyze performance, user behavior, or other measurable factors."
+bugfixes:
+  short: "Software updates or patches that resolve identified errors or malfunctions, ensuring the application runs as expected."
+quotes:
+  short: "Text or speech cited from a source, typically used to reference someone's exact words or to highlight a point. Specifically refers to the styling and formatting of quotes in this context."
+tables:
+  short: "A structured format for organizing data into rows and columns, making it easy to present and interpret information in a grid layout."
+layout:
+  short: "The structured design and positioning of elements on a webpage or document, such as text and images, to enhance user experience. In Jekyll, layout files are stored in the '_layouts/' directory."
+CDN:
+  short: "A Content Delivery Network (CDN) is a system of distributed servers that deliver web content to users based on their geographic location, improving load times and performance."
+jsdelivr:
+  short: "A free, fast, and open-source CDN that hosts JavaScript libraries, CSS files, and other web assets, helping to deliver them efficiently to users."
+i18n:
+  short: "Short for 'internationalization', i18n refers to the process of designing software to be adaptable to different languages and regions without requiring engineering changes."
+updates:
+  short: "Changes or improvements applied to software or content, typically to fix bugs, add new features, or enhance security."
+logging:
+  short: "The practice of recording system events, errors, or user activities, often used for tracking and troubleshooting."
+debugging:
+  short: "The process of finding and resolving bugs or defects in software to ensure it behaves as expected."
+Gemfile:
+  short: "A file used in Ruby projects to list the dependencies (gems) required by the project and to manage their installation."
+_data:
+  short: "A directory in Jekyll where structured data (e.g., YAML, JSON, or CSV files) is stored, which can be accessed and used across the site."
+
+_config.yml:
+  short: "A configuration file used in Jekyll to customize settings for your site."
+admonition:
+  short: "A formatted block in documentation that draws attention to important notes or warnings."
+AsciiDoc:
+  short: "A lightweight but feature-rich markup language used for writing documentation in plain text."
+Bootstrap:
+  short: "A popular front-end framework for building responsive, mobile-first websites using CSS and JavaScript components."
+CSS:
+  short: "Cascading Style Sheets, a language used for describing the presentation of a web page, including layout, colors, and fonts."
+documentation:
+  short: "Written text or resources that explain how a piece of software or technology works."
+EditorConfig:
+  short: "A file format and collection of text editor plugins for maintaining consistent coding styles across different editors."
+example:
+  short: "A sample or instance used to demonstrate how something works or can be done."
+features:
+  short: "A set of distinctive attributes or capabilities that a software or product offers."
+Font Awesome:
+  short: "A font and icon toolkit used to include scalable vector icons and social logos on websites."
+footer:
+  short: "The section at the bottom of a webpage or document, usually containing copyright information, links, or branding."
+function:
+  short: "A block of code designed to perform a specific task and which can be reused in a program."
+gemspec:
+  short: "A specification file that defines the details of a Ruby gem, including its dependencies and metadata."
+highlighting:
+  short: "A feature used to apply color to syntax in code examples, making it easier to read and understand."
+images:
+  short: "Visual elements used in websites or documents, including photos, illustrations, and graphics."
+lists:
+  short: "A collection of items organized in a sequence, either ordered or unordered."
+Markdown:
+  short: "A lightweight markup language for formatting text, used widely for creating simple, readable documentation."
+menu:
+  short: "A navigation element in a webpage that allows users to move between different sections or pages."
+posts:
+  short: "Multiple blog entries or articles displayed on a site, typically listed in reverse chronological order."
+Rouge:
+  short: "A syntax highlighter used in Jekyll and other systems to colorize code snippets in various programming languages."
+SCSS:
+  short: "A preprocessor language that extends CSS with features like variables, nested rules, and functions."
+styling:
+  short: "The process of applying styles to a webpage or document, often through CSS, to enhance its appearance."
+table:
+  short: "A structured arrangement of data in rows and columns, often used for displaying information in a grid format."
+tag-cloud:
+  short: "A visual representation of the tags used in a blog, with more frequently used tags appearing larger."
+tags:
+  short: "Keywords or labels that categorize and describe blog posts or content to make them easier to find."
+

data/_data.yml

@@ -0,0 +1,63 @@
+# Theme-specific settings
+################################################################################
+# All configuration options for the theme jekyll-theme-endless are listed here.
+# These settings are outsourced into a separate file because they contain the values for the theme’s website.
+# This way, these values are not used as default settings when you integrate the theme into your own project.
+
+# Language. Is overriden by value of page.lang.
+lang: en
+# Brand is not escaped in the layout.
+# Thus, HTML-commands can be used.
+brand: '"<i>endless</i>"-Theme'
+
+# Title and subtile of the page
+title: jekyll-theme-endless
+subtitle: A Jekyll theme ready for AsciiDoc
+
+author: Sven Boekhoff
+copydate: 2020-2024
+disclaimer: >- # this means to ignore newlines until the next entry
+  I'm creating this Jekyll theme because I want to use it myself.
+  Therefore, many things (e.g. the support of AsciiDoc) are based on personal requirements.
+  You are welcome to use the theme (at your own risk) and contribute to the development.
+
+# eMail address
+email: your-email@example.com
+# Username on https://gitlab.com/
+username_gitlab: XXXX
+# Username on https://github.com/
+username_github: XXXX
+# Username on https://www.xing.com/
+username_xing: XXXX
+# Username on https://linkedin.com/
+username_linkedin: XXXX
+
+# Settings for tag cloud:
+# The name of the directory in which the files for each tag are created
+# default: `tags`
+tag_dir: posts-for-tag
+# Prefix to be used for the title of the tag-page
+# default: `Tag: `
+tag_title_prefix: "Posts tagged with: "
+
+# You can dynamically add import statements to assets/css/main.css
+# Just add the path (relative to the folder `_sass`) to this array
+# CAUTION: omit the ending ".scss"
+additional-stylesheets:
+  - "../theme-specific/debug"
+
+
+
+
+
+# Specific settings for this project
+################################################################################
+# In this project, the plugin for generating tag pages is loaded from the local directory `./lib`.
+# The folder where Jekyll looks for locally available plugins is configured via `plugins_dir`.
+# The default value for this is `_plugins`.
+# However, `_plugins` is also the directory that Jekyll uses for plugins managed by Bundler
+# (those plugins are specified using the `plugins` array in `_config.yml`).
+# Therefore, it is good practice to define a separate directory for locally available plugins.
+plugins_dir:
+  - ./lib
+

data/_includes/function_tag-cloud.html

@@ -78,8 +78,16 @@ Assumption: Non of the tags occurs more than one million times.
 		<a
 			href  = "/{{ site.tag_dir | default: 'tags' }}/{{ tag }}"
 			style = "font-size: {{ percent }}%"
-			title = "Number of posts with the tag '{{ tagname }}': {{ number }}"
+
+			{% if site.data.tag-description[tag].short %}
+				title = "{{ site.data.tag-description[tag].short }} Number of posts with the tag '{{ tagname }}': {{ number }}"
+			{% else %}
+				class = "no-tag-description"
+				title = "Number of posts with the tag '{{ tagname }}': {{ number }}"
+			{% endif %}
+
 			>{{ tagname }}</a>
 	</li>
+
 	{% endfor %}
 </ul>

data/_layouts/page-tag-template.html

@@ -0,0 +1,26 @@
+---
+layout: default
+menu_position: -10
+---
+{% comment %}
+page.tag and page.title are set by the plugin `generate-taglist`.
+{% endcomment %}
+{% if page.title %}
+<h1>{{ page.title }}</h1>
+{% endif %}
+
+{% if site.data.tag-description[page.tag].short %}
+  <p>
+		In this blog, the tag <dfn>{{page.tag}}</dfn> is used with the meaning
+		"<em>{{ site.data.tag-description[page.tag].short }}</em>".
+  </p>
+{% endif %}
+
+<p>
+	Number of posts tagged with "<em>{{ page.tag }}</em>": <strong>{{ site.tags[ page.tag ] | size }}</strong>
+</p>
+
+{% assign tag_posts = site.tags[page.tag] %}
+{% include function_list-posts.html
+	postlist=tag_posts
+%}

data/_layouts/page-tag.html

@@ -1,19 +1,5 @@
 ---
-layout: default
+layout: page-tag-template
 menu_position: -10
 ---
-{% comment %}
-page.tag and page.title are set by the plugin `generate-taglist`.
-{% endcomment %}
-{% if page.title %}
-<h1>{{ page.title }}</h1>
-{% endif %}
 
-<p>
-	Number of posts tagged with "<em>{{ page.tag }}</em>": <strong>{{ site.tags[ page.tag ] | size }}</strong>
-</p>
-
-{% assign tag_posts = site.tags[page.tag] %}
-{% include function_list-posts.html
-	postlist=tag_posts
-%}

data/_layouts/statistics.html

@@ -0,0 +1,95 @@
+---
+layout: default
+---
+<h1>{{ page.title }}</h1>
+
+{{ content }}
+
+<h2>Blog statistics</h2>
+
+{% comment %}Create an empty array.{% endcomment %}
+{% assign posts_without_tags = "" | split:"" %}
+
+{% for post in site.posts %}
+	{% assign number_of_tags = post.tags | size %}
+
+	{% if number_of_tags > 0 %}
+		{% assign posts_with_tags = posts_with_tags | plus: 1 %}
+		{% assign number_of_tags_total = number_of_tags_total | plus: number_of_tags %}
+	{% else %}
+		{% assign posts_without_tags = posts_without_tags | push: post %}
+	{% endif %}
+
+{% endfor %}
+
+
+
+{% comment %}Create an empty array.{% endcomment %}
+{% assign tags_without_description = "" | split:"" %}
+{% assign number_of_tags_with_description = 0 %}
+{% assign number_of_tags_without_description = 0 %}
+
+{% assign tags = "" | split:"" %}
+{% for tag in site.tags %}
+
+	{% if site.data.tag-description[tag.first].short %}
+		{% assign number_of_tags_with_description = number_of_tags_with_description | plus: 1 %}
+	{% else %}
+		{% assign number_of_tags_without_description = number_of_tags_without_description | plus: 1 %}
+		{% assign tags_without_description = tags_without_description | push: tag.first %}
+	{% endif %}
+
+{% endfor %}
+
+
+<h3>Overview</h3>
+
+{% comment %}
+Bei Änderungen auch den entsprechenden Blog-Eintrag vom 28.10.2020 anpassen!
+{% endcomment %}
+<ul>
+	<li><strong>Time created</strong>: {{ site.time }}</li>
+
+	<li><strong># pages</strong>: {{ site.pages | size }}</li>
+	<li><strong># HTML-pages</strong>: {{ site.html_pages | size }}</li>
+
+	<li><strong># posts</strong>: {{ site.posts | size }}</li>
+	<li><strong># posts_with_tags</strong>: {{ posts_with_tags }}</li>
+	<li><strong># posts_without_tags</strong>: {{ posts_without_tags | size }}</li>
+
+	<li><strong># number_of_tags_total</strong>: {{ number_of_tags_total }}</li>
+	<li><strong># different tags</strong>: {{ site.tags | size }}</li>
+	<li><strong># Tags with description</strong>: {{ number_of_tags_with_description }}</li>
+	<li><strong># Tags without description</strong>: {{ number_of_tags_without_description }}</li>
+
+	<li><strong># categories</strong>: {{ site.categories | size }}</li>
+</ul>
+
+
+
+{% assign number_pwt = posts_without_tags | size %}
+{% if number_pwt > 0 %}
+	<h3>Posts without tags</h3>
+	<p>
+		<em>This can be useful for debugging purpose, since every post should have at least one tag.</em>
+	</p>
+
+	{% include function_list-posts.html
+		postlist=posts_without_tags
+	%}
+
+{% endif %}
+
+
+{% assign number_twd = tags_without_description | size %}
+{% if number_twd > 0 %}
+	<h3>Tags without description</h3>
+	<p>
+		<em>This can be useful for debugging purposes, as every tag used should have a description from the <code>tag-description.yml</code> data file.</em>
+	</p>
+
+	{% include function_tag-list.html
+		tags=tags_without_description
+	%}
+
+{% endif %}

data/_sass/adoc-admonition.scss

@@ -9,6 +9,7 @@ div.admonitionblock {
 	width: 100%;
 	td {
 		padding: .75em .25em;
+		border-width: 0;
 	}
 }
 /* See:
@@ -19,6 +20,7 @@ span.icon>.fa {
 }
 .admonitionblock td.icon {
 	text-align: center;
+	vertical-align: top;
 	width: 66px;
 
 	[class^="fa icon-"] {

data/_sass/adoc-code.scss

@@ -0,0 +1,28 @@
+/**
+ * Show name of the language highlighted in a code block in the upper right corner.
+ */
+.listingblock .content code {
+  position: relative;
+  display: block;
+}
+
+.listingblock .content code::before {
+  content: attr(data-lang);
+  position: absolute;
+  top: 0;
+  right: 0;
+  background-color: #f0f0f0;
+  padding: 2px 5px;
+  font-size: 12px;
+  color: #333;
+  border-radius: 3px;
+  border: 1px solid #ccc;
+}
+
+/* If data-lang is empty or not set, ::before will be hidden. */
+.listingblock .content code[data-lang=""]::before,
+.listingblock .content code:not([data-lang])::before {
+  display: none;
+}
+
+

data/_sass/adoc-images.scss

@@ -13,11 +13,6 @@ div.imageblock {
 		padding: 10px 10px;
 		border-radius: 5px;
 	}
-	.title {
-		padding-top: .75rem;
-		padding-bottom: .75rem;
-		color: #6c757d;
-	}
 
 }
 

data/_sass/adoc-tables.scss

@@ -20,6 +20,30 @@ table.tableblock {
 		caption-side: top;
 	}
 
+
+	.halign-left {
+		text-align: left;
+	}
+	.halign-center {
+		text-align: center;
+	}
+	.halign-right {
+		text-align: right;
+	}
+	.valign-top {
+		vertical-align: top;
+	}
+	.valign-middle {
+		vertical-align: middle;
+	}
+	.valign-bottom {
+		vertical-align: bottom;
+	}
+
+
+
+
+
 }
 
 p.tableblock {

data/_sass/adoc-text.scss

@@ -0,0 +1,12 @@
+/**
+ * Text formatting.
+ */
+.line-through {
+	text-decoration: line-through;
+}
+
+
+.underline{
+	text-decoration: underline;
+}
+

data/_sass/adoc.scss

@@ -12,3 +12,12 @@ table tr:nth-of-type(even) {
 	background: #f8f8f7;
 }
 
+/**
+ * Captions of images, tables, code-blocks, ...
+ */
+ .title {
+	padding-top: .75rem;
+	padding-bottom: .75rem;
+	color: #6c757d;
+}
+

data/_sass/md-lists.scss

@@ -0,0 +1,5 @@
+.task-list-item {
+	input.task-list-item-checkbox {
+		margin-right: .5em;
+	}
+}

data/_sass/md-quote.scss

@@ -0,0 +1,7 @@
+blockquote {
+	text-align: center;
+	background-color: #f8f8f8;
+	margin: 1em 1.5em;
+	font-style: italic;
+	color: rgba(0,0,0,.6);
+}

data/_sass/md-tables.scss

@@ -0,0 +1,17 @@
+table {
+
+	th, td {
+		border: 0 solid #f00;
+		border: 0 solid #dedede;
+		padding: .5em .625em;
+		border-width: 1px;
+	}
+
+	thead,
+	tfoot {
+		background: #e7e8e7;
+		font-weight: bold;
+	}
+
+}
+

data/assets/css/main.scss

@@ -7,31 +7,47 @@
  * imports _scss/background.scss
  * imports _scss/icons.scss
  */
-@import "background";
-@import "address";
-@import "tag-cloud";
-@import "posts";
-@import "structure";
+@use "background";
+@use "address";
+@use "tag-cloud";
+@use "posts";
+@use "structure";
 
 /*
- * import styles for highlighting source code that was annotated using rouge.
+ * Import styles for highlighting source code that was annotated using rouge.
  */
-@import "rouge-highlight";
+@use "rouge-highlight";
 
 /*
- * import styles for AsciiDoc.
+ * Import styles for Markdown.
  */
-@import "adoc";
-@import "adoc-admonition";
-@import "adoc-tables";
-@import "adoc-lists";
-@import "adoc-quote";
-@import "adoc-images";
+@use "md-quote";
+@use "md-lists";
+@use "md-tables";
 
 /*
- * import SCSS-Code contributed by the user of the theme.
+ * Import styles for AsciiDoc.
+ */
+@use "adoc";
+@use "adoc-admonition";
+@use "adoc-tables";
+@use "adoc-lists";
+@use "adoc-quote";
+@use "adoc-images";
+@use "adoc-code";
+@use "adoc-text";
+
+/*
+ * Dynamically add stylesheets as configured by the user in `_config.yml`
+ */
+{% for stylesheet in site.additional-stylesheets %}
+@use "{{ stylesheet }}";
+{% endfor %}
+
+/*
+ * Import SCSS-Code contributed by the user of the theme.
  * imports from _scss/background.scss
  */
-@import "user";
+ @use "user";
 
 

data/lib/jekyll-theme-endless/generate-tagpages.rb

@@ -33,19 +33,27 @@ module Jekyll
 			safe true
 			# A Generator needs to implement the generate method
 			def generate(site)
+				puts "[INFO] Starting TagPage generation"
 				# If a layout with the name `page-tag` exists
 				if site.layouts.key? 'page-tag'
+					puts "[INFO] 'page-tag' layout found"
 					# The directory in which the files are to be created is configured in `site.tag_dir`.
 					# If not, the directory `tags/` is used.
 					dir = site.config['tag_dir'] || 'tags'
+					puts "[INFO] Using tag directory: #{dir}"
 
 					# For each tag in the tag-list:
 					site.tags.each_key do |tag|
 						# Create a page-object using TagPage and add it to the `site.pages` array
 						site.pages << TagPage.new(site, site.source, File.join(dir, tag), tag)
+						puts "[INFO] TagPage created for tag: #{tag}"
 					end
 
+					puts "[INFO] All tags processed successfully"
+				else
+					puts "[ERROR] Could not find the layout 'page-tag'. Create a file '_layouts/page-tag.html' to fix this error. Skipping TagPage generation for now."
 				end
+				puts "[INFO] TagPage generation finished"
 			end
 		end
 

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

@@ -1,5 +1,5 @@
 module Jekyll
 	module Endless
-		VERSION = '0.9.0'
+		VERSION = '0.11.0'
 	end
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-endless
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Sven Boekhoff
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-09 00:00:00.000000000 Z
+date: 2024-10-23 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll-asciidoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: jekyll
   requirement: !ruby/object:Gem::Requirement
@@ -24,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.4'
 description: 
 email:
 - rubygems.org@boekhoff.net
@@ -34,6 +62,8 @@ files:
 - LICENSE.txt
 - README.adoc
 - _config.yml
+- _data.yml
+- _data/tag-description.yml
 - _includes/container_end-of-document.html
 - _includes/content_footer-usernames.html
 - _includes/function_list-pages.html
@@ -46,17 +76,24 @@ files:
 - _layouts/default.html
 - _layouts/html.html
 - _layouts/page-postlist.html
+- _layouts/page-tag-template.html
 - _layouts/page-tag.html
 - _layouts/page.html
 - _layouts/post.html
+- _layouts/statistics.html
 - _sass/address.scss
 - _sass/adoc-admonition.scss
+- _sass/adoc-code.scss
 - _sass/adoc-images.scss
 - _sass/adoc-lists.scss
 - _sass/adoc-quote.scss
 - _sass/adoc-tables.scss
+- _sass/adoc-text.scss
 - _sass/adoc.scss
 - _sass/background.scss
+- _sass/md-lists.scss
+- _sass/md-quote.scss
+- _sass/md-tables.scss
 - _sass/posts.scss
 - _sass/rouge-highlight.scss
 - _sass/structure.scss
@@ -79,14 +116,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.3.5
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.5.16
 signing_key: 
 specification_version: 4
 summary: A Jekyll theme that was started from scratch. View it on https://jekyll-theme-endless.gitlab.io/.