releasehx 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36a63bdf0f36ba445d5fa83993aa354dcf3ded8d562bec625ddaf07dd94b4967
-  data.tar.gz: c10c4bf04cbe1c7654f552b2c01ee8304db375d8eb4cade74cd5534e9d152b4e
+  metadata.gz: d59a2e7cb45f862e4b5c39d17673854ca6741fe23d113e1cfb8a74a50e381fb7
+  data.tar.gz: ebf24c9f7f7f2b388494ea934cd34c18d7469c07c693fd1e19faceaa3bd09810
 SHA512:
-  metadata.gz: ce79b848b9cd3cd72cf27b54aa6ab0351f3b1c921d5399ac0b9bceeaed7abcbf75ae0eff7a937edbc5d097bf4e2097ec221e96cba0ce379d4f79b03fbdc2787e
-  data.tar.gz: 35d211eedd404ff1b41f4f6884eb558a41ea91ebf98ecdf3ec76db668f567c845134cdb2882d37b9bf587f95dd11df0299214404723c2697e76ed18bade406ec
+  metadata.gz: 5224482fa39c6423e95c8d386720ba165d79ecdc019471581509904ad147d893bc2a66c7f57681a1eca4679fbc80b84d87937dcd4f75ac0b197839a994a806bd
+  data.tar.gz: 38bbad9012e98c1dadbade6df3b5b719c9eb77fe61c72e6cdd2e971437536d004c5df2581db2ccf92f58abd93a059a199483ed45e113ddb5b8281438f45a69f0

data/README.adoc

@@ -15,7 +15,7 @@
 :this_prod_vrsn_major: 0
 :this_prod_vrsn_minor: 1
 :this_prod_vrsn_major-minor: {this_prod_vrsn_major}.{this_prod_vrsn_minor}
-:this_prod_vrsn_patch: 0
+:this_prod_vrsn_patch: 1
 :this_prod_vrsn: {this_prod_vrsn_major-minor}.{this_prod_vrsn_patch}
 :next_prod_vrsn: 0.2.0
 :tagline: Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.

data/lib/releasehx/generated.rb

@@ -2,7 +2,7 @@
 # Auto-generated by Sourcerer::Builder
 
 module ReleaseHx
