Skip to content

Commit 7f9102e

Browse files
committed
Replace manpage build with multi-language mdbook docs in CI
- Remove manpage generation step and man2html dependency - Add mdbook theme patching for language selector and utility links - Repack tldr zip with pages/ prefix (uudoc expects this structure) - Build translated docs via build-docs-l10n.sh for 18 languages - Collect translated docs to /coreutils/docs-{lang}/
1 parent 6e9e149 commit 7f9102e

1 file changed

Lines changed: 20 additions & 13 deletions

File tree

.github/workflows/website.yml

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ jobs:
4848

4949
- name: Install system deps
5050
run: |
51-
sudo apt install libacl1-dev libselinux1-dev libsystemd-dev man2html
51+
sudo apt install libacl1-dev libselinux1-dev libsystemd-dev
5252
5353
- name: Install necessary tools (mdbook and mdbook-toc)
5454
uses: taiki-e/install-action@v2
@@ -66,19 +66,30 @@ jobs:
6666
done
6767
cp -r coreutils-l10n/src/uucore/* coreutils/src/uucore/ 2>/dev/null || true
6868
69+
- name: Patch mdbook theme with language selector
70+
run: |
71+
uutils.github.io/scripts/patch-mdbook-theme.sh coreutils/docs
72+
6973
- name: Build Coreutils Docs
7074
run: |
7175
cd coreutils
72-
curl -sfL https://github.com/tldr-pages/tldr/releases/download/v2.3/tldr-pages.zip -o docs/tldr.zip || true
76+
# Download and repack tldr zip: uudoc expects pages/common/ prefix
77+
curl -sfL https://github.com/tldr-pages/tldr/releases/download/v2.3/tldr-pages.zip -o /tmp/tldr-raw.zip || true
78+
if [ -f /tmp/tldr-raw.zip ]; then
79+
mkdir -p /tmp/tldr-repack/pages
80+
cd /tmp/tldr-repack && unzip -o /tmp/tldr-raw.zip -d pages/ > /dev/null
81+
zip -r "$OLDPWD/docs/tldr.zip" pages/ > /dev/null
82+
cd "$OLDPWD"
83+
fi
7384
cargo run --bin uudoc --all-features
7485
cd docs
7586
# Remove deprecated 'multilingual' field unsupported by newer mdbook
7687
sed -i '/^multilingual/d' book.toml
7788
mdbook build
7889
79-
- name: Build Coreutils Manpages (all languages)
90+
- name: Build Coreutils Docs (translations)
8091
run: |
81-
uutils.github.io/scripts/build-all-manpages.sh coreutils manpages-html uutils.github.io/templates
92+
uutils.github.io/scripts/build-docs-l10n.sh coreutils
8293
8394
- name: Build Findutils Docs
8495
run: |
@@ -98,15 +109,11 @@ jobs:
98109
cp -r uutils.github.io/public public
99110
cp -r coreutils/docs/book public/coreutils/docs
100111
cp -r findutils/docs/book public/findutils/docs
101-
# Copy English manpages to /coreutils/manpages/
102-
mkdir -p public/coreutils/manpages
103-
cp -r manpages-html/en/* public/coreutils/manpages/
104-
# Copy translated manpages to /coreutils/manpages-{lang}/
105-
for lang_dir in manpages-html/*/; do
106-
lang=$(basename "$lang_dir")
107-
[ "$lang" = "en" ] && continue
108-
mkdir -p "public/coreutils/manpages-${lang}"
109-
cp -r "${lang_dir}"* "public/coreutils/manpages-${lang}/"
112+
# Copy translated docs to /coreutils/docs-{lang}/
113+
for lang_dir in coreutils/docs/book-*/; do
114+
[ -d "$lang_dir" ] || continue
115+
lang=$(basename "$lang_dir" | sed 's/^book-//')
116+
cp -r "$lang_dir" "public/coreutils/docs-${lang}"
110117
done
111118
112119
- name: Upload artifact for checking the output

0 commit comments

Comments
 (0)