Skip to content

fix: support asciidoctor page headings#1005

Draft
imfing wants to merge 2 commits into
mainfrom
fix/asciidoctor-support
Draft

fix: support asciidoctor page headings#1005
imfing wants to merge 2 commits into
mainfrom
fix/asciidoctor-support

Conversation

@imfing

@imfing imfing commented Jun 11, 2026

Copy link
Copy Markdown
Owner

Summary

Fixes #547.

Note: AsciiDoc support is experimental and is not considered stable.

  • add a shared heading helper that falls back to rendered HTML headings when Hugo does not expose .Fragments
  • use the helper for right TOC, sidebar TOC, and FlexSearch search fragments
  • document the required asciidoctor executable and Hugo security.exec.allow setup
  • add a regression test covering .adoc rendering, TOC links, and search-data fragments

Verification

  • hugo --config=hugo.yaml,../dev.toml --themesDir=../.. --source=docs --logLevel warn
  • npm run build
  • npx playwright test tests/asciidoc.spec.ts
  • git diff --check

@imfing imfing temporarily deployed to accessibility June 11, 2026 11:08 — with GitHub Actions Inactive
@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for hugo-hextra ready!

Name Link
🔨 Latest commit 7169ec7
🔍 Latest deploy log https://app.netlify.com/projects/hugo-hextra/deploys/6a2a96d8f7d8fe0008017e06
😎 Deploy Preview https://deploy-preview-1005--hugo-hextra.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for hugo-hextra ready!

Name Link
🔨 Latest commit 6a82ec2
🔍 Latest deploy log https://app.netlify.com/projects/hugo-hextra/deploys/6a2a9710a032c00008891fc3
😎 Deploy Preview https://deploy-preview-1005--hugo-hextra.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

asciidoctor not working

1 participant