From 4956de038af8b52db6d03f0b6f5b77e6b7cfa721 Mon Sep 17 00:00:00 2001 From: Shulhan Date: Mon, 9 Feb 2026 13:00:04 +0700 Subject: Release asciidoctor-go v0.7.3 (2026-02-09) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **🌼 all: add aria-label to the anchor when sectanchor enabled** The aria-label help user with screen reader to discern and navigate the anchor. For more information see https://dequeuniversity.com/rules/axe/4.11/link-name . **🌼 all: update default CSS to asciidoctor v2.0.26** The default CSS now split into separate file to simplify tracking and modifying the style as needed. --- CHANGELOG | 637 -------------------------------------------------- CHANGELOG.adoc | 662 +++++++++++++++++++++++++++++++++++++++++++++++++++- _doc/CHANGELOG.adoc | 2 +- asciidoctor.go | 10 +- 4 files changed, 666 insertions(+), 645 deletions(-) delete mode 100644 CHANGELOG mode change 120000 => 100644 CHANGELOG.adoc diff --git a/CHANGELOG b/CHANGELOG deleted file mode 100644 index ff2f812..0000000 --- a/CHANGELOG +++ /dev/null @@ -1,637 +0,0 @@ -// SPDX-FileCopyrightText: 2021 M. Shulhan -// SPDX-License-Identifier: GPL-3.0-or-later -= Changelog for asciidoctor-go -Shulhan -:toc: -:sectlinks: - -[#v0_7_2] -== asciidoctor-go v0.7.2 (2025-12-27) - -This release update the README so the _doc directory can be served under -https://kilabit.info/project/asciidoctor-go . - -The go.mod is updated to use minimum Go 1.24.0 and all dependencies has been -updated to latest release. - - -[#v0_7_1] -== asciidoctor-go v0.7.1 (2025-04-18) - -[BUG FIX] **Fix the logic when applying default embedded CSS.** - -By default, the document contains ":stylesheet:" attribute, which -means using the default embedded CSS. -To disable it, unset the attribute using ":stylesheet!:". -To overwrite it, set the attribute to path of CSS file -":stylesheet: my.css". - -[ENHANCEMENT] Export the constant for document attribute "stylesheet". - - -[#v0_7_0] -== asciidoctor-go v0.7.0 (2025-04-18) - -[NEW FEATURE] **Support include directive inside block code**. - -Example of block code with include directive, - -.... ----- -... -include::file[] -... ----- -.... - -[NEW FEATURE] **Support document attribute "docdir"** - -The "docdir" attribute contains the full path of the directory that -contains the source document. -By default it is set to the directory where the Document resided. - -[NEW FEATURE] **Add default HTML stylesheet.** - -The generated HTML now contains the default stylesheet. -The stylesheet is copied from HTML file generated by Asciidoctor v2.0.23. - - -[#v0_6_2] -== asciidoctor-go v0.6.2 (2025-02-01) - -[BUG FIX] **Fix section detected as paragraph after list and comment.** + -Previously, given the following markup, ----- -* Sub list -+ -Sub list content. - -//}}} -//{{{ -== Sub 2 -//}} ----- -The section "Sub 2" will be parsed as paragraph instead of new section. - -[CHORE] -In the linter, we replace the fieldalignment and shadow using our internal -gocheck command. -This linters actually have an API that can be combined into a program, -which provided by package "pakakeh.go/lib/goanalysis". - - -[#v0_6_1] -== asciidoctor-go v0.6.1 (2024-12-08) - -[#v0_6_1__bug_fixes] -=== Bug fixes - -all: fix error log when failed to open included file:: -+ -The log use the wrong variable when printing path for failed include -file. - -all: fix reading include file when parent path is absolute:: -+ -Previously, if the parent document is opened using absolute path and -it contains include directive, the included file will fail to read -because the parent path is joined with current working directory. - - -[#v0_6_0] -== asciidoctor-go v0.6.0 (2024-09-07) - -[#v0_6_0__breaking_changes] -=== Breaking changes - -all: rename struct "AttributeEntry" to "DocumentAttribute":: -+ -This is to make the struct is clear that it represent the document -attribute. - -all: rename struct "AttributeEntry" to "DocumentAttribute":: -+ -This is to make the struct is clear that it represent the document -attribute. - -all: refactoring DocumentAttribute into struct:: -+ -Using struct limit the value to only string, while some attributes -can be an integer value, for example "leveloffset". - -[#v0_6_0__new_features] -=== New features - -all: support document attribute "leveloffset":: -+ --- -The ":leveloffset:" on document attribute allow increment -or decrement the heading level on included files. - -Reference: https://docs.asciidoctor.org/asciidoc/latest/directives/include-with-leveloffset/ --- - -[#v0_6_0__enhancements] -=== Enhancements - -all: use strict document header format:: -+ --- -Previously, an empty line before Document Title cause the parser -stop parsing the document header, now an empty lines are skipped. -Also document attribute can be place anywhere, either before or -after title, and in between attributes; now it can be only placed -after revision or author or title. --- - -all: remove unnecessary TrimRight:: -+ -Each lines to be parsed has been trimmed on the first load, so -there is no need to do it again, on some cases. - - -[#v0_5_2] -== asciidoctor-go v0.5.2 (2023-04-04) - -This release only contains chores. - -all: replace module "share" with "pakakeh.go":: -+ --- -The "share" module has been moved to new repository with new name at -"https://sr.ht/~shulhan/pakakeh.go". -For more information see the change logs at "pakakeh.go" module. --- - -all: comply with linter recommendations:: -+ -Most of the code changes related to refactoring if-else witch switch -statement. - -all: replace if-else bytes.Equals with static string case comparisons:: -+ -Using string instead of [bytes.Equal] give code much more readable. - - -[#v0_5_1] -== asciidoctor-go v0.5.1 (2023-12-14) - -[#v0_5_1__bug_fixes] -=== Bug fixes - -all: fix custom IDs on first section always got replaced:: -+ --- -Any custom ID on the first section always replaced with the subsection -because, first, when detecting preamble we did not check for line with -kind ID "[[...]]" an short ID "[#...]". -Second, when parsing preamble we did not stop when we found line kind -ID and short ID. - -This preamble thing is kind of annoying. -We need to revisit again how to detect preamble, maybe not calling -separate block parser, but making it linear as the default first child of -parent element. --- - -[#v0_5_1__chores] -=== Chores - -all: replace "lib/parser" with "strings/parser":: -+ -The lib/parser has been deprecated in share module. - -all: remove dependency to "git.sr.ht/~shulhan/pakakeh.go/lib/debug":: - -all: replace linter golangci-lint with revive and shadow:: -+ --- -The golangci-lint does not output any results anymore -Either we are getting good at writing Go or the linter itself is become -less good. -We also have seen that the latest golangci-lint is failed to build -with Go tip, a simple "make" on the golangci-lint never success in my -experiences. - -This changes fix all the output reported by the revive and shadow. --- - - -[#v0_5_0] -== asciidoctor-go v0.5.0 (2023-06-04) - -[#v0_5_0__new_features] -=== New features - -all: add support for unordered list with '-':: -+ --- -The unordered list item with hyphen ('-') cause too much confusion and -inconsistency, nevertheless most of still use it. - -Case one, given the following markup, - ----- -- Item 1 -+ -"A line -of quote" --- Author ----- - -Is the "Author" the sub item in list or we are parsing author of quote -paragraph? - -Case two, the writer want to write em dash (`—` in HTML Unicode) but -somehow the editor wrap it and start in new line. - -As a reminder, the official documentation only recommend using hyphen for -simple list item [1]. - -[1] https://docs.asciidoctor.org/asciidoc/latest/lists/unordered/#basic-unordered-list --- - -[#v0_5_0__bug_fixes] -=== Bug fixes - -all: fix rendering blockquote without attribution:: -+ --- -Previously, in the htmlWriteBlockQuoteEnd, if attribution is set -we add HTML tag
and close it later after we add citation. - -The issue is we did not check if attribution is true again when we -add closing tag for div, which make the div above of blockquote get -closed. --- - -all: handle custom marker in between unordered list:: -+ --- -Given the following markup, - ----- -[square] -* item 1 -[circle] -** item 2 ----- - -The list on item 2 now start with `
`. --- - - -[#v0_4_1] -== asciidoctor-go v0.4.1 (2023-03-03) - -[#v0_4_1__bug_fixes] -=== Bug fixes - -all: fix empty line printed on ToHTMLBody or ToHTMLEmbedded:: -+ --- -Given the following adoc, - ----- -= T ----- - -If we call ToHTMLBody, the output is - ----- -(empty line here) -