Home

Welcome to the OSGeoLive-doc Japan wiki!

Setup

Git

Clone & remote setting:

$ git clone [email protected]:OSGeo-jp/OSGeoLive-doc.git OSGeoLive-doc-jp
$ cd OSGeoLive-doc-jp
$ git remote -v
$ git remote add OSGeo [email protected]:OSGeo/OSGeoLive-doc.git

Memo: Sync upstream (OSGeo) repo:

$ cd /path/to/OSGeoLive-doc-jp
$ git checkout master
$ git pull
$ git pull OSGeo master
$ git push

Installation (macOS + Homebrew environment)

Homebrew & CPAN packages:

$ brew install cmake
$ brew install python3
$ brew install plenv
$ vi ~/.zshrc
# 以下の行を追加
# if which plenv > /dev/null; then eval "$(plenv init - zsh)"; fi
$ source ~/.zshrc
$ plenv install -l | more
$ plenv install 5.34.1
$ plenv global 5.34.1
$ plenv install-cpanm
$ cpanm Text::SimpleTable::AutoWidth

Python packages:

$ cd /path/to/OSGeoLive-doc-jp
$ python3 -m venv py-env
$ source py-env/bin/activate
$ pip install -r requirements.txt

Transifex setting: Generate API token from https://www.transifex.com/user/settings/api/

$ cd /path/to/OSGeoLive-doc-jp
$ source py-env/bin/activate
$ tx config
tx INFO: No credentials file was found at /Users/(username)/.transifexrc.
tx INFO: Created /Users/(username)/.transifexrc 
[?] Enter your api token:
Verifying token...
tx INFO: Updating /Users/(username)/.transifexrc file...
:
[?] Enter the path to your local source file:
# Stop by pressing Ctrl+C

Build

$ cd /path/to/OSGeoLive-doc-jp
$ source py-env/bin/activate
$ git checkout transifex_ja
# or git checkout omegat_ja
$ mkdir build
$ cd build
$ cmake -DHTML=ON -DJA=ON ..
$ make
# Then open "./doc/_build/html/ja/index.html"

Fetch/Push latest Japanese *.po files

※OSGeoLiveアップストリーム側では、各言語のpoファイルは 翻訳率 100% 80%以上のものしかコミットされないため、別途最新を取得

$ cd /path/to/OSGeoLive-doc-jp
$ source py-env/bin/activate
$ git checkout master
$ git pull
$ git checkout transifex_ja
$ git pull
$ git merge --no-commit --no-ff master
$ git reset -- locale/ja
$ git checkout -- locale/ja
$ git commit
$ tx status
$ tx pull -l ja -f
$ git add locale/ja/LC_MESSAGES
$ git commit -m "added/updated yyyy/mm/dd ja all po files"
$ git push origin transifex_ja

locale/ja を除いたGitマージについては、下記を参照:

• https://stackoverflow.com/questions/14369378/how-to-make-git-ignore-a-directory-while-merging/14369793#14369793

Update OmegaT branch

omegat 側では、ソースに transifex_ja ブランチを指定していますが、 現状、omegat 側で生成のtargetフォルダのpoファイルに、Transifexとの微妙な差分が生じているため、 omegat_ja ブランチに一旦マージします。 pull-transifex ワークフロー内で双方にフォーマットをかけることで差分を分かりやすくしているため、 omegat_ja ブランチは master ブランチのマージを行うにとどめます。

$ git checkout omegat_ja
$ git pull
$ git merge --no-commit --no-ff master
$ git reset -- locale/ja
$ git checkout -- locale/ja
$ git commit
$ git push

Pull source from OmegaT

下記の omegat 側のActionsより、Pull sourceワークフローを手動実行(Run workflow).
https://github.com/OSGeo-jp/OSGeoLive-doc-omegat/actions?query=workflow%3A%22Pull+source%22

Push transifex

MRをマージ後、ローカル環境で翻訳更新のあったpoファイルを一括で毎に下記を実行、もしくは一括更新。

$ git checkout omegat_ja
$ git pull
$ tx push -t -l ja -r osgeolive.[リソース名]
# 一括更新の場合 (Transifex側で更新分のみ反映してくれる)
$ tx push -t -l ja

リソース名は以下の通り:

• locale/ja/LC_MESSAGES/[ファイル名].po: [ファイル名]
• locale/ja/LC_MESSAGES/overview/[ファイル名].po: overview--[ファイル名]
• locale/ja/LC_MESSAGES/quickstart/[ファイル名].po: quickstart--[ファイル名]

tx push実行中に、以下の pywps_quickstart のように Skipping 'ja' translation (file: locale/ja/LC_MESSAGES/...) と表示される場合は、訳文中にTransifexでの警告が表示されている可能性があるので、Transifexに手動でpoファイルをアップロード。

$ tx push -t -l ja -r osgeolive.quickstart--pygeoapi_quickstart
tx INFO: Pushing resource osgeolive.quickstart--pygeoapi_quickstart
tx WARNING: Pushing 'ja' translations (file: locale/ja/LC_MESSAGES/quickstart/pygeoapi_quickstart.po)
tx INFO: Done.
$ tx push -t -l ja -r osgeolive.quickstart--pywps_quickstart
tx INFO: Pushing resource osgeolive.quickstart--pywps_quickstart
tx INFO: Skipping 'ja' translation (file: locale/ja/LC_MESSAGES/quickstart/pywps_quickstart.po).
tx INFO: Done.