• 本家のWebサイト： https://www.jhipster.tech/
• 本家のリポジトリ： https://github.com/jhipster/jhipster.github.io
• 日本語訳について
• 翻訳オートメーション

JHipster ウェブサイトは、最新の静的サイトジェネレーターである Docusaurus を使用して構築されています。

npm install

npm start

このコマンドにより、ローカル開発サーバーが起動し、ブラウザウィンドウが開きます。ほとんどの変更は、サーバーの再起動を必要とせずにライブで反映されます。

npm run build -- --locale en

このコマンドは、buildディレクトリに静的コンテンツを生成し、任意の静的コンテンツホスティングサービスで提供できます。

SSHを使用する場合:

USE_SSH=true npm run deploy

SSHを使用しない場合:

GIT_USER=<あなたのGitHubユーザー名> npm run deploy

GitHub Pagesをホスティングに使用している場合、このコマンドはウェブサイトをビルドしてgh-pagesブランチにプッシュする便利な方法です。

本サイトの日本語訳にあたっては、OSS活動へも使用可能なみんなの自動翻訳＠TexTra®の翻訳内容を活用させていただきました。この場を借りてお礼を申し上げます。

翻訳の文体は、本家のpackage.jsonにtextlintパッケージを加えての指摘と、TexTraの翻訳内容になるべく従うことで、統一させています。

誤訳や不自然な言い回しが無いよう、注意しながら進めてはいますが、もし問題がありましたら、Issue/PRでご指摘ください。

本家の更新に伴う日本語訳の追従については、ReactやVueの翻訳での実績がある、オープンソースドキュメント翻訳プラットフォームとしての GitHubの運用方法がとても素晴らしく、参考にしています。この場を借りてお礼を申し上げます。

運用方法は以下の通りです。

• Github Actionsで以下を処理
  • 定期的に本家のmainをチェック
  • 更新があれば翻訳用syncブランチを作成
  • 本家の差分を翻訳中（コンフリクトマーカー有）状態としてsyncへコミット
  • syncをmainにマージするプルリクエストを作成
• 翻訳者がプルリクエストの内容を確認し、syncの内容を翻訳しコミット
• mainにマージ

本家と同様、Github Pagesを使って表示します。表示元はgh-pagesブランチの内容になります。

gh-pagesはほぼ全てmainブランチと同様ですが、ごく一部、日本語サイト表示のためにgh-pagesのみ変更した内容があります。 mainとの差分はこちらを見て確認してください。 mainに書かない理由は、本家のサイトの構造上、mainに入れるとローカルのテスト環境で動かないためです。 結果、本家との差分がmainとgh-pagesで散在しまいますが、gh-pagesの変更箇所は大幅なサイトの変更がない限りほぼ更新することはないので、しばらくこの構造で運用していきます。

upstream（本家）の更新は、Java 製の ai-docsite-translator を利用して自動追従します。

• ワークフロー名: ai-docsite-translation
• スケジュール: 毎日 12:30 JST (cron: "30 3 * * *")
• 実行内容: upstream 取得 → 翻訳 → PR 作成 (sync-<upstream-short-sha> ブランチ)
• 主要依存: Java 21 / Gemini API (GEMINI_API_KEY), GITHUB_TOKEN
• 設定詳細: .github/workflows/ai-docsite-translation.yml

tools/run-ai-docsite-translator.sh でローカル実行、act -j translate で GitHub Actions を再現できます。環境変数は .env.translator（Git 管理外）および .secrets.translator で管理します。詳細手順は .github/llm-translation/docs/runbook.md を参照してください。

旧 Python パイプラインは撤去済みです。ai-docsite-translator に関する不具合が発生した場合は runbook のトラブルシュート節に従って手動同期を実施してください。