Polyglotについて

PolyglotはJekyllブログ用のオープンソース国際化プラグインです。Polyglotは任意のプロジェクトで簡単にセットアップして使用でき、サポートしたい言語に拡張できます。欠落コンテンツのフォールバックサポート、自動URL相対化、強力なSEOレシピにより、Polyglotは任意の多言語ブログが複雑な作業なしにコンテンツに集中できるようにします。

jekyll-polyglotはまだgithub-actionsでネイティブサポートされていません

インストール

gem install jekyll-polyglot

サポート言語の管理

_config.ymlで、以下のプロパティがウェブサイトでサポートされる言語を管理します。これらの値に新しい言語を追加することでサポートを提供できます（下記参照）。言語は公式のロケールコードで識別されます。

languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io

• languages: ウェブサイトでサポートされる言語を識別するロケールコードの配列。
• default_lang: ウェブサイトのデフォルト言語。
• exclude_from_localization: ビルドされたウェブサイトの一部であるが、ローカライズする必要のないフォルダとディレクトリ。これは主にビルド時間を短縮するためであり、画像やフォントなどのアセットファイルはウェブサイトの大きな部分を占めるため、出力で不必要に「翻訳」されたり複製されたりしないことを保証します。
• url 本番静的ウェブサイトのURL。

新しい言語の追加

すでに機能する単一言語のウェブサイトがあると仮定すると、新しい言語の追加は簡単ではありません。真の多言語ウェブサイトを作成するには、すべてのコンテンツを新しい言語で再作成する必要があることを予期すべきです。 これは大きな作業のように思えるかもしれませんが、翻訳を部分的に考えてください。コンテンツは王様です。新しいページと投稿が更新された翻訳を取得することがより重要です。多言語ウェブサイトの作成は、最初から完璧に翻訳されることを要求する場合にのみ困難です。

まず、あなた（とチーム、そしてマネージャーがいれば彼らも）は、新しいウェブサイトのためにどのコンテンツを翻訳する必要があるかを議論して選択する必要があります。翻訳する優先的な基本コンテンツを選択する必要があります。分析、人気のあるページとブログ投稿、そして現在および将来のユーザーのウェブサイトへのフローを考慮してください。疑問がある場合は、古いブログ投稿よりもページを優先してください。新しい言語をより早くローンチすることを意味する場合、古い投稿は翻訳する価値よりも多くの労力を必要とするかもしれません。

次に、サイト全体でリッチコンテンツの100%カバレッジを提供する必要があります（または強くお勧めします）。これらはより複雑な方法で埋め込まれた小さな文字列です。リッチコンテンツを反復処理する方法は複数あります。リッチコンテンツのすべての小さな文字列をすべての言語でサポートする必要があることを忘れないでください。

多言語コンテンツ

ウェブサイトのコンテンツには2種類あります：基本とリッチ。

基本コンテンツは、ブログ投稿、ページ、非インタラクティブコンテンツのプレーンテキストです。ページと投稿を考えてください。基本コンテンツはウェブサイトのクリックの燃料です。Polyglotは基本コンテンツのフォールバックサポートを提供します。

リッチコンテンツはインタラクティブで派手で、より短い文字列で構成されています。ナビゲーションバーとドロップダウンを考えてください。リッチコンテンツはより技術的で、訪問者をサイトに留めます。欠落したリッチコンテンツのフォールバックサポートはありません。

Liquidツール

以下のLiquidツールはjekyll-polyglotで使用できます：

• site.languages

{% for lang in site.languages %}
  {{lang}}
{% endfor %}

site.languagesは_config.ymlのlanguages配列を直接指します。Liquidを通じてアクセスできます。

• site.default_lang

  {{site.default_lang}}

site.default_langは_config.ymlのdefault_lang文字列を直接指します。Liquidを通じてアクセスできます。

• site.active_lang

{% if site.active_lang == "es" %}
  <h1>Hola! Como estas?</h1>
{% endif %}

site.active_langはページがビルドされているロケールコードです。ページのドイツ語版は"de"、スペイン語版は"es"などです。Liquidを通じてアクセスできます。

これらのツールを使用して、正しいリッチコンテンツを添付する方法を指定できます。

• page.rendered_lang

{% if page.rendered_lang == site.active_lang %}
  <p>Welcome to our {{ site.active_lang }} webpage!</p>
{% else %}
  <p>webpage available in {{ page.rendered_lang }} only.</p>
{% endif %}

page.rendered_lang変数はページコンテンツの実際の言語を示し、テンプレートがページがフォールバックコンテンツとして提供されているかどうかを検出できるようにします。

Github Pagesサポート

デフォルトでは、GithubはJekyllブログがプラグインGを使用することを防ぎます。これは悪意のあるコードがGithubサーバーで実行されることを防ぐために意図的に行われています。これによりPolyglot（および他のJekyllプラグイン）の使用は難しくなりますが、それでも可能です。

_site/をgh-pagesにビルドする

JekyllブログエンジンをGithubでホストする代わりに、別のブランチでJekyllウェブサイトを開発し、ビルドされた_site/コンテンツをgh-pagesブランチにプッシュできます。これにより、Githubにウェブサイトをビルドさせることなく、Githubでウェブサイト開発を管理およびソース管理できます！

Jekyllコンテンツを別のブランチで管理し、_site/フォルダのみをgh-pagesブランチにコミットすることでこれを行えます。これらはフォルダ内の静的HTMLページに過ぎないため、Githubは他のgh-pagesコンテンツと同様にホストします。

自動化しましょう！

このプロセスは、ウェブサイトをビルドして_site/フォルダをgh-pagesにコミットするシンプルなスクリプトで大幅に支援されます。多くの人がこれを持っています。こちらに一つ。こちらにもう一つ。こちらは私の公開スクリプトです：

#! /bin/sh
# ブランチ名を適宜変更してください
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages