multiline warnings containing links are difficult to click due to resizing

[braingram]

The active resizing to allow for easier reading of asdf file contents limits interaction with links in warning block text.

sphinx-asdf/sphinx_asdf/static/custom.css

Line 7 in da575fb

div.admonition:active {

Perhaps a hover would allow for both uses but would require testing.

[WilliamJamieson]

First, hover seems incompatible with how the directive generates the page. This necessitated the click to increase size fix. I also find hover changes to not work well on mobile devices.

I believe this issue is rooted in your comment here: asdf-format/asdf#1337 (comment). First note that sphinx structures things so that admonition is the parent of directives like warning and note, see https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives for details. This means that click to resize for warning directives can be overridden by specifically changing the settings for warning.

Indeed, this is exactly how note is not resized, see:

sphinx-asdf/sphinx_asdf/static/custom.css

Lines 11 to 13 in da575fb

	div.note:active {
	width: 100%
	}

this can simply be extended to include warning.

As for the reason why it has to affect all admonition is because when you look at the directives that sphinx uses to write the parts of ASDF files, it does them in pure admonition directives. So I had to modify the CSS for that directly in order to make it work.

[WilliamJamieson]

Note these changes were first developed as part of asdf-format/asdf#1142

[braingram]

After looking at this a bit more my vote is for removal of custom.css unless there are other uses aside from the resizing.

The resizing also interferes with selecting content within blocks. As one example, for the external_array.asdf file here:
https://asdf.readthedocs.io/en/latest/asdf/features.html#array-references
selecting /asdf at the end of the following line is impossible:

asdf_library: !core/software-1.0.0 {author: The ASDF Developers, homepage: 'http://github.com/asdf-format/asdf',

Removing custom.css allows for normal use of the scroll bars in the blocks.

The resizing also does not consistently work on mobile and touches sometimes result in scrolling and other times result in resizing that resets the scrolling.

[WilliamJamieson]

Then remove it.