| Age | Commit message (Collapse) | Author |
|---|
|
**🌼 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.
|
|
|
|
The aria-label help user with screen reader to discern and navigate
the anchor.
Ref: https://dequeuniversity.com/rules/axe/4.11/link-name
|
|
|
|
Using separate file allow tracking and modifying the style as needed.
|
|
Instead of showing multiple paragraphs of license text, display it with
single line.
While at it, embed the SPDX license directly instead of using REUSE.toml.
|
|
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.
|
|
|
|
|
|
[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".
|
|
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".
While at it, export the DocAttrStylesheet.
|
|
The "generator" value will changes on each releases, so better to disable
it to minimize noise during release commit.
|
|
[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.
|
|
Changes,
* Link the Includes feature to the official documentation
* Update Unsupported Markup related to Includes
* Update list of TODO related to Includes
* Move CHANGELOG to Development section
|
|
|
|
Example of block code with include directive,
----
...
include::file[]
...
----
|
|
|
|
The nolint tag is to ignore being linted by golangci-lint.
Since we are not using golangci-lint anymore, we can remove it.
|
|
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.
|
|
Some of attribute may depends on property of the Document.
|
|
Every time we execute "make test-parser", the generated HTML files will
changes the "Last updated xxx" (where xxx is the time its executed).
This changes prevent this unnecessary diff in the future.
|
|
Use the title names from the latest AsciiDoc Language Documentation.
|
|
The generated HTML now contains the default stylesheet.
The stylesheet is copied from HTML file generated by Asciidoctor v2.0.23.
|
|
|
|
|
|
[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".
|
|
|
|
The fieldalignment and shadow is linter from golang.org/x/tools.
This linters actually have an API that can be combined into a program,
which provided by package "pakakeh.go/lib/goanalysis".
|
|
|
|
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.
|
|
|
|
=== 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.
|
|
|
|
Using 8080 is too common and has cause conflict with some service on my
development laptop.
|
|
This is to make it easy to see how it parsed and how it written to HTML,
make the code more searchable.
While at it, add test for block image.
|
|
|
|
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.
|
|
|
|
=== 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.
|
|
|
|
This is the second we remove golangci-lint.
Previously, we replace it with revive, now we replace it with go internal
tools "go vet".
The problem is the same, golangci-lint does not works when compiled or
using gotip.
Also, on VM with 8GB memory, it will crash due to OOM.
|
|
The WriteByte is the method in that conform [io.ByteWriter].
|
|
Each lines to be parsed has been trimmed on the first load, so
there is no need to do it again, on some cases.
|
|
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/
|
|
Using struct limit the value to only string, while some attributes
can be an integer value, for example "leveloffset".
|
|
The idea is to provide consistent naming for metadata and attribute.
The AsciiDoctor documentation mostly name them as document attribute.
|
|
Using ".reuse/dep5" has been deprecated since REUSE v3.2.
While at it, add missing license to file "const.go".
|
|
This is to make the struct is clear that it represent the document
attribute.
|
|
The elKindSection0 is the Document Title, the line that start
with "= ".
|
|
|
