Skip to content

Comments

Docs: asterisk does not always mean italics#3349

Merged
snowman2 merged 1 commit intorasterio:mainfrom
adamjstewart:docs/asterisk
May 20, 2025
Merged

Docs: asterisk does not always mean italics#3349
snowman2 merged 1 commit intorasterio:mainfrom
adamjstewart:docs/asterisk

Conversation

@adamjstewart
Copy link
Contributor

@adamjstewart adamjstewart commented May 20, 2025

When Sphinx sees an asterisk, it assumes you want italics. However, asterisks also appear in code or as math. We need to either convert these to formal code/math or escape the asterisk to prevent the following warnings in RtD CI:

/home/docs/checkouts/readthedocs.org/user_builds/rasterio/checkouts/3340/docs/api/rasterio.rio.bounds.rst:4: WARNING: Inline emphasis start-string without end-string. [docutils]
/home/docs/checkouts/readthedocs.org/user_builds/rasterio/checkouts/3340/docs/api/rasterio.rio.calc.rst:19: WARNING: Inline emphasis start-string without end-string. [docutils]

Before

Screenshot 2025-05-20 at 11 55 12 AM Screenshot 2025-05-20 at 11 56 08 AM

After

Screenshot 2025-05-20 at 11 55 21 AM Screenshot 2025-05-20 at 11 56 13 AM

@snowman2
Copy link
Member

Thanks @adamjstewart 👍

@snowman2 snowman2 merged commit cd4e86f into rasterio:main May 20, 2025
7 of 22 checks passed
@adamjstewart adamjstewart deleted the docs/asterisk branch May 20, 2025 12:08
@snowman2 snowman2 added this to the 1.4.4 milestone Nov 6, 2025
@snowman2 snowman2 added the backport-1.4 To be backported to maint-1.4 label Nov 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-1.4 To be backported to maint-1.4 documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants