JuliaDocs/Documenter.jl

feature request: support `compat` with more subtle callout format

Open

#2,315 opened on 2023年10月30日

GitHub で見る
 (1 comment) (0 reactions) (0 assignees)Julia (910 stars) (513 forks)batch import
Format: HTMLType: Enhancementhelp wanted

説明

When adding !!! compat "Julia 1.6" blocks, these render quite boldly in the docs, while it seems like they could be a more subtle callout in some variation of light gray, smaller, and/or italics: image

Compare to say sphinx, where it is rendered with a more subtle italics: image http://docs.libuv.org/en/v1.x/misc.html

Refs: https://github.com/JuliaLang/julia/pull/46717/files

コントリビューターガイド

技術スタック
css
領域
documentationdesign
Issue 種別
feature
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
under 1 hour
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
fresh
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Basic CSSFamiliarity with Documenter.jl's HTML output
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
85
調査方針
Investigate the Documenter.jl source code for the CSS styles that render compatibility callouts (e.g., styles for `.admonition.compat` or similar classes). The issue references a PR in JuliaLang/julia#46717, which may provide context. The goal is to make the callout more subtle—likely by adding a new CSS class or modifying existing styles to use lighter colors, smaller font, or italics. Look at the theme files in `src/` or `assets/` for styling definitions.
feature request: support `compat` with more subtle callout format · JuliaDocs/Documenter.jl#2315 | Good First Issue