From e64308bb0b7938233191ec95f4502b957b45e654 Mon Sep 17 00:00:00 2001 From: Sylvestre Ledru Date: Sat, 4 Apr 2026 23:16:11 +0200 Subject: [PATCH] Strip legacy FA4 class from uudoc-generated platform icons mdbook 0.5's built-in Font Awesome parser sees the legacy `fa` class that uudoc emits and defaults to type=regular, failing to find linux/windows/apple (which live under `brands`) and spamming hundreds of WARN lines per build. Drop the `fa ` prefix between uudoc and mdbook build for both English and translated docs. --- .github/workflows/website.yml | 4 ++++ scripts/build-docs-l10n.sh | 3 +++ 2 files changed, 7 insertions(+) diff --git a/.github/workflows/website.yml b/.github/workflows/website.yml index 41eb348e4..fefc951d6 100644 --- a/.github/workflows/website.yml +++ b/.github/workflows/website.yml @@ -101,6 +101,10 @@ jobs: cd docs # Remove deprecated 'multilingual' field unsupported by newer mdbook sed -i '/^multilingual/d' book.toml + # Strip the legacy FA4 `fa` class from uudoc-generated platform icons + # so mdbook 0.5's Font Awesome parser picks up the `fa-brands` family + # instead of defaulting to `regular` and warning about linux/windows/apple. + find src/utils -name '*.md' -exec sed -i 's|class="fa fa-brands |class="fa-brands |g' {} + mdbook build - name: Build Coreutils Docs (translations) diff --git a/scripts/build-docs-l10n.sh b/scripts/build-docs-l10n.sh index ea47afec2..5d72379fa 100755 --- a/scripts/build-docs-l10n.sh +++ b/scripts/build-docs-l10n.sh @@ -240,6 +240,9 @@ for lang in "${!LANG_MAP[@]}"; do # Build mdbook to a language-specific output directory sed -i '/^multilingual/d' docs/book.toml + # Strip legacy FA4 `fa` class so mdbook 0.5's Font Awesome parser picks up + # the `fa-brands` family for linux/windows/apple icons (avoids WARN spam). + find docs/src/utils -name '*.md' -exec sed -i 's|class="fa fa-brands |class="fa-brands |g' {} + (cd docs && mdbook build -d "book-${lang}") # Restore en-US.ftl files for next iteration