Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Auto-recognized syntax in asciidoc without "manual" formatting no longer gets any formatting in the output #315

Open
3 tasks
florent-leborgne opened this issue Jan 22, 2025 · 1 comment
Labels
question Further information is requested

Comments

@florent-leborgne
Copy link

florent-leborgne commented Jan 22, 2025

Describe the bug

That's maybe a quite rare thing that we have and I'm not sure we really need it on the new system, but still raising it for awareness:

In asciidoc, some specific syntax without any "source formatting" still gets some formatting applied in the output. This is currently lost in the new system.

See how it displays in the output:

Image

Here we can notice that the 3rd column gets some "input" type of formatting applied. When looking at the sources, there is no specific formatting calling for it.

Image

Expected behavior

Not sure what we'd want to expect from this. The + in asciidoc is that it's able to recognize some specific things like file paths, turn plain URLs into actual links, etc., but on the other hand with the new system the output strictly follows the formatting as it is in the sources, which is actually logical as well.

Steps to reproduce

No response

Tooling

  • docs-builder
  • migration tooling
  • I'm not sure
@bmorelli25 bmorelli25 added question Further information is requested and removed bug labels Jan 23, 2025
@bmorelli25
Copy link
Member

Thanks for opening this. Changing to question so we can surface it to other folks.

My opinion is to not support this functionality in V3. I can't figure out exactly why this is happening in the asciidoc build. I want to try to avoid magic like this in V3 so that the syntax always reflects the output.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

2 participants