日本語対応

[su8ru]

2.0.0-alpha.70 で Docusaurus が多言語対応したみたいです

RFC: facebook/docusaurus#3317
PR: facebook/docusaurus#3325

en: frourio.io / ja: frourio.io/ja の方針でいいかと。

実際にこんな感じで日本語版も書けたので、ひとまず全ページ整備 💪

[solufa]

おお、知らなかった！
URL方針それでOKです

[su8ru]

と思ったのですが、ロケール選択ドロップダウンなどが未実装なようなので、一旦保留ということにします…………

[su8ru]

いろいろ見たところ、ドキュメントが無いだけでこっそり実装されてるっぽいです。

breaking change の可能性があることも考えつつ、少しずつ取り組んでみますね

👇 Zenn スクラップ にまとめつつ調べてます
Docusaurus v2 で多言語化

[solufa]

Zennのスクラップ機能素晴らしいなあ

[clairefro]

（盗聴ですみません）
つい最近、多言語対応のドキュメントが一部公開されたようです：

facebook/docusaurus#3317 (comment)

ドロップダウンについてはこちら：https://v2.docusaurus.io/docs/next/i18n/tutorial#theme-configuration

[solufa]

@clairefro
オープンソースなので積極的に参加してもらえるのはとても嬉しいです！
ドロップダウン搭載されたなら進められそう

[su8ru]

ありがとうございます。
実は既にローカルで進めていて、#19 の様子を見つつ alpha.71 での正式発表を待機している状況です！
(トップページ改修とのタイミング合わせが難題)

[su8ru]

実は既にローカルで進めていて

push するのを完全に忘れていました。すみません……

---

Docusaurus が公式で提唱している repo 内でディレクトリを切って管理する方式は、en と ja の同期を取ることが難しく、React 公式ドキュメントが採用している fork して merge する Git ベースのほうが管理しやすいかもしれません。

必然的に別 repo になりますし、URL も ja.frourio.com にする必要が出てきてしまいますが……

先日 Zenn で公開されていた記事: オープンソースドキュメント翻訳プラットフォームとしての GitHub (React 日本語ドキュメントの例)

[solufa]

Zennの記事を読みました
ja.frourio.com にするのもありですね

[ghost]

@su8ru 現状これどんな感じになってますか？ もし残りのタスクとか共有可能なら共有お願いします！

[su8ru]

@hashue 共有遅れてすみません！

Docusaurus の i18n 機能が alpha にすら載る前に日本語版を実装していたのですが、単一 repo 内でディレクトリを分ける方式があまりにも管理しづらいため、前のコメントで React 公式ドキュメントの手法を提案した次第です。

もしその手法通りに Git merge ベースの管理をするとしたら、ja.frourio.com リポジトリを作成していただき、そちらで日本語訳を進めることになるかとは思うのですが、#78 でページ構成をがらっと変える都合上、どうしても後回しになってしまうかと……（優先レベルが高いのはわかっているのですが…）

[su8ru]

memo:
多地域、多言語のサイト | Google 検索セントラル  |  ドキュメント  |  Google Developers
https://developers.google.com/search/docs/advanced/crawling/managing-multi-regional-sites?hl=ja

[su8ru]

まだ日本語訳は追加途上ですが、#108 にて localeDropdown を追加するので、この PR の merge を以てこの Issue を close とし、https://github.com/frouriojs/ja.frourio.com に引き継ぎます。（タイミングを逃してました…）

完全に日本語対応が済んだら Announcement bar などを追加しようとも考えていますが、それはまた別の Issue にて。