swiftlang / swift-docc-render

Web renderer for Swift-DocC documentation.
Apache License 2.0
315 stars 53 forks source link

No way to control fading of icons #902

Open gwynne opened 1 month ago

gwynne commented 1 month ago

Feature Name

Icon opacity control

Description

Since commit 601956951e6a1f5717f809325acd509ff672e3a7, icons in page headers are faded to 15% opacity. There is no way (that I can find) to control this opacity setting, through theme settings or otherwise.

Motivation

Custom icons (via the theme.icons.<icon> settings in theme-settings.json) may not be visible or otherwise not display as intended at 15% opacity.

Importance

The rest of a page header is fairly customizable via colors (such as with use of CSS gradients) and with metadata attributes such as @TitleHeading. Image opacity is often a major visual design factor.

Alternatives Considered

I couldn't find any alternatives, short of post-processing the generated DocC archive's CSS files (obviously less than ideal).