Handbook Japanese and update ZH with Provenance section

[DrJingLee]

update with ja.po ;
add language botton "日本語版"

[raphjaph]

I'm having trouble building the the book. We're you able to build it properly?

[DrJingLee]

I'm having trouble building the the book. We're you able to build it properly?

I can check the error info by tomorrow and run locally before commit

[DrJingLee]

I'm having trouble building the the book. We're you able to build it properly?

Local run successfully after fix the typo and format error.

[DrJingLee]

To Update your translation version of Handbook, #2427 here is my opration cmds @ordinaHO
Assume the environment are well configured with Phython, Mdbook and Mdbook-i18n-helper:
1, Synchronize with ordinals/ord ;
2,Run to generate a new pot file : messages.pot

MDBOOK_OUTPUT='{"xgettext": {"pot-file": "messages.pot"}}' \
  mdbook build -d po

3,Run msgmerge, xx.po is your language version; this will allow the po file updated with the newest orignal version;

msgmerge --update po/xx.po po/messages.pot

4,Find #, fuzzy ; i18n using "fuzzy" tag to mark those are newly edited ;

5,Do the transaltion works ;

6,Run mdbook cmd , here is zh example:

mdbook build docs -d build

MDBOOK_BOOK__LANGUAGE=zh mdbook build docs -d build/zh

mv docs/build/zh/html docs/build/html/zh

python3 -m http.server --directory docs/build/html --bind 127.0.0.1 8080

7,check everything is ok , then commit and open the PR to the github.

[ordinaHO]

Hi @DrJingLee , correct i spend sometime yesterday to check out the details! so far i think that adding <div dir="rtl"> command in my translation is making some mistakes as i used Poedit to move my original translation with the new format #2422 .
Im not sure if @raphjaph can help to point out this issue as the language is from right to left 👈 check attachment example below.

[DrJingLee]

Do you think its a good idea to generate the newest .pot file on the github every time when the oringinal book updated. @raphjaph

so other people can just download the newest version and work on it if they don't have the local mdbook environment

[raphjaph]

Looks good, but watch out not to check in files ending with ~ or .pot files. I've removed them

[raphjaph]

Do you think its a good idea to generate the newest .pot file on the github every time when the oringinal book updated. @raphjaph

so other people can just download the newest version and work on it if they don't have the local mdbook environment

I think to properly translate you should download the mdbook things but we should definitley add the commands that you need to run to the README under the Translations header. Would be great if you could open a seperate PR for that!