Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

英語版ページの導入 #6208

Open
Tracked by #4406
KATO-Hiro opened this issue Jun 20, 2023 · 3 comments
Open
Tracked by #4406

英語版ページの導入 #6208

KATO-Hiro opened this issue Jun 20, 2023 · 3 comments

Comments

@KATO-Hiro
Copy link
Owner

KATO-Hiro commented Jun 20, 2023

WHY

  • コンテストの参加者の約半数は海外ユーザ
    • 本当に必要としているか?
  • サイトの訪問者の約99%は日本人ユーザなので、開拓の余地はある

WHAT

  • 英語版を数ページ用意して、反応を見てみるか?
@KATO-Hiro
Copy link
Owner Author

KATO-Hiro commented Jun 20, 2023

https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/?h=lan#site-language-selector

extra:
  alternate:
    - name: ja - 日本語
      link: /
      lang: ja
    - name: English
      link: ../en/
      lang: en

@KATO-Hiro
Copy link
Owner Author

KATO-Hiro commented Jul 13, 2023

Trying

  • 公式Docsを読む
  • ymlに言語選択のオプションを追加
  • 英語版のディレクトリとサンプルファイルを追加
  • 動作確認
    • 英語版を指定したときに、サイドバーで/enを含むリンクに移動できるように

FIXME

  • サイドバーのリンクが日本語版のままになっている
    • 英語版のmkdocs.ymlが認識されておらず、日本語版とは別にビルドする必要があるか?
    • もしくは、ディレクトリのパスをミスしている可能性も
    • 本番環境を壊しそうで怖いので、以前用意していた練習用プロジェクトで試してみる

See

https://github.com/bfenetworks/bfe/blob/develop/docs/Makefile

@KATO-Hiro
Copy link
Owner Author

他言語対応している著名OSSの例

https://github.com/tiangolo/fastapi
https://github.com/bfenetworks/bfe

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant