JHipsterの公開Webサイト（日本語） のソースです
- 本家のWebサイト： https://www.jhipster.tech/
- 本家のリポジトリ： https://github.com/jhipster/jhipster.github.io
- 日本語訳について
Note:スタイルを変更する場合は、css/scss以下にある.scssファイルを更新し、npm run sassを実行してCSSを生成してください。CSSを直接更新しないでください。
このWebサイトはGitHub Pagesでレンダリングされています。
ローカルで実行する場合は以下のとおりです。
- ここをForkして リポジトリを作成し、あなたのファイルシステムにクローンします
- Jekyllをインストールしてください
- 初めての場合は、
npm install && bundle installを実行します - システムディレクトリへのインストールを避けたい場合は、代わりに
bundle install --path vendor/bundleによってvendorディレクトリにインストールします - Mac OSで
nokogiriのインストールがうまくいかない場合は、bundle config build.nokogiri -use-system-libraries=true --with-xml2-include="$(xcrun --show-sdk-path)"/usr/include/libxml2を試してください - リポジトリをクローンしたフォルダで
bundle exec jekyll serveまたはnpm startを実行します - http://localhost:4000 からアクセスできるようになります
（Windows環境では推奨）DockerとDocker-Composeで実行する場合は以下のとおりです。
- ここをForkして リポジトリを作成し、あなたのファイルシステムにクローンします
docker-compose upを実行します- http://0.0.0.0:4000 からアクセスできるようになります
本サイトの日本語訳にあたっては、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の変更箇所は大幅なサイトの変更がない限りほぼ更新することはないので、しばらくこの構造で運用していきます。