-  ATTRIBUTES = {:globals=>{"attribute-undefined"=>"drop-line", "attribute-missing"=>"skip", "appendix-caption"=>"Appendix", "appendix-refsig"=>"Appendix", "caution-caption"=>"Caution", "chapter-refsig"=>"Chapter", "example-caption"=>"Example", "figure-caption"=>"Figure", "important-caption"=>"Important", "last-update-label"=>"Last updated", "note-caption"=>"Note", "part-refsig"=>"Part", "prewrap"=>"", "sectids"=>"", "section-refsig"=>"Section", "table-caption"=>"Table", "tip-caption"=>"Tip", "toc-placement"=>"macro", "toc-title"=>"Table of Contents", "untitled-label"=>"Untitled", "version-label"=>"Version", "warning-caption"=>"Warning", "notitle"=>"", "docfile"=>"/home/brian/Documents/work/releasehx/README.adoc", "docdir"=>"/home/brian/Documents/work/releasehx", "docfilesuffix"=>".adoc", "docname"=>"README", "embedded"=>"", "asciidoctor"=>"", "asciidoctor-version"=>"2.0.23", "safe-mode-name"=>"unsafe", "safe-mode-unsafe"=>"", "safe-mode-level"=>0, "max-include-depth"=>64, "user-home"=>"/home/brian", "doctype"=>"article", "htmlsyntax"=>"html", "backend-html5-doctype-article"=>"", "doctype-article"=>"", "backend-html5"=>"", "backend"=>"html5", "outfilesuffix"=>".html", "filetype"=>"html", "filetype-html"=>"", "basebackend-html-doctype-article"=>"", "basebackend-html"=>"", "basebackend"=>"html", "stylesdir"=>".", "iconsdir"=>"./images/icons", "localdate"=>"2026-01-01", "localyear"=>"2026", "localtime"=>"13:06:29 -0500", "localdatetime"=>"2026-01-01 13:06:29 -0500", "docdate"=>"2026-01-01", "docyear"=>"2026", "doctime"=>"04:37:26 -0500", "docdatetime"=>"2026-01-01 04:37:26 -0500", "page-layout"=>"default", "page-permalink"=>"/docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "docopslab_git_www"=>"https://github.com/DocOps", "this_prod_slug"=>"releasehx", "releasehx_prod_repo"=>"https://github.com/DocOps/releasehx", "releasehx_demo_repo"=>"https://github.com/DocOps/releasehx-demo", "this_prod_repo"=>"https://github.com/DocOps/releasehx", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"1", "this_prod_vrsn_major-minor"=>"0.1", "this_prod_vrsn_patch"=>"0", "this_prod_vrsn"=>"0.1.0", "next_prod_vrsn"=>"0.2.0", "tagline"=>"Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.", "description"=>"CLI utility and Ruby API for generating structured release notes and changelog documents from various issue-tracking platforms or YAML definitions into plaintext drafts (<strong>AsciiDoc</strong>, <strong>Markdown</strong>, <strong>YAML</strong>) and rich-text output (<strong>HTML</strong> and <strong>PDF</strong>).", "gem_config_definition_path"=>"./specs/data/config-def.yml", "app_default_config_path"=>"./.releasehx.yml", "default_markup"=>"markdown", "default_slug_type"=>"kebab", "default_tplt_lang"=>"liquid", "default_drafts_dir"=>"_drafts", "default_enrich_dir"=>"_publish", "default_output_dir"=>".", "default_payloads_dir"=>"_payloads", "default_templates_dir"=>"_templates", "default_mappings_dir"=>"_mappings", "default_api_clients_dir"=>"_apis", "default_cache_dir"=>".releasehx/cache", "default_api_cred_env"=>"RELEASEHX_API_CRED", "default_api_key_env"=>"RELEASEHX_API_KEY", "default_api_user_env"=>"RELEASEHX_API_USER", "default_api_org_env"=>"RELEASEHX_API_ORG", "markdown_extensions"=>".md, .markdown", "asciidoc_extensions"=>".adoc, .ad, .asciidoc", "yaml_extensions"=>".yml, .yaml, .rhyml", "draft_source_file_types"=>"AsciiDoc, Markdown, YAML", "draft_source_extensions"=>".md, .markdown, .adoc, .ad, .asciidoc, .yml, .yaml, .rhyml", "enrich_file_types"=>"HTML, PDF", "enrich_extensions"=>".html, .pdf", "docker_base_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "this_prod_repo_branch"=>"https://github.com/DocOps/releasehx/tree/release/0.1", "docs_extn"=>"", "toc"=>"", "toclevels"=>"3", "authorcount"=>0, "toc-position"=>"content"}}
+  ATTRIBUTES = {:globals=>{"attribute-undefined"=>"drop-line", "attribute-missing"=>"skip", "appendix-caption"=>"Appendix", "appendix-refsig"=>"Appendix", "caution-caption"=>"Caution", "chapter-refsig"=>"Chapter", "example-caption"=>"Example", "figure-caption"=>"Figure", "important-caption"=>"Important", "last-update-label"=>"Last updated", "note-caption"=>"Note", "part-refsig"=>"Part", "prewrap"=>"", "sectids"=>"", "section-refsig"=>"Section", "table-caption"=>"Table", "tip-caption"=>"Tip", "toc-placement"=>"macro", "toc-title"=>"Table of Contents", "untitled-label"=>"Untitled", "version-label"=>"Version", "warning-caption"=>"Warning", "notitle"=>"", "docfile"=>"/home/brian/Documents/work/releasehx/README.adoc", "docdir"=>"/home/brian/Documents/work/releasehx", "docfilesuffix"=>".adoc", "docname"=>"README", "embedded"=>"", "asciidoctor"=>"", "asciidoctor-version"=>"2.0.23", "safe-mode-name"=>"unsafe", "safe-mode-unsafe"=>"", "safe-mode-level"=>0, "max-include-depth"=>64, "user-home"=>"/home/brian", "doctype"=>"article", "htmlsyntax"=>"html", "backend-html5-doctype-article"=>"", "doctype-article"=>"", "backend-html5"=>"", "backend"=>"html5", "outfilesuffix"=>".html", "filetype"=>"html", "filetype-html"=>"", "basebackend-html-doctype-article"=>"", "basebackend-html"=>"", "basebackend"=>"html", "stylesdir"=>".", "iconsdir"=>"./images/icons", "localdate"=>"2026-01-01", "localyear"=>"2026", "localtime"=>"13:42:59 -0500", "localdatetime"=>"2026-01-01 13:42:59 -0500", "docdate"=>"2026-01-01", "docyear"=>"2026", "doctime"=>"13:41:27 -0500", "docdatetime"=>"2026-01-01 13:41:27 -0500", "page-layout"=>"default", "page-permalink"=>"/docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "docopslab_git_www"=>"https://github.com/DocOps", "this_prod_slug"=>"releasehx", "releasehx_prod_repo"=>"https://github.com/DocOps/releasehx", "releasehx_demo_repo"=>"https://github.com/DocOps/releasehx-demo", "this_prod_repo"=>"https://github.com/DocOps/releasehx", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"1", "this_prod_vrsn_major-minor"=>"0.1", "this_prod_vrsn_patch"=>"1", "this_prod_vrsn"=>"0.1.1", "next_prod_vrsn"=>"0.2.0", "tagline"=>"Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.", "description"=>"CLI utility and Ruby API for generating structured release notes and changelog documents from various issue-tracking platforms or YAML definitions into plaintext drafts (<strong>AsciiDoc</strong>, <strong>Markdown</strong>, <strong>YAML</strong>) and rich-text output (<strong>HTML</strong> and <strong>PDF</strong>).", "gem_config_definition_path"=>"./specs/data/config-def.yml", "app_default_config_path"=>"./.releasehx.yml", "default_markup"=>"markdown", "default_slug_type"=>"kebab", "default_tplt_lang"=>"liquid", "default_drafts_dir"=>"_drafts", "default_enrich_dir"=>"_publish", "default_output_dir"=>".", "default_payloads_dir"=>"_payloads", "default_templates_dir"=>"_templates", "default_mappings_dir"=>"_mappings", "default_api_clients_dir"=>"_apis", "default_cache_dir"=>".releasehx/cache", "default_api_cred_env"=>"RELEASEHX_API_CRED", "default_api_key_env"=>"RELEASEHX_API_KEY", "default_api_user_env"=>"RELEASEHX_API_USER", "default_api_org_env"=>"RELEASEHX_API_ORG", "markdown_extensions"=>".md, .markdown", "asciidoc_extensions"=>".adoc, .ad, .asciidoc", "yaml_extensions"=>".yml, .yaml, .rhyml", "draft_source_file_types"=>"AsciiDoc, Markdown, YAML", "draft_source_extensions"=>".md, .markdown, .adoc, .ad, .asciidoc, .yml, .yaml, .rhyml", "enrich_file_types"=>"HTML, PDF", "enrich_extensions"=>".html, .pdf", "docker_base_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "this_prod_repo_branch"=>"https://github.com/DocOps/releasehx/tree/release/0.1", "docs_extn"=>"", "toc"=>"", "toclevels"=>"3", "authorcount"=>0, "toc-position"=>"content"}}
 
   SNIPPET_LOOKUP = {"helpscreen"=>"helpscreen.txt"}
 

data/lib/releasehx/rhyml/templates/changelog.adoc.liquid

@@ -0,0 +1,14 @@
+{%- assign content_config = config.changelog %}
+{%- assign section_type = "changelog" %}
+{%- embed config-cascade.liquid %}
+{%- embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- capture header_chars %}
+{%-   for i in (1..level) %}{{ header_char }}{% endfor %}
+{%- endcapture %}
+{%- include header.liquid format=format level=level text=content_config.head %}
+{%- assign dflt_next_header_level = level | plus: 1 -%}
+{%- assign item_count = 0 %}
+{%- embed section-text.liquid %}
+
+{%- embed groupings.liquid %}

data/lib/releasehx/rhyml/templates/changelog.html.liquid

@@ -0,0 +1,14 @@
+{%- assign content_config = config.changelog %}
+{%- embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- assign dflt_next_header_level = level | plus: 1 -%}
+{%- assign item_count = 0 %}
+
+<div class="changelog-section">
+    {%- include header.liquid format=format level=level text=content_config.head %}
+
+    {%- embed section-text.liquid %}
+
+    {%- embed groupings.liquid %}
+</div>
+

data/lib/releasehx/rhyml/templates/changelog.md.liquid

@@ -0,0 +1,11 @@
+{%- assign content_config = config.changelog %}
+{%- assign section_type = "changelog" %}
+{%- embed config-cascade.liquid %}
+{% embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- include header.liquid format=format level=level text=content_config.head %}
+{%- assign dflt_next_header_level = level | plus: 1 -%}
+{%- assign item_count = 0 %}
+{%- embed section-text.liquid %}
+
+{%- embed groupings.liquid %}

data/lib/releasehx/rhyml/templates/changes-sorter.liquid

@@ -0,0 +1,64 @@
+{%- assign groups = '' | split: ',' %}
+{%- assign grouping1 = '' | split: ',' %}
+{%- assign grouping2 = '' | split: ',' %}
+
+{%- for group_expr in content_config.sort %}
+{%-   assign kind = group_expr | split: ':' | first %}
+{%-   assign target = group_expr | split: ':' | last %}
+
+{%-   if kind == 'tag' or kind == 'tags' %}
+{%-     for tag_entry in config.tags %}
+{%-       assign tag_name = tag_entry[0] %}
+{%-       if tag_name == '_include' or tag_name == '_exclude' %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'tag:' | append: tag_name %}
+{%-       assign group = group | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   elsif kind == 'type' %}
+{%-     for type_entry in config.types %}
+{%-       assign type_name = type_entry[0] %}
+{%-       if type_name contains "<" %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'type:' | append: type_name | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   elsif kind == 'part' %}
+{%-     for part_entry in config.parts %}
+{%-       assign part_name = part_entry[0] %}
+{%-       if part_name contains "<" or part_name == 'label_prefix' %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'part:' | append: part_name | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   else %}
+{%-     assign group = 'tag:' | append: kind | split: ',' %}
+{%-     if target == 'grouping1' %}
+{%-       assign grouping1 = grouping1 | concat: group %}
+{%-     elsif target == 'grouping2' %}
+{%-       assign grouping2 = grouping2 | concat: group %}
+{%-     endif %}
+{%-   endif %}
+{%- endfor %}
+
+{%- if grouping2.size > 0 and grouping1 == empty %}
+Invalid sort: cannot define grouping2 without grouping1
+{%- endif %}

data/lib/releasehx/rhyml/templates/config-cascade.liquid

@@ -0,0 +1,61 @@
+{%- comment -%}
+  Configuration cascade logic that handles inheritance from config.history.items
+  to config.changelog.items and config.notes.items.
+
+  This template should be embedded early in the template chain to set up
+  simplified variables that can be used throughout the templates.
+{%- endcomment -%}
+
+{%- comment -%} Base configuration from config.history.items {%- endcomment -%}
+{%- assign base_config = config.history.items -%}
+
+{%- comment -%} Apply cascade logic based on section type {%- endcomment -%}
+{%- if section_type == "changelog" -%}
+  {%- assign effective_config = config.changelog.items -%}
+{%- elsif section_type == "notes" -%}
+  {%- assign effective_config = config.notes.items -%}
+{%- else -%}
+  {%- assign effective_config = base_config -%}
+{%- endif -%}
+
+{%- comment -%} Create cascaded configuration variables {%- endcomment -%}
+{%- assign entry_show_lead = effective_config.show_lead | default: base_config.show_lead -%}
+{%- assign note_show_lead = effective_config.show_lead | default: base_config.show_lead -%}
+{%- assign entry_show_issue_links = effective_config.show_issue_links | default: base_config.show_issue_links -%}
+{%- assign note_show_issue_links = effective_config.show_issue_links | default: base_config.show_issue_links -%}
+{%- assign entry_show_git_links = effective_config.show_git_links | default: base_config.show_git_links -%}
+{%- assign note_show_git_links = effective_config.show_git_links | default: base_config.show_git_links -%}
+{%- assign entry_metadata_labels = effective_config.metadata_labels | default: base_config.metadata_labels -%}
+{%- assign note_metadata_labels = effective_config.metadata_labels | default: base_config.metadata_labels -%}
+{%- assign entry_metadata_icons = effective_config.metadata_icons | default: base_config.metadata_icons -%}
+{%- assign note_metadata_icons = effective_config.metadata_icons | default: base_config.metadata_icons -%}
+{%- assign entry_allow_redundant = effective_config.allow_redundant | default: base_config.allow_redundant -%}
+{%- assign note_allow_redundant = effective_config.allow_redundant | default: base_config.allow_redundant -%}
+
+{%- comment -%} New label display control variables {%- endcomment -%}
+{%- assign entry_show_type_label = effective_config.show_type_label | default: base_config.show_type_label -%}
+{%- assign note_show_type_label = effective_config.show_type_label | default: base_config.show_type_label -%}
+{%- assign entry_show_parts_label = effective_config.show_parts_label | default: base_config.show_parts_label -%}
+{%- assign note_show_parts_label = effective_config.show_parts_label | default: base_config.show_parts_label -%}
+{%- assign entry_show_tags_label = effective_config.show_tags_label | default: base_config.show_tags_label -%}
+{%- assign note_show_tags_label = effective_config.show_tags_label | default: base_config.show_tags_label -%}
+{%- assign entry_show_lead_label = effective_config.show_lead_label | default: base_config.show_lead_label -%}
+{%- assign note_show_lead_label = effective_config.show_lead_label | default: base_config.show_lead_label -%}
+{%- assign entry_show_auths_label = effective_config.show_auths_label | default: base_config.show_auths_label -%}
+{%- assign note_show_auths_label = effective_config.show_auths_label | default: base_config.show_auths_label -%}
+
+{%- comment -%} User link template for bio/homepage links {%- endcomment -%}
+{%- assign entry_user_link_template = config.links.user.href -%}
+{%- assign note_user_link_template = config.links.user.href -%}
+
+{%- comment -%} Labeling configuration variables {%- endcomment -%}
+{%- assign labeling_singularize_labels = config.history.labeling.singularize_labels -%}
+{%- assign labeling_type_label = config.history.labeling.type_label -%}
+{%- assign labeling_parts_label = config.history.labeling.parts_label -%}
+{%- assign labeling_part_label = config.history.labeling.part_label -%}
+{%- assign labeling_tags_label = config.history.labeling.tags_label -%}
+{%- assign labeling_tag_label = config.history.labeling.tag_label -%}
+{%- assign labeling_lead_label = config.history.labeling.lead_label -%}
+{%- assign labeling_auths_label = config.history.labeling.auths_label -%}
+{%- assign labeling_auth_label = config.history.labeling.auth_label -%}
+{%- assign labeling_join_string = config.history.labeling.join_string -%}

data/lib/releasehx/rhyml/templates/entry.adoc.liquid

@@ -0,0 +1,26 @@
+{%- embed metadata-entry.adoc.liquid -%}
+{%- assign frame = content_config.items.frame %}
+{%- assign summ  = change.summ %}
+{%- case frame %}
+{%-   when "unordered" %}
+{%-     assign bullet = "* " %}
+{%-   when "ordered" %}
+{%-     assign bullet = ". " %}
+{%-   else %}
+{%-     assign bullet = "" %}
+{%- endcase %}
+
+{% unless changes_listed contains change.chid -%}
+[[entry-{{ change.chid }}]]
+{%- endunless %}
+{%- if frame == "ordered" %}
+[start={{ item_count }}]
+{%- endif %}
+{{ bullet -}}
+{{ change.summ | trim }} +
+{%- if change_metadata != "" -%}
+{{ change_metadata | trim }}
+{%- endif %}
+{%- if change.note %}
+xref:note-{{ change.chid }}[icon:sticky-note[]NOTE]
+{%- endif %}

data/lib/releasehx/rhyml/templates/entry.html.liquid

@@ -0,0 +1,38 @@
+{%- embed metadata-entry.html.liquid -%}
+{%- assign frame = frame %}
+{%- case frame %}
+{%-   when "unordered" %}
+{%-     assign list_class = "list-unstyled" %}
+{%-     assign item_class = "mb-2" %}
+{%-     assign bullet = "• " %}
+{%-   when "ordered" %}
+{%-     assign list_class = "list-group list-group-numbered" %}
+{%-     assign item_class = "list-group-item border-0 px-0" %}
+{%-     assign bullet = "" %}
+{%-   else %}
+{%-     assign list_class = "list-unstyled" %}
+{%-     assign item_class = "mb-2" %}
+{%-     assign bullet = "" %}
+{%- endcase %}
+
+<div class="change-entry {{ item_class }}" id="entry-{{ change.chid }}">
+    <div class="d-flex align-items-start">
+        <div class="flex-grow-1">
+            <span class="change-summary">{{ bullet }}{{ change.summ | trim | pasterize }}</span>
+            {%- if change_metadata != "" -%}
+            <div class="change-metadata mt-1">
+                {{ change_metadata | trim }}
+            </div>
+            {%- endif %}
+        </div>
+        {%- if change.note %}
+        <div class="note-link">
+            <a href="#note-{{ change.chid }}" class="text-decoration-none">
+                <i class="fa fa-sticky-note-o"></i>
+                <small>NOTE</small>
+            </a>
+        </div>
+        {%- endif %}
+    </div>
+</div>
+

data/lib/releasehx/rhyml/templates/entry.md.liquid

@@ -0,0 +1,25 @@
+{%- embed metadata-entry.md.liquid -%}
+{%- assign frame = content_config.items.frame | default: "unordered" %}
+{%- assign summ = change.summ %}
+{%- case frame %}
+{%-   when "unordered" %}
+{%-     assign bullet = "- " %}
+{%-   when "ordered" %}
+{%-     assign bullet = "1. " %}
+{%-   when "basic" %}
+{%-     assign bullet = "- " %}
+{%-   else %}
+{%-     assign bullet = "" %}
+{%- endcase %}
+
+{%- if frame == "basic" %}
+
+{{ bullet }}{{ change.summ | trim }}{% if change_metadata != "" %} ({{ change_metadata | trim | replace: " | ", ", " }}){% endif %}{% if change.note and change.note != "" %} [NOTE](#note-{{ change.chid }}){% endif %}
+{%- elsif frame == "paragraph" %}
+
+{{ change.summ | trim }}{% if change_metadata != "" %} ({{ change_metadata | trim }}){% endif %}{% if change.note and change.note != "" %} [NOTE](#note-{{ change.chid }}){% endif %}
+{%- else %}
+
+{{ bullet }}{{ change.summ | trim }}{% if change_metadata != "" %} ({{ change_metadata | trim }}){% endif %}{% if change.note and change.note != "" %} [NOTE](#note-{{ change.chid }}){% endif %}
+{%- endif %}
+

data/lib/releasehx/rhyml/templates/groupby.liquid

@@ -0,0 +1,12 @@
+{%-  assign kind = group | split: ":" | first %}
+{%-  assign slug = group | split: ":" | last %}
+
+{%-  if kind == "tag" %}
+{%-    assign entry = config.tags[slug] %}
+{%-  elsif kind == "type" %}
+{%-    assign entry = config.types[slug] %}
+{%-  elsif kind == "part" %}
+{%-    assign entry = config.parts[slug] %}
+{%-  endif %}
+{%-  assign dflt_head = entry.text | default: slug | capitalize %}
+{%-  assign group_heading = entry.head | default: dflt_head %}

data/lib/releasehx/rhyml/templates/groupings.liquid

@@ -0,0 +1,97 @@
+
+{%- assign changes_listed = "" | split: "," %}
+{%- if section_type == "notes" %}
+{%-   assign allow_redundant = note_allow_redundant %}
+{%- else %}
+{%-   assign allow_redundant = entry_allow_redundant %}
+{%- endif %}
+{%- if grouping1.size > 0 %}
+{%-   for group1 in grouping1 %}
+{%-     assign group = group1 %}
+{%-     assign group1_kind = group1 | split: ":" | first %}
+{%-     assign group1_slug = group1 | split: ":" | last %}
+{%-     assign grouping1_header_level = dflt_next_header_level | default: 3 %}
+{%-     embed groupby.liquid %}
+{%-     case section_type %}
+{%-     when "notes" %}
+{%-       assign group1_changes = sorted.by[group1_kind][group1_slug] | where_exp: "c", "c.note != nil" %}
+{%-     else %}
+{%-       assign group1_changes = sorted.by[group1_kind][group1_slug] %}
+{%-     endcase %}
+{%-     assign group1_heading = group_heading %}
+{%-     assign group1_heading_shown = false %}
+{%-     if grouping2.size > 0 %}
+{%-       assign grouping2_header_level = grouping1_header_level | plus: 1 %}
+
+{%-       for group2 in grouping2 %}
+{%-         assign group = group2 %}
+{%-         assign group2_kind = group2 | split: ":" | first %}
+{%-         assign group2_slug = group2 | split: ":" | last %}
+{%-         embed groupby.liquid %}
+{%-         assign group2_heading = group_heading %}
+{%-         assign group2_heading_shown = false %}
+
+{%-         for change in group1_changes %}
+{%-           if !allow_redundant and changes_listed contains change.chid %}
+{%-             continue %}
+{%-           endif %}
+{%-           assign note_trimmed = change.note | trim %}
+{%-           if section_type == "notes" and note_trimmed == ""  %}
+{%-             continue %}
+{%-           endif %}
+
+{%-           assign match2 = false %}
+
+{%-           if group2_kind == "tag" and change.tags contains group2_slug %}
+{%-             assign match2 = true %}
+{%-           elsif group2_kind == "type" and change.type == group2_slug %}
+{%-             assign match2 = true %}
+{%-           elsif group2_kind == "part" and change.parts contains group2_slug %}
+{%-             assign match2 = true %}
+{%-           endif %}
+
+{%-           if match2 %}
+{%-             unless group1_heading_shown %}
+{%-               assign group1_heading_shown = true %}
+{%-               include header.liquid 
+                    format=format
+                    level=grouping1_header_level
+                    text=group1_heading %}
+{%-             endunless %}
+{%-             unless group2_heading_shown %}
+{%-               assign group2_heading_shown = true %}
+{%-               include header.liquid 
+                    format=format
+                    level=grouping2_header_level
+                    text= group2_heading %}
+{%-             endunless %}
+{%-             assign chid_arrayed = change.chid | split: "," %}
+{%-             assign changes_listed = changes_listed | concat: chid_arrayed | uniq %}
+{%-             embed item.liquid %}
+{%-           endif %}
+{%-         endfor %}
+{%-       endfor %}
+{%-     else %}
+{%-       for change in group1_changes %}
+{%-         if !allow_redundant and changes_listed contains change.chid %}
+{%-           continue %}
+{%-         endif %}
+{%-         embed groupby.liquid %}
+{%-         unless group1_heading_shown %}
+{%-           assign group1_heading_shown = true %}
+{%            include header.liquid
+                format=format
+                level=grouping1_header_level
+                text=group1_heading %}
+{%-         endunless %}
+{%-         assign chid_arrayed = change.chid | split: "," %}
+{%-         assign changes_listed = changes_listed | concat: chid_arrayed | uniq %}
+{%-         embed item.liquid %}
+{%-       endfor %}
+{%-     endif %}
+{%-   endfor %}
+{%- else %}
+{%-   for change in changes %}
+{%-     embed item.liquid %}
+{%-   endfor %}
+{%- endif %}

data/lib/releasehx/rhyml/templates/groups-parser.liquid

@@ -0,0 +1,60 @@
+{%-  assign sort        = config.notes.sort | default: "type:group" %}
+{%-  assign groups      = "" | split: "," %}
+{%-  assign grouping1   = "" | split: "," %}
+{%-  assign grouping2   = "" | split: "," %}
+{%-  assign sort_by     = "type" %}
+
+{%-  for sorter in sort %}
+{%-    assign parts = sorter | split: ":" %}
+{%-    assign key   = parts[0] %}
+{%-    assign mode  = parts[1] | default: "label" %}
+
+{%-    if mode == "label" or mode == "none" %}
+{%-      assign sort_by = key %}
+{%-      continue %}
+{%-    endif %}
+
+{%-    case key %}
+{%-      when "type" %}
+{%-        assign list = config.notes.types | default: config.types %}
+{%-      when "part" %}
+{%-        assign list = config.notes.parts | default: config.parts %}
+{%-      when "tag" %}
+{%-        assign list = config.notes.tags | default: config.tags %}
+{%-      else %}
+{%-        assign list = key | split: "," %}
+{%-    endcase %}
+
+{%-    for entry in list %}
+{%-      assign item = entry %}
+{%-      if entry[0] %}
+{%-        assign name = entry[0] %}
+{%-        if name == 'label_prefix' %}
+{%-          continue %}
+{%-        endif %}
+{%-      else %}
+{%-        assign name = entry %}
+{%-      endif %}
+
+{%-      assign group_key = key | append: ":" | append: name %}
+{%-      assign group = group_key | split: "," %}
+
+{%-      if mode == "grouping1" %}
+{%-        assign grouping1 = grouping1 | concat: group %}
+{%-      elsif mode == "grouping2" %}
+{%-        assign grouping2 = grouping2 | concat: group %}
+{%-      elsif mode == "group" %}
+{%-        assign groups = groups | concat: group %}
+{%-      endif %}
+{%-    endfor %}
+{%-  endfor %}
+
+{%-  if grouping1.size > 0 %}
+{%-    assign grouping1 = grouping1 | concat: groups | uniq %}
+{%-  else %}
+{%-    assign grouping1 = groups %}
+{%-  endif %}
+
+{%-  if grouping2.size > 0 and grouping1 == empty %}
+Improper grouping configuration: grouping2 requires grouping1.
+{%-  endif %}

data/lib/releasehx/rhyml/templates/head-parser.liquid

@@ -0,0 +1,34 @@
+{%-  case format %}
+{%-    when "asciidoc" %}
+{%-      assign tplt_extn = "adoc" %}
+{%-      assign header_char = "=" %}
+{%-      assign show_frontmatter = config.modes.asciidoc_frontmatter %}
+{%-      assign format_frontmatter = config.history.asciidoc_frontmatter %}
+{%-    when "markdown" %}
+{%-      assign tplt_extn = "md" %}
+{%-      assign header_char = "#" %}
+{%-      assign show_frontmatter = config.modes.markdown_frontmatter %}
+{%-      assign format_frontmatter = config.history.markdown_frontmatter %}
+{%-    when "html" %}
+{%-      assign tplt_extn = "html" %}
+{%-      assign show_frontmatter = config.modes.html_frontmatter %}
+{%-      assign format_frontmatter = config.history.html_frontmatter %}
+{%-  endcase %}
+{%-  assign header_level = config.history.htag | replace: "h", "" | plus: 0 %}
+{%-  assign dflt_next_header_level = header_level | plus: 1 %}
+{%-  assign history_header = config.history.head %}
+
+{%-  if config.notes %}
+{%-    assign release_notes_spot = config.notes.spot | default: 2 %}
+{%-  endif %}
+{%-  if config.changelog %}
+{%-    assign changelog_spot = config.changelog.spot | default: 2 %}
+{%-  endif %}
+
+{%-  assign group_kinds_list = "tag,type,part" | split: "," %}
+
+{%- if show_frontmatter %}
+{{ format_frontmatter | render: vars -}}
+{%- endif %}
+
+{%- include header.liquid format=format level=header_level text=history_header %}

data/lib/releasehx/rhyml/templates/header.liquid

@@ -0,0 +1,17 @@
+{%- assign text = include.text %}
+{%- assign level = include.level %}
+{%- assign format = include.format %}
+{%- if format == "html" %}
+<h{{ level }}>{{ text }}</h{{ level }}>
+{%- else %}
+{%-   if format == "asciidoc" %}
+{%-     assign header_char = "=" %}
+{%-   else %}
+{%-     assign header_char = "#" %}
+{%-   endif %}
+{%-   capture header_chars %}
+{%-     for i in (1..level) %}{{ header_char }}{% endfor %}
+{%-   endcapture %}
+{{ header_chars }} {{ text }}
+
+{%- endif %}

data/lib/releasehx/rhyml/templates/history.adoc.liquid

@@ -0,0 +1,11 @@
+= Release History
+{%- for release in var.releases %}
+{%-   assign config  = var.config %}
+{%-   assign release = var.release %}
+{%-   assign changes = var.changes %}
+{%-   assign sorted  = var.sorted -%}
+{%-   include release.adoc.liquid
+       release=release
+       config=config
+       level=2 %}
+{%- endfor %}

data/lib/releasehx/rhyml/templates/history.html.liquid

@@ -0,0 +1,54 @@
+{%  raw %}
+{%- if config.modes.wrapped != false -%}
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ config.history.head | default: "Release History" }}</title>
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+    <style>
+        .release-section { margin-bottom: 3rem; }
+        .changelog-section, .notes-section { margin-bottom: 2.5rem; }
+        .release-note { margin-bottom: 1.5rem; }
+        .meta-icon { margin-right: 0.25rem; }
+        .meta-label { margin-right: 0.5rem; }
+        .change-entry { margin-bottom: 1rem; }
+        .change-metadata { font-size: 0.9rem; color: #6c757d; }
+        .note-link { margin-left: 0.5rem; }
+        .git-link, .issue-link { margin-left: 0.25rem; }
+    </style>
+</head>
+<body class="container py-4">
+{%- endif -%}
+
+{%- if config.modes.html_frontmatter -%}
+{%-   assign frontmatter = config.history.html_frontmatter | render: vars -%}
+{%-   if frontmatter and frontmatter != "" -%}
+<!-- {{ frontmatter }} -->
+{%-   endif -%}
+{%- endif -%}
+
+<div class="release-history">
+    <h1 class="mb-4">{{ config.history.head | render: vars | default: "Release History" }}</h1>
+
+    {%- for release in var.releases %}
+    {%-   assign config  = var.config %}
+    {%-   assign release = var.release %}
+    {%-   assign changes = var.changes %}
+    {%-   assign sorted  = var.sorted -%}
+    {%-   include release.html.liquid
+           release=release
+           config=config
+           level=2 %}
+    {%- endfor %}
+</div>
+
+{%- if config.modes.wrapped != false -%}
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
+</body>
+</html>
+{%- endif -%}
+
+{% endraw %}

data/lib/releasehx/rhyml/templates/history.md.liquid

@@ -0,0 +1,16 @@
+# Release History
+
+{% for release in vars.releases -%}
+{% assign config  = vars.config -%}
+{% assign release = vars.release -%}
+{% assign changes = vars.changes -%}
+{% assign sorted  = vars.sorted -%}
+{% include release.md.liquid
+     release=release
+     changes=changes
+     sorted=sorted
+     format=config.conversions.markup
+     config=config
+     level=2 -%}
+{% endfor %}
+