Update how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

Author: yunseo-kim

_posts/de/2024-11-18-how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

@@ -11,14 +11,17 @@ tags:
 ---
 ## Einleitung
 Vor etwa 4 Monaten, Anfang Juli 2024, habe ich das [Polyglot](https://github.com/untra/polyglot)-Plugin implementiert, um mehrsprachige Unterstützung für diesen Jekyll-basierten Blog hinzuzufügen, der über Github Pages gehostet wird.
-In diesem Beitrag teile ich die Bugs, die während der Implementierung des Polyglot-Plugins auftraten, deren Lösungsprozess und wie man HTML-Header und sitemap.xml unter Berücksichtigung von SEO erstellt.
+In diesem Beitrag teile ich die Bugs, die während der Anwendung des Polyglot-Plugins auf das Chirpy-Theme auftraten, deren Lösungsprozesse, sowie Methoden zum Schreiben von HTML-Headern und sitemap.xml unter Berücksichtigung der SEO.
 
 ## Anforderungen
-- [x] Die gebauten Ergebnisse (Webseiten) sollten in sprachspezifischen Pfaden (z.B. `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}) bereitgestellt werden.
-- [x] Um den zusätzlichen Zeit- und Arbeitsaufwand für die mehrsprachige Unterstützung zu minimieren, sollte die Sprache beim Bauen automatisch anhand des lokalen Pfads der originalen Markdown-Datei (z.B. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) erkannt werden, ohne dass 'lang' und 'permalink' Tags im YAML-Frontmatter der Markdown-Datei manuell angegeben werden müssen.
-- [x] Der Header-Bereich jeder Seite der Website sollte angemessene Content-Language Meta-Tags und hreflang Alternate-Tags enthalten, um die SEO-Richtlinien für die Google-Mehrsprachensuche zu erfüllen.
-- [x] Die `sitemap.xml` sollte Links zu allen mehrsprachigen Seiten der Website ohne Auslassungen bereitstellen, und die `sitemap.xml` selbst sollte nur einmal im Root-Verzeichnis existieren, ohne Duplikate.
-- [ ] Alle Funktionen, die vom [Chirpy-Theme](https://github.com/cotes2020/jekyll-theme-chirpy) bereitgestellt werden, sollten auf jeder Sprachseite normal funktionieren. Falls nicht, müssen sie entsprechend angepasst werden.
+- [x] Die gebauten Ergebnisse (Webseiten) sollten unter sprachspezifischen Pfaden (z.B. `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}) bereitgestellt werden können.
+- [x] Um den zusätzlichen Zeit- und Arbeitsaufwand für die mehrsprachige Unterstützung zu minimieren, sollte es möglich sein, die Sprache automatisch anhand des lokalen Pfads (z.B. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) zu erkennen, ohne dass 'lang' und 'permalink' Tags im YAML-Frontmatter der originalen Markdown-Dateien manuell spezifiziert werden müssen.
+- [x] Der Header-Bereich jeder Seite der Website sollte angemessene Content-Language Meta-Tags und hreflang Alternate-Tags enthalten, um die SEO-Richtlinien für die mehrsprachige Google-Suche zu erfüllen.
+- [x] Es sollte möglich sein, Links zu allen Seiten, die jede Sprache unterstützen, ohne Auslassungen in der `sitemap.xml` bereitzustellen, und die `sitemap.xml` selbst sollte nur einmal im Root-Verzeichnis ohne Duplikate existieren.
+- [ ] Alle vom [Chirpy-Theme](https://github.com/cotes2020/jekyll-theme-chirpy) bereitgestellten Funktionen sollten auf jeder Sprachseite normal funktionieren, andernfalls sollten sie entsprechend angepasst werden.
+  - [x] Normale Funktion von Features wie 'Recently Updated', 'Trending Tags' usw.
+  - [x] Keine falsch positiven (False Positive) Warnungen bei der Überprüfung interner Links während des Build-Prozesses mit GitHub Actions
+  - [ ] Normale Funktion der Beitragssuche in der oberen rechten Ecke des Blogs
 
 ## Anwendung des Polyglot-Plugins
 Da Jekyll standardmäßig keine mehrsprachigen Blogs unterstützt, ist ein externes Plugin erforderlich, um einen mehrsprachigen Blog zu implementieren, der die obigen Anforderungen erfüllt. Nach einiger Recherche stellte sich heraus, dass [Polyglot](https://github.com/untra/polyglot) häufig für die Implementierung mehrsprachiger Websites verwendet wird und die meisten der obigen Anforderungen erfüllen kann, daher wurde dieses Plugin ausgewählt.

_posts/en/2024-11-18-how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

@@ -1,5 +1,5 @@
 ---
-title: How to Support Multiple Languages on a Jekyll Blog with Polyglot
+title: How to Support Multiple Languages on Jekyll Blog with Polyglot
 description: >-
   Introducing the process of implementing multilingual support by applying the Polyglot plugin to a Jekyll blog based on 'jekyll-theme-chirpy'.
 categories:
@@ -11,14 +11,17 @@ tags:
 ---
 ## Introduction
 About 4 months ago, in early July 2024, I added multilingual support to this Jekyll-based blog hosted on Github Pages by applying the [Polyglot](https://github.com/untra/polyglot) plugin.
-In this post, I will share the bugs encountered during the process of applying the Polyglot plugin and their solutions, as well as how to write HTML headers and sitemap.xml considering SEO.
+In this post, I'll share the bugs encountered while applying the Polyglot plugin to the Chirpy theme, their resolution process, and how to write HTML headers and sitemap.xml considering SEO.
 
 ## Requirements
-- [x] The build result (web pages) should be provided in language-specific paths (e.g., `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}).
-- [x] To minimize the additional time and effort required for multilingual support, the language should be automatically recognized based on the local path (e.g., `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) where the original markdown file is located during the build process, without having to specify 'lang' and 'permalink' tags in the YAML front matter of each markdown file.
+- [x] The built result (web pages) should be provided in language-specific paths (e.g., `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}).
+- [x] To minimize the additional time and effort required for multilingual support, the language should be automatically recognized based on the local path (e.g., `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) where the original markdown file is located during build, without having to specify 'lang' and 'permalink' tags in the YAML front matter of each file.
 - [x] The header part of each page on the site should include appropriate Content-Language meta tags and hreflang alternate tags to meet Google's multilingual search SEO guidelines.
 - [x] All page links supporting each language on the site should be provided in `sitemap.xml` without omission, and `sitemap.xml` itself should exist only once in the root path without duplication.
 - [ ] All functions provided by the [Chirpy theme](https://github.com/cotes2020/jekyll-theme-chirpy) should work normally on each language page, and if not, they should be modified to work properly.
+  - [x] Normal operation of features such as 'Recently Updated', 'Trending Tags', etc.
+  - [x] No false positive warnings during internal link error verification in the build process using GitHub Actions
+  - [ ] Normal operation of the post search function in the upper right corner of the blog
 
 ## Applying the Polyglot Plugin
 Since Jekyll does not natively support multilingual blogs, an external plugin must be used to implement a multilingual blog that meets the above requirements. After searching, I found that [Polyglot](https://github.com/untra/polyglot) is widely used for multilingual website implementation and can satisfy most of the above requirements, so I adopted this plugin.

_posts/es/2024-11-18-how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

@@ -1,7 +1,7 @@
 ---
 title: Cómo implementar soporte multilingüe en un blog Jekyll con Polyglot
 description: >-
-  Se presenta el proceso de implementación de soporte multilingüe utilizando el plugin Polyglot en un blog Jekyll basado en 'jekyll-theme-chirpy'.
+  Se presenta el proceso de implementación del soporte multilingüe utilizando el plugin Polyglot en un blog Jekyll basado en 'jekyll-theme-chirpy'.
 categories:
 - Blogging
 tags:
@@ -10,15 +10,18 @@ tags:
 - RegExp
 ---
 ## Introducción
-Hace aproximadamente 4 meses, a principios de julio de 2024, implementé el soporte multilingüe en este blog basado en Jekyll y alojado a través de Github Pages aplicando el plugin [Polyglot](https://github.com/untra/polyglot).
-En este artículo, compartiré los errores que surgieron durante el proceso de aplicación del plugin Polyglot, cómo los resolví, y cómo escribir el encabezado html y sitemap.xml considerando el SEO.
+Hace aproximadamente 4 meses, a principios de julio de 2024, implementé el soporte multilingüe en este blog basado en Jekyll y alojado a través de Github Pages, aplicando el plugin [Polyglot](https://github.com/untra/polyglot).
+En este artículo, compartiré los errores que surgieron durante el proceso de aplicación del plugin Polyglot al tema Chirpy, cómo los resolví, y cómo escribir el encabezado html y el sitemap.xml considerando el SEO.
 
 ## Requisitos
 - [x] Debe ser posible proporcionar el resultado de la compilación (páginas web) separado por rutas de idioma (ej. `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}).
-- [x] Para minimizar el tiempo y esfuerzo adicionales requeridos para el soporte multilingüe, debe ser posible reconocer automáticamente el idioma según la ruta local donde se encuentra el archivo (ej. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) durante la compilación, sin tener que especificar manualmente las etiquetas 'lang' y 'permalink' en el YAML front matter del archivo markdown original.
+- [x] Para minimizar el tiempo y esfuerzo adicionales necesarios para el soporte multilingüe, debe ser posible reconocer automáticamente el idioma según la ruta local donde se encuentra el archivo markdown original (ej. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}) durante la compilación, sin tener que especificar manualmente las etiquetas 'lang' y 'permalink' en el YAML front matter de cada archivo.
 - [x] El encabezado de cada página del sitio debe incluir las etiquetas meta Content-Language y hreflang alternativas apropiadas para cumplir con las pautas de SEO para la búsqueda multilingüe de Google.
-- [x] Debe ser posible proporcionar enlaces a todas las páginas que admiten cada idioma en el sitio sin omisiones en `sitemap.xml`, y el propio `sitemap.xml` debe existir solo uno en la ruta raíz sin duplicados.
-- [ ] Todas las funciones proporcionadas por el [tema Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) deben funcionar normalmente en cada página de idioma, y si no es así, deben modificarse para que funcionen correctamente.
+- [x] Debe ser posible proporcionar todos los enlaces de las páginas que soportan cada idioma en el sitio sin omisiones en `sitemap.xml`, y el propio `sitemap.xml` debe existir solo uno en la ruta raíz sin duplicados.
+- [ ] Todas las funciones proporcionadas por el [tema Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) deben funcionar correctamente en cada página de idioma, y si no es así, deben modificarse para que funcionen correctamente.
+  - [x] Funcionamiento correcto de características como 'Recently Updated', 'Trending Tags', etc.
+  - [x] No se producirán advertencias de falsos positivos durante la verificación de errores de enlaces internos en el proceso de compilación utilizando GitHub Actions
+  - [ ] Funcionamiento correcto de la función de búsqueda de publicaciones en la esquina superior derecha del blog
 
 ## Aplicación del plugin Polyglot
 Como Jekyll no admite blogs multilingües de forma nativa, se debe utilizar un plugin externo para implementar un blog multilingüe que cumpla con los requisitos anteriores. Después de buscar, encontré que [Polyglot](https://github.com/untra/polyglot) se usa ampliamente para implementar sitios web multilingües y puede satisfacer la mayoría de los requisitos anteriores, por lo que adopté este plugin.

_posts/fr/2024-11-18-how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

@@ -10,15 +10,18 @@ tags:
 - RegExp
 ---
 ## Introduction
-Il y a environ 4 mois, début juillet 2024, j'ai ajouté la prise en charge multilingue à ce blog hébergé via GitHub Pages basé sur Jekyll en appliquant le plugin [Polyglot](https://github.com/untra/polyglot).
-Dans cet article, je partage les bugs rencontrés lors de l'application du plugin Polyglot, leur processus de résolution, ainsi que la méthode pour écrire l'en-tête html et le sitemap.xml en tenant compte du SEO.
+Il y a environ 4 mois, début juillet 2024, j'ai ajouté la prise en charge multilingue à ce blog, hébergé via Github Pages et basé sur Jekyll, en appliquant le plugin [Polyglot](https://github.com/untra/polyglot).
+Dans cet article, je partage les bugs rencontrés lors de l'application du plugin Polyglot au thème Chirpy et leur processus de résolution, ainsi que la méthode de rédaction de l'en-tête html et du sitemap.xml en tenant compte du SEO.
 
 ## Exigences
 - [x] Le résultat de la construction (pages web) doit pouvoir être fourni en distinguant les chemins par langue (ex. `/posts/ko/`{: .filepath}, `/posts/ja/`{: .filepath}).
-- [x] Afin de minimiser le temps et les efforts supplémentaires nécessaires pour la prise en charge multilingue, la langue doit pouvoir être automatiquement reconnue lors de la construction en fonction du chemin local où se trouve le fichier original Markdown (ex. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}), sans avoir à spécifier manuellement les balises 'lang' et 'permalink' dans le YAML front matter du fichier Markdown écrit.
-- [x] L'en-tête de chaque page du site doit inclure les balises méta Content-Language et hreflang alternatives appropriées pour répondre aux directives SEO de Google pour la recherche multilingue.
+- [x] Pour minimiser le temps et les efforts supplémentaires nécessaires à la prise en charge multilingue, la langue doit pouvoir être automatiquement reconnue lors de la construction en fonction du chemin local où se trouve le fichier markdown original (ex. `/_posts/ko/`{: .filepath}, `/_posts/ja/`{: .filepath}), sans avoir à spécifier manuellement les balises 'lang' et 'permalink' dans le YAML front matter du fichier original.
+- [x] La partie en-tête de chaque page du site doit inclure des balises méta Content-Language appropriées et des balises alternatives hreflang pour répondre aux directives SEO pour la recherche multilingue de Google.
 - [x] Tous les liens des pages prenant en charge chaque langue sur le site doivent pouvoir être fournis sans omission dans `sitemap.xml`, et `sitemap.xml` lui-même ne doit exister qu'une seule fois dans le chemin racine sans duplication.
-- [ ] Toutes les fonctionnalités fournies par le [thème Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) doivent fonctionner normalement sur chaque page de langue, et si ce n'est pas le cas, elles doivent être modifiées pour fonctionner normalement.
+- [ ] Toutes les fonctionnalités fournies par le [thème Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) doivent fonctionner normalement sur chaque page de langue, et si ce n'est pas le cas, elles doivent être modifiées pour fonctionner correctement.
+  - [x] Fonctionnement normal des fonctionnalités telles que 'Recently Updated', 'Trending Tags', etc.
+  - [x] Pas de faux positifs (False Positive) lors de la vérification des erreurs de liens internes du site pendant le processus de construction utilisant GitHub Actions
+  - [ ] Fonctionnement normal de la fonction de recherche de posts en haut à droite du blog
 
 ## Application du plugin Polyglot
 Comme Jekyll ne prend pas en charge nativement les blogs multilingues, il faut utiliser un plugin externe pour implémenter un blog multilingue répondant aux exigences ci-dessus. Après recherche, j'ai constaté que [Polyglot](https://github.com/untra/polyglot) est largement utilisé pour implémenter des sites web multilingues et peut satisfaire la plupart des exigences ci-dessus, j'ai donc choisi ce plugin.

_posts/ja/2024-11-18-how-to-support-multi-language-on-jekyll-blog-with-polyglot.md

@@ -11,14 +11,17 @@ tags:
 ---
 ## はじめに
 約4ヶ月前の2024年7月初め、JekyllベースでGithub Pagesを通じてホスティング中の本ブログに[Polyglot](https://github.com/untra/polyglot)プラグインを適用して多言語サポートの実装を追加しました。
-この記事では、Polyglotプラグインを適用する過程で発生したバグとその解決過程、そしてSEOを考慮したhtmlヘッダーとsitemap.xmlの作成方法を共有します。
+この記事では、ChirpyテーマにPolyglotプラグインを適用する過程で発生したバグとその解決過程、そしてSEOを考慮したhtmlヘッダーとsitemap.xmlの作成方法を共有します。
 
 ## 要件
 - [x] ビルドした結果物（ウェブページ）を言語別のパス（例：`/posts/ko/`{: .filepath}、`/posts/ja/`{: .filepath}）で区別して提供できること。
-- [x] 多言語サポートに追加的に必要な時間と労力を可能な限り最小化するために、作成した原本のマークダウンファイルのYAML front matterに'lang'および'permalink'タグを一々指定しなくても、ビルド時に該当ファイルが位置するローカルパス（例：`/_posts/ko/`{: .filepath}、`/_posts/ja/`{: .filepath}）に応じて自動的に言語を認識できること。
-- [x] サイト内の各ページのヘッダー部分は適切なContent-Languageメタタグとhreflang代替タグを含み、Googleの多言語検索のためのSEOガイドラインを満たすこと。
+- [x] 多言語サポートに追加的に必要な時間と労力を可能な限り最小化するため、作成したオリジナルのマークダウンファイルのYAML front matterに'lang'および'permalink'タグを一つ一つ指定しなくても、ビルド時にそのファイルが位置するローカルパス（例：`/_posts/ko/`{: .filepath}、`/_posts/ja/`{: .filepath}）に応じて自動的に言語を認識できること。
+- [x] サイト内の各ページのヘッダー部分は、適切なContent-Languageメタタグとhreflang代替タグを含め、Googleの多言語検索のためのSEOガイドラインを満たすこと。
 - [x] サイト内で各言語をサポートするすべてのページリンクを漏れなく`sitemap.xml`で提供できること、また`sitemap.xml`自体は重複なくルートパスに1つだけ存在すること。
 - [ ] [Chirpyテーマ](https://github.com/cotes2020/jekyll-theme-chirpy)で提供されるすべての機能が各言語ページで正常に動作すること。そうでない場合は正常に動作するように修正すること。
+  - [x] 'Recently Updated'、'Trending Tags'などの機能が正常に動作すること
+  - [x] GitHub Actionsを利用したビルド過程でサイト内部リンクのエラー検証時、偽陽性（False Positive）警告が発生しないこと
+  - [ ] ブログ右上の投稿検索機能が正常に動作すること
 
 ## Polyglotプラグインの適用
 Jekyllは多言語ブログを基本サポートしていないため、上記の要件を満たす多言語ブログの実装には外部プラグインを活用する必要があります。検索してみると[Polyglot](https://github.com/untra/polyglot)が多言語ウェブサイト実装用途でよく使われており、上記の要件のほとんどを満たすことができるため、このプラグインを採用しました。