jekyll-theme-endless 0.4.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69ca0a202fdb3f05970cb2e99a6718220173c3383ab3649c3d4733d8d647ad8b
-  data.tar.gz: aa05cd183d0ae7ef3767b3ada0e101b48b515ccad38b50502ac5af04215c5275
+  metadata.gz: d7ff2f4560ea04705b9b3e3449ccaf2546a744971d7858c8ab721258a0438ecc
+  data.tar.gz: 28c2b78e998e5c78a686ca828a9ec3be2e20802b45abad00b60deabc911390cb
 SHA512:
-  metadata.gz: e4a4dc344fcfe38993cc1ba0f88bc9c4eac5883bbeadfeafa5c5fea182c426ce059f24a774b6ac5b8fc9e90eed7bb0dbc71a37d74a1f5a68f93bf750b0be457a
-  data.tar.gz: 7137b1499ecf59cb76ad21ef4956838dbfa10ca45c2d64d278ee1976a92a62e982753fafb895f3a2905d7c3f12df34817f68f0813c661dfad48446af16df8d1d
+  metadata.gz: 37869a7cd4468fed50f4e1f7ee4e3b2ff5f886faff91993c46b82cd68ac52222d42fea95b1151bec34e343352aae269ead46f3c3b3e86f0b9b336d6f82817477
+  data.tar.gz: 9694fd6e67dfd02fea7ef9192ddcfa60edbc4c747b087e96ec3544c3ad9e6e2826e305f577ad435ea2280e103269b5376e4645b5d40ef7c7eedbe977e21eb5a5

data/README.adoc

@@ -3,6 +3,19 @@
 :page-menu_position: 300
 
 
+
+`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].
+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:
+https://gitlab.com/jekyll-theme-endless/jekyll-theme-endless.gitlab.io.
+An example page using this theme can be viewed at: https://jekyll-theme-endless.gitlab.io.
+The gem is published on https://rubygems.org/gems/jekyll-theme-endless.
+
+
+
 == Quicktstart for testing
 
 * Clone the repository
@@ -54,9 +67,13 @@ Here I describe available layouts, includes, sass and/or assets here.
 === Layouts
 
 `_layouts/html.html`::
+
 HTML boilerplate code used for all layouts.
 
+
 `_layouts/default.html`::
++
+--
 Default website structure (menue, tag cloud, ...) used for pages and posts.
 
 Contains a *navigation bar* with a configurable brand-label.
@@ -93,15 +110,19 @@ disclaimer: >- # this means to ignore newlines until the next entry
   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.
 ----
+--
 
 
 `_layouts/page.html`::
++
+--
 Layout of page-content.
 
 Start a new page in *AsciiDoc* by adding a file ending with `.adoc`.
 Do not forget the `page-`-prefix when setting page variables.
 Jekyll-AsciiDoc has an https://github.com/asciidoctor/jekyll-asciidoc#specifying-a-layout[auto-detection mechanism for the layout].
 Thus, you typically do not have to set the layout to `page` or `post`.
+
 [source, AsciiDoc]
 ----
 = Page title
@@ -123,21 +144,27 @@ layout: page
 
 Content
 ----
+--
 
 `_layouts/page-postlist.html`::
 Layout of page-content with a list of blog posts at the end.
 
+
 `_layouts/page-tag.html`::
 Layout of pages containing a list of those posts being tagged with a given tag.
 This file is required by the `generate-tagpages`-plugin.
 
+
 `_layouts/post.html`::
++
+--
 Layout of blog-posts.
 
 Start a new post in *AsciiDoc* by adding a file ending with `.adoc` to the `_posts/`-folder.
 Do not forget the `page-`-prefix when setting page variables.
 Jekyll-AsciiDoc has an https://github.com/asciidoctor/jekyll-asciidoc#specifying-a-layout[auto-detection mechanism for the layout].
 Thus, you typically do not have to set the layout to `page` or `post`.
+
 [source, AsciiDoc]
 ----
 = Page title
@@ -160,12 +187,15 @@ title: Page title
 
 Content
 ----
+--
 
 
 
 === Includes
 
 `_includes/function_list-pages.html`::
++
+--
 Generates the code containing links to each page.
 The text of the link is the title of the page.
 
@@ -177,15 +207,21 @@ The order of the links can be determined with the help of the page variable `men
 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.
 This can be useful for your 404 page, which should be generated by Jekyll, but not visible in the menu.
