Closed abelsromero closed 3 years ago
My goals with this PR are avoid confusion:
The only time the % width is allows is when converting to HTML and the image is an SVG with opts=inline. (And even that is discouraged).
When converting to PDF using Asciidoctor PDF, the pdfwidth attribute is always preferred.
The true purpose of the width attribute is to provide the intrinsic width of the image as a hint.
I think the docs should simply say "the purpose of the width attribute is to define or override the image's intrinsic width". A % value should not be used here.
As mentioned in https://github.com/asciidoctor/asciidoctor.org/issues/866.
This PR attempts to reduce ambiguity in the image sizing summaries.