From dcabd012a95409a3208afee3ccffcbd6b74e02d2 Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Thu, 28 May 2026 09:20:10 -0400 Subject: [PATCH 1/6] fix: Correct indentation and variable name in rhyml-change.yaml.liquid Regression introduced in 62c2a65: - _note (undefined) should be change.note - summ: and its block content lost 2-space indent - part:/parts: were at 4-space instead of 2-space indent - note block content indent updated from 6 to 4 to match new key indent level - invalid change.note.strip replaced with change.note != '' --- .../rhyml/templates/rhyml-change.yaml.liquid | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid b/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid index 30d8ded..1ae12e2 100644 --- a/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid +++ b/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid @@ -9,25 +9,25 @@ {%- endif %} {%- if change.parts.size > 0 %} {%- if change.parts.size == 1 %} - part: {{ change.parts[0] }} + part: {{ change.parts[0] }} {%- else %} - parts: + parts: {%- for part in change.parts %} - - {{ part }} + - {{ part }} {%- endfor %} {%- endif %} {%- endif %} {%- if change.hash %} hash: {{ change.hash }} {%- endif %} -summ: | -{{ change.summ }} + summ: | + {{ change.summ }} {%- if change.head %} head: {{ change.head }} {%- endif %} -{%- if change.note and change.note.strip != '' %} +{%- if change.note and change.note != '' %} note: | - {{ _note | indent: 6 }} + {{ change.note | indent: 4 }} {%- endif %} {%- if change.tags.size > 0 %} tags: From cbf16c5cd1ae6e085061a8d74319d5e7b1663fcf Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Thu, 28 May 2026 10:00:00 -0400 Subject: [PATCH 2/6] chore(docs): Attributes/URL/URI updates --- AGENTS.md | 2 +- README.adoc | 36 +++++++++++++++++++++--------------- docs/release-procedure.adoc | 6 ++++++ 3 files changed, 28 insertions(+), 16 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c77fe30..6ed79ce 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -272,7 +272,7 @@ bundle exec rspec specs/tests/rspec --format documentation The releasehx-demo repository can help illustrate real usage (optional): ```bash -git clone {releasehx_demo_repo} +git clone git@github.com:DocOps/releasehx-demo.git cd releasehx-demo # Study different API data structures diff --git a/README.adoc b/README.adoc index efa7255..a53d67b 100644 --- a/README.adoc +++ b/README.adoc @@ -12,23 +12,25 @@ :this_proj_slug: releasehx :this_proj_name: ReleaseHx // tag::universal-settings[] +// ALL changes within this block must be made in prime template: +// DocOps/lab/gems/docopslab-dev/templates/README.asciidoc :docopslab_src_www_url: https://github.com/DocOps :docopslab_domain: docopslab.org :docopslab_www_url: https://{docopslab_domain} :docopslab_io_www_url: https://docopslab.github.io :docopslab_ruby_version: 3.2.7 -:docopslab_src_www_url: https://raw.githubusercontent.com/DocOps :docopslab_git_src_uri: git@github.com:DocOps +:docopslab_src_raw_url: https://raw.githubusercontent.com/DocOps :this_proj_src_www_url: {docopslab_src_www_url}/{this_proj_slug} -:this_proj_src_raw_url: https://raw.githubusercontent.com/DocOps/{this_proj_slug}/main +:this_proj_src_raw_url: {docopslab_src_raw_url}/{this_proj_slug} +:this_proj_src_main_raw_url: {this_proj_src_raw_url}/main :this_proj_src_main_files_url: {this_proj_src_www_url}/blob/main -:this_proj_src_main_edit_url: {this_proj_src_www_url}/edit/main :this_proj_src_git_uri: {docopslab_git_src_uri}/{this_proj_slug}.git :this_proj_ruby_version: {docopslab_ruby_version} // tag::env-settings[] -:extn: +:docs_extn: ifdef::env-github[] -:extn: .adoc +:docs_extn: .adoc :icons: font :caution-caption: :fire: :important-caption: :exclamation: @@ -37,8 +39,12 @@ ifdef::env-github[] :warning-caption: :warning: endif::[] // end::env-settings[] +// Settings likely to be overridden locally +:this_prod_slug: {this_proj_slug} +:this_prod_name: {this_proj_name} +:this_prod_src_www_url: {this_proj_src_www_url} // end::universal-settings[] -:releasehx_demo_repo: {docopslab_src_www_url}/releasehx-demo +:releasehx-demo_repo_www_url: {docopslab_src_www_url}/releasehx-demo // tag::product-settings[] :this_prod_slug: {this_proj_slug} // tag::version-settings[] @@ -461,7 +467,7 @@ Then have it consult `releasehx://config/sample` as a table of contents before u [[demo-setup]] ==== Demo Repo Setup -If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx_demo_repo}[DocOps/releasehx-demo]` repository as instructed in this section. +If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx-demo_repo_www_url}[DocOps/releasehx-demo]` repository as instructed in this section. Alternately, skip to <> to begin configuring your own project/environment. @@ -632,7 +638,7 @@ Out of the box, there are two issues in the `jira-customfield-note-1.1.0.json` f [.prompt.testable] rhx 1.1.0 --config configs/jira-customfield.yml --api-data _payloads/jira-customfield-note-1.1.0.json --html --pdf -For more on the demo repo, visit its README at {releasehx_demo_repo}. +For more on the demo repo, visit its README at {releasehx-demo_repo_www_url}. [[custom-configuration]] ==== Custom Configuration @@ -923,7 +929,7 @@ For *custom field-based* release notes, the entire ADF content in the custom fie No heading extraction is performed. -- -See link:{releasehx_demo_repo}[releasehx-demo] repository for working examples with ADF payloads and configurations. +See link:{releasehx-demo_repo_www_url}[releasehx-demo] repository for working examples with ADF payloads and configurations. [[github-issues]] ==== GitHub Issues @@ -1350,7 +1356,7 @@ When rendered, the HTML will include: } ---- -For examples of dark theme in action, see the demo configurations in the {releasehx_demo_repo}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`. +For examples of dark theme in action, see the demo configurations in the {releasehx-demo_repo_www_url}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`. [[html-wrapper-control]] ===== HTML Wrapper Control @@ -1954,7 +1960,7 @@ ReleaseHx comes with a complete default configuration file as well as a series o The complete link:{default-config_www}[default config file] displays default values with commented descriptions of all available properties. -The various sample configurations stored in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup. +The various sample configurations stored in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup. [[env-vars]] === Environment Variables in ReleaseHx @@ -2188,7 +2194,7 @@ For example, if your GitHub issues use labels like: Your ReleaseHx application will need an alternate mapping because the default GitHub mapping expects native `issue_type.name` fields. An example alternate mapping for label-based GitHub type extraction can be found at: -link:{releasehx_demo_repo}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`] +link:{releasehx-demo_repo_www_url}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`] This mapping includes Ruby logic to: @@ -2240,7 +2246,7 @@ To use an alternate mapping: . Test with representative payload data to ensure proper extraction -The link:{releasehx_demo_repo}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads. +The link:{releasehx-demo_repo_www_url}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads. [NOTE] ReleaseHx by default looks for a mapping file that matches the name of the API you are using. @@ -2276,7 +2282,7 @@ Using the ReleaseHx config file, you can manipulate: Most of this can be manipulated using the following sections: <>, <>, <>, <>, as well as within change-metadata config blocks, where you can alter labels, icons, and such: <>, <>, <>. -The various sample configurations found in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] illustrate many of these options. +The various sample configurations found in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] illustrate many of these options. A complete link:{default-config_www}[sample config] displays default values and commented descriptions of all available properties. @@ -2550,7 +2556,7 @@ To work with ReleaseHx source, clone both repositories side by side for the most + [.prompt] git clone {this_proj_src_www_url} - git clone {releasehx_demo_repo} + git clone {releasehx-demo_repo_www_url} + This will give you `/releasehx` and `/releasehx-demo`, side by side. diff --git a/docs/release-procedure.adoc b/docs/release-procedure.adoc index 8cf2bfe..c2579fb 100644 --- a/docs/release-procedure.adoc +++ b/docs/release-procedure.adoc @@ -1,4 +1,5 @@ = ReleaseHx Release Procedure +include::../README.adoc[tags="global-settings"] This document outlines the step-by-step procedure for releasing a new version of ReleaseHx. @@ -276,6 +277,11 @@ gh release create v0.x.y pkg/releasehx-0.x.y.gem \ --notes "See release notes at https://releasehx.docopslab.org/docs/releases/" ---- +[[stage-demo-repo-release]] +=== Stage {counter:stage}: Release releasehx-demo + +Follow the release process documented in the {releasehx-demo_repo_www_url}[releasehx-demo] repo's `README.adoc`. + [[stage-release-verification]] === Stage {counter:stage}: Post-Release Verification From adb68f11d42503b424122544632a66e95254bb74 Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Thu, 28 May 2026 10:17:14 -0400 Subject: [PATCH 3/6] chore: Bump version to 0.2.1 --- Gemfile.lock | 2 +- README.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 1068483..0fe9298 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: . specs: - releasehx (0.2.0) + releasehx (0.2.1) asciidoctor-html5s (~> 0.5) asciidoctor-pdf (~> 2.3) asciisourcerer (~> 0.4) diff --git a/README.adoc b/README.adoc index a53d67b..885e369 100644 --- a/README.adoc +++ b/README.adoc @@ -51,7 +51,7 @@ endif::[] :this_prod_vrsn_major: 0 :this_prod_vrsn_minor: 2 :this_prod_vrsn_majmin: {this_prod_vrsn_major}.{this_prod_vrsn_minor} -:this_prod_vrsn_patch: 0 +:this_prod_vrsn_patch: 1 :this_prod_vrsn: {this_prod_vrsn_majmin}.{this_prod_vrsn_patch} :next_prod_vrsn: 0.3.0 :next_prod_vrsn_majmin: 0.3 From 288091010f5f2096a6299523a8df44c28fa88c43 Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Thu, 28 May 2026 17:42:29 -0400 Subject: [PATCH 4/6] docs: Add release notes for 0.2.1 --- docs/release/0.2.1.adoc | 53 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/release/0.2.1.adoc diff --git a/docs/release/0.2.1.adoc b/docs/release/0.2.1.adoc new file mode 100644 index 0000000..29d3843 --- /dev/null +++ b/docs/release/0.2.1.adoc @@ -0,0 +1,53 @@ +:icons: font +:page-title: Release History for 0.2.1 +:page-version: 0.2.1 +:page-date: 2026-05-28 +:page-permalink: /docs/releases/0.2.1 += Release History -- 0.2.1 - 2026-05-28 + + +[.release-section] +== What's Changed + + +Summary of all changes in this release. + + +[.changelog-section] + + +=== Fixed + + +[.change-entry] +* Fixed broken YAML output when changes contain notes + + +xref:note-0_2_1-liquid-template[NOTE] + + +== Release Notes + + +Detailed descriptions of notable changes. + + +[.notes-section] + + +=== Fixed +[[note-0_2_1-liquid-template]] +[.release-note] +-- +The `rhyml-change.yaml.liquid` template contained four defects introduced in 0.2.0 that caused `Liquid error: internal` followed by a YAML `SyntaxError` whenever a change entry included a release note. + +Specifically: + +* `_note` was referenced as a variable but never defined (should be `change.note`) +* `summ:` key was output at column 0 instead of the required 2-space indent +* `part:` key was indented 4 spaces instead of 2 +* `.strip` was applied as a Liquid filter, which is not valid Liquid syntax + +All four are corrected. +Any configuration that includes `conversions.note` (Jira, GitHub, GitLab, or RHYML sources with note content) is affected by this bug and should upgrade to 0.2.1. + +-- From 091c9dc110511297d2e4a5b095e0aebd58f7999c Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Thu, 28 May 2026 19:02:32 -0400 Subject: [PATCH 5/6] chore(docs): Migrate release files to Jekyll collection (_releases/) - Move docs/release/ -> docs/_releases/ (Jekyll collection dir) - Update config - Update path references - Modify Rakefile generate_release_index: all releases inline with anchor links --- .config/docopslab-dev.yml | 2 +- .config/releasehx.yml | 8 +++--- .gitignore | 4 +-- Rakefile | 37 +++++++++++++------------- docs/_config.yml | 3 ++- docs/{release => _releases}/0.1.2.adoc | 3 +-- docs/{release => _releases}/0.2.0.adoc | 3 +-- docs/{release => _releases}/0.2.1.adoc | 3 +-- docs/release-procedure.adoc | 4 +-- 9 files changed, 33 insertions(+), 34 deletions(-) rename docs/{release => _releases}/0.1.2.adoc (97%) rename docs/{release => _releases}/0.2.0.adoc (98%) rename docs/{release => _releases}/0.2.1.adoc (95%) diff --git a/.config/docopslab-dev.yml b/.config/docopslab-dev.yml index e5f3ee0..db32590 100644 --- a/.config/docopslab-dev.yml +++ b/.config/docopslab-dev.yml @@ -56,7 +56,7 @@ tools: - specs/* - "**/config-reference.adoc" - docs/releases.adoc - - docs/release/* + - docs/_releases/* - .bundle/* - .agent/* - docs/manpage.adoc diff --git a/.config/releasehx.yml b/.config/releasehx.yml index 8cf9439..8864dbd 100644 --- a/.config/releasehx.yml +++ b/.config/releasehx.yml @@ -9,10 +9,10 @@ origin: format: json paths: - drafts_dir: docs/release/drafts - payloads_dir: docs/release/payloads - templates_dir: docs/release/templates - mappings_dir: docs/release/mappings + drafts_dir: docs/_releases/drafts + payloads_dir: docs/_releases/payloads + templates_dir: docs/_releases/templates + mappings_dir: docs/_releases/mappings conversions: summ: issue_heading diff --git a/.gitignore b/.gitignore index df4c801..c3714ee 100644 --- a/.gitignore +++ b/.gitignore @@ -80,6 +80,6 @@ dev/ releasehx-demo/ # Release history working directories -docs/release/drafts/ -docs/release/payloads/ +docs/_releases/drafts/ +docs/_releases/payloads/ docs/agent/*.md diff --git a/Rakefile b/Rakefile index bb0b952..765a1ca 100644 --- a/Rakefile +++ b/Rakefile @@ -278,7 +278,7 @@ namespace :rhx do desc 'Publish release notes as AsciiDoc' task :publish, [:version] do |_t, args| with_rhx(args) do |config_path, config, version| - drafts_dir = config.dig('paths', 'drafts_dir') || 'docs/release/drafts' + drafts_dir = config.dig('paths', 'drafts_dir') || 'docs/_releases/drafts' yaml_file = File.join(drafts_dir, "#{version}.yml") unless File.exist?(yaml_file) @@ -288,7 +288,7 @@ namespace :rhx do end puts "Publishing release notes for version #{version}..." - output_file = "docs/release/#{version}.adoc" + output_file = "docs/_releases/#{version}.adoc" cmd = "bundle exec bin/rhx #{yaml_file} --config #{config_path} --adoc #{output_file}" run_cmd(cmd) puts "✓ Successfully published release notes to #{output_file}" @@ -356,7 +356,7 @@ def generate_release_index require 'fileutils' require 'yaml' - release_dir = 'docs/release' + release_dir = 'docs/_releases' output_file = 'build/docs/_release_index.adoc' # Ensure output directory exists @@ -370,30 +370,28 @@ def generate_release_index return if release_files.empty? - # Build the index content + # Build the index content — all releases included inline, links are anchors content = [] - content << '== Available Releases' - content << '' - content << 'Each release includes detailed notes about new features, improvements, bug fixes, and breaking changes.' + content << '== Release History' content << '' - # List releases + # TOC-style list linking to anchors within this page release_files.each do |file| version = File.basename(file, '.adoc') - # Try to extract date from the file date = extract_release_date(file) || 'TBD' - content << "* link:../release/#{version}[#{version}] - #{date}" + anchor = "release-#{version.gsub('.', '-')}" + content << "* <<#{anchor},#{version}>> — #{date}" end - content << '' - content << '== Latest Release' content << '' - # Include the latest release content - if release_files.any? - latest_file = release_files.first - latest_version = File.basename(latest_file, '.adoc') - content << "include::release/#{latest_version}.adoc[leveloffset=+1]" + # Include all releases inline with anchor IDs + release_files.each do |file| + version = File.basename(file, '.adoc') + anchor = "release-#{version.gsub('.', '-')}" + content << "[[#{anchor}]]" + content << "include::_releases/#{File.basename(file)}[leveloffset=+1]" + content << '' end # Write the file @@ -403,7 +401,10 @@ end def extract_release_date file # Read first 20 lines looking for :page-date: attribute File.foreach(file).first(20).each do |line| - return Regexp.last_match(1).strip if line =~ /:page-date:\s+(.+)$/ + if line =~ /:page-date:\s+(.+)$/ + # Strip time component if present — display date only + return Regexp.last_match(1).strip.split(' ').first + end end nil end diff --git a/docs/_config.yml b/docs/_config.yml index 8cafc92..20f8588 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -31,7 +31,8 @@ exclude: - manpage.adoc - jekyll/ - payloads/ - - release/ + - _releases/drafts + - _releases/payloads - yard/ - release-procedure.adoc diff --git a/docs/release/0.1.2.adoc b/docs/_releases/0.1.2.adoc similarity index 97% rename from docs/release/0.1.2.adoc rename to docs/_releases/0.1.2.adoc index 036c326..1f6db15 100644 --- a/docs/release/0.1.2.adoc +++ b/docs/_releases/0.1.2.adoc @@ -1,8 +1,7 @@ :icons: font :page-title: Release History for 0.1.2 :page-version: 0.1.2 -:page-date: 2026-01-30 -:page-permalink: /docs/releases/0.1.2 +:page-date: 2026-01-30 00:00:00 +0000 = Release History -- 0.1.2 - 2026-01-30 diff --git a/docs/release/0.2.0.adoc b/docs/_releases/0.2.0.adoc similarity index 98% rename from docs/release/0.2.0.adoc rename to docs/_releases/0.2.0.adoc index 5908889..449264c 100644 --- a/docs/release/0.2.0.adoc +++ b/docs/_releases/0.2.0.adoc @@ -1,8 +1,7 @@ :icons: font :page-title: Release History for 0.2.0 :page-version: 0.2.0 -:page-date: 2026-05-27 -:page-permalink: /docs/releases/0.2.0 +:page-date: 2026-05-27 00:00:00 +0000 = Release History -- 0.2.0 - 2026-05-27 diff --git a/docs/release/0.2.1.adoc b/docs/_releases/0.2.1.adoc similarity index 95% rename from docs/release/0.2.1.adoc rename to docs/_releases/0.2.1.adoc index 29d3843..f148d14 100644 --- a/docs/release/0.2.1.adoc +++ b/docs/_releases/0.2.1.adoc @@ -1,8 +1,7 @@ :icons: font :page-title: Release History for 0.2.1 :page-version: 0.2.1 -:page-date: 2026-05-28 -:page-permalink: /docs/releases/0.2.1 +:page-date: 2026-05-28 00:00:00 +0000 = Release History -- 0.2.1 - 2026-05-28 diff --git a/docs/release-procedure.adoc b/docs/release-procedure.adoc index c2579fb..4f9b9bb 100644 --- a/docs/release-procedure.adoc +++ b/docs/release-procedure.adoc @@ -11,7 +11,7 @@ It covers all stages from pre-release checks to post-release verification. - [ ] All changes merged to `release/0.x` branch - [ ] Version numbers updated in README.adoc attributes (`:this_prod_vrsn_major:` through `:next_prod_vrsn_majmin:`) -- [ ] Release notes prepared in `docs/release/0.x.y.adoc` +- [ ] Release notes prepared in `docs/_releases/0.x.y.adoc` - [ ] Clean working tree on `release/0.x` - [ ] RubyGems credentials configured (`~/.gem/credentials`) - [ ] Docker Hub credentials configured (`docker login`) @@ -124,7 +124,7 @@ Confirm Release Notes:: [source,bash] ---- # Verify release notes file exists -ls -lh docs/release/0.x.y.adoc +ls -lh docs/_releases/0.x.y.adoc ---- [[stage-build-artifacts]] From 006fafe36ded221db1560dc3523f9a72d64c8cb9 Mon Sep 17 00:00:00 2001 From: Brian Dominick Date: Fri, 29 May 2026 01:03:25 -0400 Subject: [PATCH 6/6] docs: Presentation adjustments for release history display - Move release histories to one page - Change TOC layout, styles - Adjust date handling --- Rakefile | 22 +++++++++++----------- docs/_config.yml | 1 + docs/_releases/0.1.2.adoc | 2 +- docs/_releases/0.2.0.adoc | 2 +- docs/_releases/0.2.1.adoc | 2 +- docs/jekyll/_sass/custom/custom.scss | 23 +++++++++++++++++++---- 6 files changed, 34 insertions(+), 18 deletions(-) diff --git a/Rakefile b/Rakefile index 765a1ca..523f492 100644 --- a/Rakefile +++ b/Rakefile @@ -354,7 +354,7 @@ end def generate_release_index require 'fileutils' - require 'yaml' + require 'date' release_dir = 'docs/_releases' output_file = 'build/docs/_release_index.adoc' @@ -374,15 +374,20 @@ def generate_release_index content = [] content << '== Release History' content << '' + content << '[cols="~,~"]' + content << '|===' # TOC-style list linking to anchors within this page release_files.each do |file| version = File.basename(file, '.adoc') - date = extract_release_date(file) || 'TBD' + raw_date = extract_release_date(file) + date = raw_date ? Date.parse(raw_date).strftime('%-d %B, %Y') : 'TBD' anchor = "release-#{version.gsub('.', '-')}" - content << "* <<#{anchor},#{version}>> — #{date}" + content << "| <<#{anchor},#{version}>>" + content << "| #{date}" end + content << '|===' content << '' # Include all releases inline with anchor IDs @@ -399,12 +404,7 @@ def generate_release_index end def extract_release_date file - # Read first 20 lines looking for :page-date: attribute - File.foreach(file).first(20).each do |line| - if line =~ /:page-date:\s+(.+)$/ - # Strip time component if present — display date only - return Regexp.last_match(1).strip.split(' ').first - end - end - nil + require 'asciidoctor' + doc = Asciidoctor.load_file file, safe: :safe, parse_header_only: true + doc.attr 'page-date' end diff --git a/docs/_config.yml b/docs/_config.yml index 20f8588..a9bc926 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -1,6 +1,7 @@ title: ReleaseHx Documentation theme: just-the-docs baseurl: / +future: true plugins: - jekyll-asciidoc diff --git a/docs/_releases/0.1.2.adoc b/docs/_releases/0.1.2.adoc index 1f6db15..42b7d3b 100644 --- a/docs/_releases/0.1.2.adoc +++ b/docs/_releases/0.1.2.adoc @@ -1,7 +1,7 @@ :icons: font :page-title: Release History for 0.1.2 :page-version: 0.1.2 -:page-date: 2026-01-30 00:00:00 +0000 +:page-date: 2026-01-30 = Release History -- 0.1.2 - 2026-01-30 diff --git a/docs/_releases/0.2.0.adoc b/docs/_releases/0.2.0.adoc index 449264c..18e8004 100644 --- a/docs/_releases/0.2.0.adoc +++ b/docs/_releases/0.2.0.adoc @@ -1,7 +1,7 @@ :icons: font :page-title: Release History for 0.2.0 :page-version: 0.2.0 -:page-date: 2026-05-27 00:00:00 +0000 +:page-date: 2026-05-27 = Release History -- 0.2.0 - 2026-05-27 diff --git a/docs/_releases/0.2.1.adoc b/docs/_releases/0.2.1.adoc index f148d14..d9050d2 100644 --- a/docs/_releases/0.2.1.adoc +++ b/docs/_releases/0.2.1.adoc @@ -1,7 +1,7 @@ :icons: font :page-title: Release History for 0.2.1 :page-version: 0.2.1 -:page-date: 2026-05-28 00:00:00 +0000 +:page-date: 2026-05-28 = Release History -- 0.2.1 - 2026-05-28 diff --git a/docs/jekyll/_sass/custom/custom.scss b/docs/jekyll/_sass/custom/custom.scss index db0b6fd..2bf3cb1 100644 --- a/docs/jekyll/_sass/custom/custom.scss +++ b/docs/jekyll/_sass/custom/custom.scss @@ -9,15 +9,28 @@ .main-content .dlist dt { font-weight: bold; margin-top: 1em; - text-align: left; /* Fix: Ensure text is flush left */ + text-align: left; + /* Fix: Ensure text is flush left */ } .main-content .dlist dd { - margin-left: 2em; /* Indent the description */ + margin-left: 2em; + /* Indent the description */ margin-top: 0.5em; padding-bottom: 0.5em; } +.table-wrapper { + width: min-content; + overflow-x: auto; +} + +table { + width: auto; + min-width: auto; + text-wrap-mode: nowrap; +} + td { vertical-align: top; } @@ -28,7 +41,9 @@ h2 { font-size: 1.35rem !important; } -h3, h4, h5 { +h3, +h4, +h5 { font-weight: bold; } @@ -49,7 +64,7 @@ h5 { } .highlight { - + .cl { color: #6367A9; }