+--
+
 
 `_includes/function_list-posts.html`::
 Generates the code containing links to each blog-post.
 The text of the link is the title of the post.
 
+
 `_includes/function_tag-cloud.html`::
 Generates a tag cloud.
 
+
 `_includes/content_footer-usernames.html`::
++
+--
 Creates a list of contact options based on provided usernames and addresses.
 The entries are preceded with the icons of (e.g.) the social network and are linked to the corresponding profile.
 
@@ -199,12 +235,16 @@ username_github: XXXX
 username_xing: XXXX
 username_linkedin: XXXX
 ----
+--
+
 
 `_includes/function_tag-list.html`::
 Generates a formatted list of tags.
 This is e.g. used to display the tags of a blog post.
 
 `_includes/function_show-dates.html`::
++
+--
 Show the creation date and (if present) the date a blog post was last edited.
 The date of the last edit can be configured by setting a value for the page-variable `lastedit`.
 
@@ -214,6 +254,8 @@ In AsciiDoc this would be e.g.:
 ----
 :page-lastedit: 2020-10-29
 ----
+--
+
 
 `_includes/function_show-prev-next-navigation.html`::
 Displays links to the previous and the next post of your blog.
@@ -222,8 +264,9 @@ Displays links to the previous and the next post of your blog.
 
 === Plugins
 
-`_plugins/generate-tagpages.rb`
-
+`_plugins/generate-tagpages.rb`::
++
+--
 Generates a page for each tag listed in `site.tags`.
 The files created are by default named `tags/<tagname>/index.html`.
 The content is generated using the layout file `_layouts/page-tag.html`
@@ -240,7 +283,7 @@ tag_dir: post-for-tag
 # default: `Tag: `
 tag_title_prefix: "Posts tagged with: "
 ----
-
+--
 
 
 === Styles

data/_config.yml

@@ -23,6 +23,19 @@ url: "" # the base hostname & protocol for your site, e.g. http://example.com
 
 
 
+# AsciiDoc settings
+asciidoctor:
+  attributes:
+    # Highlighting source code using rouge
+    # https://github.com/asciidoctor/jekyll-asciidoc#stylesheet-for-code-highlighting
+    # https://github.com/asciidoctor/jekyll-asciidoc/issues/221#issuecomment-526857488
+    source-highlighter: rouge
+    # Activate font-based admonition icons
+    # https://github.com/asciidoctor/jekyll-asciidoc#font-based-admonition-and-inline-icons
+    icons: font
+
+
+
 # Theme specific settings
 # Find example data in _data.yml of the theme repository.
 # Run `bundle exec jekyll serve --config _config.yml,_data.yml`

data/_includes/function_show-prev-next-navigation.html

@@ -1,12 +1,18 @@
 <div class="row text-left">
 	<div class="col">
 		{% if page.next %}
-		<a href="{{ page.next.url }}">&laquo; {{page.next.title}}</a>
+		<a href="{{ page.next.url }}">
+			<i class="fa fa-arrow-left d-md-none"></i>
+			<span class="d-none d-md-inline">&laquo; {{page.next.title}}</span>
+		</a>
 		{% endif %}
 	</div>
 	<div class="col text-right">
 		{% if page.previous %}
-		<a href="{{ page.previous.url }}">{{page.previous.title}} &raquo;</a>
+		<a href="{{ page.previous.url }}">
+			<span class="d-none d-md-inline">{{page.previous.title}} &raquo;</span>
+			<i class="fa fa-arrow-right d-md-none"></i>
+		</a>
 		{% endif %}
 	</div>
 </div>

data/_includes/function_tag-cloud.html

@@ -64,8 +64,16 @@ Assumption: Non of the tags occurs more than one million times.
 		{% endcomment %}
 
 		{% assign number  = site.tags[tag] | size %}
