You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Listing blocks currently can be either wrapped or non-wrapped, non-wrapped doesn't always work (especially not in PDFs), and wrapped makes the code/listing not very readable resp. can lead to confusion, hence the idea to have a nicer/clearer way to wrap lines. Asciidoc was able to do it, AFAICJ asciidoctor can't do it, and that's what I'd like to have.
To give an example, I'd have something like:
----
## the required sizing depends on the current and constantly growing size of each software repository.
----
which would be rendered as follows:
(it would be even cooler if the wrapped lines could be right aligned, it would make it even clearer that they're only the continuation of the first line, but indentation and arrow at the end of the first line would already be good enough)
The text was updated successfully, but these errors were encountered:
ericzolf
changed the title
I meant code in my documentation, more correctly "listing blocks". They currently can be either wrapped or non-wrapped, non-wrapped doesn't always work (especially not in PDFs), and wraped makes the code/listing not very readable resp. can lead to confusion, hence the idea to have a nicer/clearer way to wrap lines. Asciidoc was able to do it, AFAICJ asciidoctor can't do it, and that's what I'd like to have.
[ENH] long listing block lines to be wrapped in a more readable way
Nov 7, 2020
mojavelinux
changed the title
[ENH] long listing block lines to be wrapped in a more readable way
Add option to wrap lines in verbatim blocks using a wrap indicator and hanging indent
Nov 7, 2020
One way to indicate wrapping is by enabling line numbers. If I use the following source:
:source-highlighter: rouge
[%linenums,text]
----
## the required sizing depends on the current and constantly growing size of each software repository.
----
Then it will appear as follows:
The line number serves as another sort of wrap indicator.
I'll follow-up later with ideas for how you could add a wrap indicator using an extended converter.
Listing blocks currently can be either wrapped or non-wrapped, non-wrapped doesn't always work (especially not in PDFs), and wrapped makes the code/listing not very readable resp. can lead to confusion, hence the idea to have a nicer/clearer way to wrap lines. Asciidoc was able to do it, AFAICJ asciidoctor can't do it, and that's what I'd like to have.
To give an example, I'd have something like:
which would be rendered as follows:
(it would be even cooler if the wrapped lines could be right aligned, it would make it even clearer that they're only the continuation of the first line, but indentation and arrow at the end of the first line would already be good enough)
Originally posted by @ericzolf in asciidoctor/asciidoctor#3820 (comment)
The text was updated successfully, but these errors were encountered: