Skip to content

jhipster/jp

JHipsterの公開Webサイト(日本語) のソースです


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


インストール

npm install

ローカル開発

npm start

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

ビルド

npm run build

このコマンドは、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へコミット
    • syncmainにマージするプルリクエストを作成
  • 翻訳者がプルリクエストの内容を確認し、syncの内容を翻訳しコミット
  • mainにマージ

ページ表示

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

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