[CHANGE] Content-ful URLs

[Rob Beezer]

Suppose you author a URL, "with content", such as (without the extra spaces)

< url href="https://example.com" > Click Here! < /url>

Now you have done your readers of print and braille a disservice, as the actual
URL is hidden and there is nothing to click on.

We have a @visual attribute, which lets you provide a visual version of the
URL, perhaps a bit less messy, such as simply "example.com" here. We've been
putting these into footnotes, which some objected to, and no one defended. No
more, the footnotes are gone.

However, if you elect the print version of a PDF, you will see the value of
@visual trailing, inside parentheses. And as before, the pre-processor is
making a default-ish version of @visual if you do not provide one. You can
override this behavior with @visual="".

* No need to change your source, this is just a change to output.

* Not implemnted yet for braille.

* Documentation is lagging.

* Page-fitters will want to get things organized before upgrading.

Rob

[Rob Beezer]

On 8/6/25 15:45, 'Rob Beezer' via PreTeXt announcements wrote:
> *  Documentation is lagging.
Not anymore! Now the documentation is up-to-date, thanks to Mitch K.

https://github.com/PreTeXtBook/pretext/pull/2644

Section 4.31: URLs and External References
https://pretextbook.org/doc/guide/html/topic-url.html#topic-url

Rob