-		{% assign percent = number | times: 1.0 | minus: min | times: sizeDifference | divided_by: steps | plus: 100 %}
-		{% assign tagname = tag | replace:'-', ' ' %}
+		{% comment %}
+			Tags that only occur once, should be displayed smaller than 100% in the tag cloud.
+		{% endcomment %}
+		{% if number == 1 %}
+			{% assign percent = 65 %}
+		{% else %}
+			{% assign percent = number | times: 1.0 | minus: min | times: sizeDifference | divided_by: steps | plus: 100 %}
+		{% endif %}
+
+		{% assign tagname = tag %}
 
 		<a
 			href  = "/{{ site.tag_dir | default: 'tags' }}/{{ tag }}"

data/_layouts/page-tag.html

@@ -9,6 +9,10 @@ page.tag and page.title are set by the plugin `generate-taglist`.
 <h1>{{ page.title }}</h1>
 {% endif %}
 
+<p>
+	Number of posts tagged with "<em>{{ page.tag }}</em>": <strong>{{ site.tags[ page.tag ] | size }}</strong>
+</p>
+
 <ul>
 	{% for post in site.tags[ page.tag ] %}
 

data/_sass/adoc-admonition.scss

@@ -0,0 +1,51 @@
+div.admonitionblock {
+	border-radius: 5px;
+	box-shadow: 0 1px 4px #aaa;
+	background: #fff;
+	color: #111;
+}
+.admonitionblock table {
+	background-color: transparent;
+	width: 100%;
+	td {
+		padding: .75em .25em;
+	}
+}
+/* See:
+ * https://github.com/asciidoctor/jekyll-asciidoc#font-based-admonition-and-inline-icons
+ */
+span.icon>.fa {
+	cursor: default;
+}
+.admonitionblock td.icon {
+	text-align: center;
+	width: 66px;
+
+	[class^="fa icon-"] {
+		font-size: 1.5em;
+		text-shadow: 1px 1px 2px rgba(0,0,0,.5);
+		cursor: default;
+	}
+	.icon-note:before {
+		content: "\f05a";
+		color: #19407c;
+	}
+	.icon-tip:before {
+		content: "\f0eb";
+		text-shadow: 1px 1px 2px rgba(155,155,0,.8);
+		color: #111;
+	}
+	.icon-warning:before {
+		content: "\f071";
+		color: #bf6900;
+	}
+	.icon-caution:before {
+		content: "\f06d";
+		color: #bf3400;
+	}
+	.icon-important:before {
+		content: "\f06a";
+		color: #bf0000;
+	}
+
+}

data/_sass/adoc-images.scss

@@ -0,0 +1,23 @@
+/**
+ * Images.
+ */
+div.imageblock {
+	text-align: center;
+
+	img {
+		/* See also `img-fluid` class from Bootstrap. */
+		max-width: 100%;
+		height: auto;
+		background: #fff;
+		border: 1px solid #aaa;
+		padding: 10px 10px;
+		border-radius: 5px;
+	}
+	.title {
+		padding-top: .75rem;
+		padding-bottom: .75rem;
+		color: #6c757d;
+	}
+
+}
+

data/_sass/adoc-lists.scss

@@ -0,0 +1,20 @@
+dl{
+	dt {
+		margin-bottom: .3125em;
+		font-weight: bold;
+	}
+	dd {
+		margin-left: .5em;
+		padding-left: .5em;
+		margin-bottom: 1.25em;
+		border-left: 5px solid #dee2e6;
+	}
+}
+
+li {
+	p {
+		/* Reduce distance between list entries. */
+		margin-bottom: .25rem;
+	}
+}
+

data/_sass/adoc-quote.scss

@@ -0,0 +1,48 @@
+.quoteblock {
+	margin: 1em 1.5em;
+	font-style: italic;
+	color: rgba(0,0,0,.6);
+
+	& > .title {
+		margin-left: -1.5em;
+		margin-bottom: .75em;
+		font-weight: bold;
+	}
+
+	blockquote {
+		text-align: center;
+		background-color: #f8f8f8;
+
+		&::before, &::after {
+			font-size: 3em;
+			font-weight: bold;
+			line-height: .6em;
+			color: #721;
+			text-shadow: 0 1px 2px rgba(0,0,0,.1);
+		}
+		&::before {
+			content: "\201c";
+			float: left;
+			margin-left: -.6em;
+		}
+		&::after {
+			content: "\201d";
+			float: right;
+			margin-right: -.6em;
+			margin-top: -.6em;
+		}
+	}
+
+	.attribution {
+		margin-top: .5em;
+		margin-right: .5ex;
+		text-align: right;
+
+		cite {
+			display: block;
+			letter-spacing: -.025em;
+			font-size: .75em;
+		}
+	}
+
+}

