Skip to content

Commit 00385e3

Browse files
committed
Sync src/ with date in PO file when publishing
Before, we always used the latest English source files when publishing. This means that translations become outdated as soon as anything is changed in the source. This PR changes will instead freeze translations in place: they will keep using the same English source files until a new POT file is merged into the translation. We do this by relying on the POT-Creation-Date field in the PO files. We still update all the files around the Markdown files: this allows us to fix things in the theme, for example. Part of google/mdbook-i18n-helpers#16. The logic here should eventually be moved to somewhere in mdbook-i18n-helpers, most likely to the renderer that @sakex is building in google/mdbook-i18n-helpers#84.
1 parent a9183eb commit 00385e3

File tree

1 file changed

+30
-22
lines changed

1 file changed

+30
-22
lines changed

.github/workflows/publish.yml

Lines changed: 30 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
name: Publish
22

33
on:
4-
push:
5-
branches:
6-
- main
7-
workflow_dispatch:
4+
pull_request:
5+
# push:
6+
# branches:
7+
# - main
8+
# workflow_dispatch:
89

9-
permissions:
10-
contents: read
11-
pages: write
12-
id-token: write
10+
#permissions:
11+
# contents: read
12+
# pages: write
13+
# id-token: write
1314

1415
# Allow one concurrent deployment
1516
concurrency:
@@ -23,9 +24,9 @@ env:
2324

2425
jobs:
2526
publish:
26-
environment:
27-
name: github-pages
28-
url: ${{ steps.deployment.outputs.page_url }}
27+
# environment:
28+
# name: github-pages
29+
# url: ${{ steps.deployment.outputs.page_url }}
2930
runs-on: ubuntu-latest
3031
steps:
3132
- name: Checkout
@@ -45,8 +46,15 @@ jobs:
4546

4647
- name: Build all translations
4748
run: |
49+
set -x
50+
4851
for po_lang in ${{ env.LANGUAGES }}; do
4952
echo "::group::Building $po_lang translation"
53+
POT_CREATION_DATE=$(grep --max-count 1 '^"POT-Creation-Date:' po/$po_lang.po | sed -E 's/".*: (.*)\\n"/\1/')
54+
if [[ $POT_CREATION_DATE == "" ]]; then
55+
POT_CREATION_DATE=now
56+
fi
57+
git checkout "main@{$POT_CREATION_DATE}" src
5058
MDBOOK_BOOK__LANGUAGE=$po_lang \
5159
MDBOOK_OUTPUT__HTML__SITE_URL=/comprehensive-rust/$po_lang/ \
5260
mdbook build -d book/$po_lang
@@ -55,14 +63,14 @@ jobs:
5563
echo "::endgroup::"
5664
done
5765
58-
- name: Setup Pages
59-
uses: actions/configure-pages@v2
60-
61-
- name: Upload artifact
62-
uses: actions/upload-pages-artifact@v1
63-
with:
64-
path: book/html
65-
66-
- name: Deploy to GitHub Pages
67-
id: deployment
68-
uses: actions/deploy-pages@v1
66+
# - name: Setup Pages
67+
# uses: actions/configure-pages@v2
68+
#
69+
# - name: Upload artifact
70+
# uses: actions/upload-pages-artifact@v1
71+
# with:
72+
# path: book/html
73+
#
74+
# - name: Deploy to GitHub Pages
75+
# id: deployment
76+
# uses: actions/deploy-pages@v1

0 commit comments

Comments
 (0)