Skip to content

feat(html5s): implement converter focusing on html correct semantics#331

Open
nlopes wants to merge 3 commits intomainfrom
nlopes-add-support-for-html5-semantics
Open

feat(html5s): implement converter focusing on html correct semantics#331
nlopes wants to merge 3 commits intomainfrom
nlopes-add-support-for-html5-semantics

Conversation

@nlopes
Copy link
Owner

@nlopes nlopes commented Feb 8, 2026

asciidoctor has a community provided converter that focuses on correct semantics, accessibility and compatibility with common typographic CSS styles.

Closes #329.

@nlopes nlopes self-assigned this Feb 8, 2026
@nlopes nlopes added the enhancement New feature or request label Feb 8, 2026
@nlopes
Copy link
Owner Author

nlopes commented Feb 8, 2026

@dflock would love if you could give this a run - leave any issues you encounter in the issue already open (not here!)

`asciidoctor` has a [community provided
converter](https://github.com/jirutka/asciidoctor-html5s) that focuses on correct
semantics, accessibility and compatibility with common typographic CSS styles.

Closes #329.
@nlopes nlopes force-pushed the nlopes-add-support-for-html5-semantics branch from 01884bf to 07f30e5 Compare February 8, 2026 15:55
@dflock
Copy link

dflock commented Feb 8, 2026

Wow, that was quick! Having a look now...

@nlopes
Copy link
Owner Author

nlopes commented Feb 8, 2026

Wow, that was quick! Having a look now...

In all fairness, I used Claude Code to get a lot of this done. Fixtures, docs, approach validation, capturing the structure used by asciidoctor-html5s etc. I did check all the code for what is worth but didn't test comprehensively.

If you have open source complex adoc files I can test with, would love if you could refer me to them 🙏

@dflock
Copy link

dflock commented Feb 8, 2026

My personal website uses adoc and is the source files are available here: https://github.com/dflock/duncanlock.net/tree/master/content/ - there are about 170 adoc files, of various levels of complexity. This is the largest folder:

https://github.com/dflock/duncanlock.net/tree/master/content/posts/tech

The published website is here - currently published using asciidoctor & pelican: https://duncanlock.net/

I've been using this post as a torture test - it's got a bit of everything, including tables and a torture test for definition lists, with lots of things nested inside dt's: https://github.com/dflock/duncanlock.net/blob/master/content/posts/tech/a-marvellous-incomplete-compendium-of-reddit-automatons-bots.adoc

nlopes and others added 2 commits February 8, 2026 18:44
Adds proper semantic tag selection (section/figure/div), metadata
propagation (id, roles, classes), semantic attribution, description
list rendering, stem block math markup, and task-list checkbox support.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add support for html5s backend

2 participants