data/_sass/adoc-tables.scss

@@ -0,0 +1,35 @@
+/**
+ * Table blocks.
+ */
+table.tableblock {
+
+	thead,
+	tfoot {
+		background: #e7e8e7;
+		font-weight: bold;
+	}
+
+	th.tableblock,
+	td.tableblock {
+		border: 0 solid #f00;
+		border: 0 solid #dedede;
+		padding: .5em .625em;
+	}
+
+	caption {
+		caption-side: top;
+	}
+
+}
+
+p.tableblock {
+	margin-bottom: 0;
+}
+
+table.grid-all {
+	th.tableblock,
+	td.tableblock {
+		border-width: 1px;
+	}
+}
+

data/_sass/adoc.scss

@@ -0,0 +1,14 @@
+/*
+ * Applies to adminition blocks and table blocks
+ */
+table {
+	background: #fff;
+	margin: .5em auto;
+}
+
+table tr.even,
+table tr.alt,
+table tr:nth-of-type(even) {
+	background: #f8f8f7;
+}
+

data/_sass/rouge-highlight.scss

@@ -0,0 +1,73 @@
+/*
+ * Based on "Manni" from https://github.com/jwarby/jekyll-pygments-themes
+ */
+
+.highlight {
+	@at-root pre#{&} {
+		-moz-tab-size: 2;
+		tab-size: 2;
+		background-color: #f8f8f8;
+		padding: .5em 1em;
+	}
+	.hll { background-color: #ffffcc }
+	.c { color: #080; font-style: italic } /* Comment */
+	.err { color: #AA0000; background-color: #FFAAAA } /* Error */
+	.k { color: #006699; font-weight: bold } /* Keyword */
+	.o { color: #555555 } /* Operator */
+	.cm { color: #080; font-style: italic } /* Comment.Multiline */
+	.cp { color: #08F } /* Comment.Preproc */
+	.c1 { color: #080; font-style: italic } /* Comment.Single */
+	.cs { color: #08F; font-weight: bold; font-style: italic } /* Comment.Special */
+	.gd { background-color: #FFCCCC; border: 1px solid #CC0000 } /* Generic.Deleted */
+	.ge { font-style: italic } /* Generic.Emph */
+	.gr { color: #FF0000 } /* Generic.Error */
+	.gh { color: #003300; font-weight: bold } /* Generic.Heading */
+	.gi { background-color: #CCFFCC; border: 1px solid #00CC00 } /* Generic.Inserted */
+	.go { color: #AAAAAA } /* Generic.Output */
+	.gp { color: #000099; font-weight: bold } /* Generic.Prompt */
+	.gs { font-weight: bold } /* Generic.Strong */
+	.gu { color: #003300; font-weight: bold } /* Generic.Subheading */
+	.gt { color: #99CC66 } /* Generic.Traceback */
+	.kc { color: #006699; font-weight: bold } /* Keyword.Constant */
+	.kd { color: #006699; font-weight: bold } /* Keyword.Declaration */
+	.kn { color: #006699; font-weight: bold } /* Keyword.Namespace */
+	.kp { color: #006699 } /* Keyword.Pseudo */
+	.kr { color: #006699; font-weight: bold } /* Keyword.Reserved */
+	.kt { color: #007788; font-weight: bold } /* Keyword.Type */
+	.m { color: #FF6600 } /* Literal.Number */
+	.s { color: #CC3300 } /* Literal.String */
+	.na { color: #330099 } /* Name.Attribute */
+	.nb { color: #336666 } /* Name.Builtin */
+	.nc { color: #00AA88; font-weight: bold } /* Name.Class */
+	.no { color: #336600 } /* Name.Constant */
+	.nd { color: #9999FF } /* Name.Decorator */
+	.ni { color: #999999; font-weight: bold } /* Name.Entity */
+	.ne { color: #CC0000; font-weight: bold } /* Name.Exception */
+	.nf { color: #CC00FF } /* Name.Function */
+	.nl { color: #9999FF } /* Name.Label */
+	.nn { color: #00CCFF; font-weight: bold } /* Name.Namespace */
+	.nt { color: #330099; font-weight: bold } /* Name.Tag */
+	.nv { color: #003333 } /* Name.Variable */
+	.ow { color: #000000; font-weight: bold } /* Operator.Word */
+	.w { color: #bbbbbb } /* Text.Whitespace */
+	.mf { color: #FF6600 } /* Literal.Number.Float */
+	.mh { color: #FF6600 } /* Literal.Number.Hex */
+	.mi { color: #FF6600 } /* Literal.Number.Integer */
+	.mo { color: #FF6600 } /* Literal.Number.Oct */
+	.sb { color: #CC3300 } /* Literal.String.Backtick */
+	.sc { color: #CC3300 } /* Literal.String.Char */
+	.sd { color: #CC3300; font-style: italic } /* Literal.String.Doc */
+	.s2 { color: #CC3300 } /* Literal.String.Double */
+	.se { color: #CC3300; font-weight: bold } /* Literal.String.Escape */
+	.sh { color: #CC3300 } /* Literal.String.Heredoc */
+	.si { color: #AA0000 } /* Literal.String.Interpol */
+	.sx { color: #CC3300 } /* Literal.String.Other */
+	.sr { color: #33AAAA } /* Literal.String.Regex */
+	.s1 { color: #CC3300 } /* Literal.String.Single */
+	.ss { color: #FFCC33 } /* Literal.String.Symbol */
+	.bp { color: #336666 } /* Name.Builtin.Pseudo */
+	.vc { color: #003333 } /* Name.Variable.Class */
+	.vg { color: #003333 } /* Name.Variable.Global */
+	.vi { color: #003333 } /* Name.Variable.Instance */
+	.il { color: #FF6600 } /* Literal.Number.Integer.Long */
+}

data/_sass/structure.scss

@@ -0,0 +1,8 @@
+/*
+ * Styles of structuring elements.
+ */
+h2 {
+	padding-top: 1em;
+}
+
+

data/_sass/tag-cloud.scss

@@ -6,6 +6,7 @@
 
 	li {
 		display: inline;
+		line-height: 1;
 	}
 	/* Every tag in the tag cloud should have a point as a separator. */
 	li::after {

data/assets/css/main.scss

@@ -11,6 +11,22 @@
 @import "address";
 @import "tag-cloud";
 @import "posts";
+@import "structure";
+
+/*
+ * import styles for highlighting source code that was annotated using rouge.
+ */
+@import "rouge-highlight";
+
+/*
+ * import styles for AsciiDoc.
+ */
+@import "adoc";
+@import "adoc-admonition";
+@import "adoc-tables";
+@import "adoc-lists";
+@import "adoc-quote";
+@import "adoc-images";
 
 /*
  * import SCSS-Code contributed by the user of the theme.

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

@@ -1,5 +1,5 @@
 module Jekyll
   module Endless
-    VERSION = '0.4.0'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-endless
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Sven Boekhoff
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-29 00:00:00.000000000 Z
+date: 2020-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -48,11 +48,20 @@ files:
 - _layouts/page.html
 - _layouts/post.html
 - _sass/address.scss
+- _sass/adoc-admonition.scss
+- _sass/adoc-images.scss
+- _sass/adoc-lists.scss
+- _sass/adoc-quote.scss
+- _sass/adoc-tables.scss
+- _sass/adoc.scss
 - _sass/background.scss
 - _sass/posts.scss
+- _sass/rouge-highlight.scss
+- _sass/structure.scss
 - _sass/tag-cloud.scss
 - _sass/user.scss
 - assets/css/main.scss
+- assets/images/tree-3822149_640.jpg
 - lib/jekyll-theme-endless.rb
 - lib/jekyll-theme-endless/generate-tagpages.rb
 - lib/jekyll-theme-endless/version.rb