Native Go parser for asciidoc markup. http://git.kilabit.info/asciidoctor-go/atom?h=main 2026-02-09T06:00:04Z 2026-02-09T06:00:04Z Shulhan ms@kilabit.info 2026-02-09T06:00:04Z urn:sha1:4956de038af8b52db6d03f0b6f5b77e6b7cfa721 **🌼 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. 2025-12-27T06:22:56Z Shulhan ms@kilabit.info 2025-12-27T06:22:56Z urn:sha1:050ae5215ba426a1f2a13dcc5555f9d1b21d9d56 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. 2025-04-18T12:41:38Z Shulhan ms@kilabit.info 2025-04-18T12:41:38Z urn:sha1:dd30c720046cc9d131dc638a56a45c12f9051806 [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". 2025-04-18T09:29:09Z Shulhan ms@kilabit.info 2025-04-18T09:28:15Z urn:sha1:a6d11741c4c050cb0cec96f588baff6366da30d2 [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. 2025-02-01T02:06:35Z Shulhan ms@kilabit.info 2025-02-01T01:55:54Z urn:sha1:3597269b177017c3d35896d9ff12f15af616a72c [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". 2024-12-08T14:06:49Z Shulhan ms@kilabit.info 2024-12-08T14:03:01Z urn:sha1:d4b59bd3cefeb40c5c59f5bf79d10d48e725b0f3 === 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. 2024-09-07T09:47:04Z Shulhan ms@kilabit.info 2024-09-07T09:47:04Z urn:sha1:d7214a14e994bea65eab6620689708484b9c45e7 === 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". === 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/ === 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. 2024-04-04T14:45:27Z Shulhan ms@kilabit.info 2024-04-04T14:45:27Z urn:sha1:9a2bcad4d62c7fd93a3411e0a60cfa07c2b04051 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. 2024-03-05T11:00:34Z Shulhan ms@kilabit.info 2024-03-05T10:00:19Z urn:sha1:346500242a3541bf9f7d8ce008dcf2ef6950e9a0 2023-12-14T08:40:52Z Shulhan ms@kilabit.info 2023-12-14T08:40:52Z urn:sha1:bc54ecb3e21852f2120548e48603ac9212ecfda3 === 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. === Chores * all: replace "lib/parser" with "strings/parser" The lib/parser has been deprecated in share module. * all: remove dependency to "github.com/shuLhan/share/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.