Material-ui: [ドキュメント]ドキュメントを翻訳する

他の人が問題をどのように処理しているかのベンチマークを開始し、最良の解決策をコピーする必要があります。 Vueはドキュメントをフォークしているようです：

• https://github.com/vuejs-ru/old.ru.vuejs.org
• https://github.com/vuejs/cn.vuejs.org

@oliviertassinariしかし、APIドキュメントはどうですか？

APIドキュメントはどうですか？

@mbrookesわかりません。 それは翻訳キーで行うことができます。 api.componentName.propertyName 。 しかし、これはi18nをサポートするためのオーバーヘッドです。

正直なところ、開発リソースの大部分が英語である世界では、ドキュメントの複数の翻訳を維持しようとすると、無駄になり、わずかな利益しか得られないと思います。

Crowdinは翻訳サービスを提供する会社です。 オープンソースプロジェクトの場合、Crowdinは無料の文字列翻訳を提供します

https://docusaurus.io/docs/en/translation.html

ドキュサウルスは素晴らしい解決策かもしれません

@TorzuoliHDocusaurusはオプションではありません。 コンポーネントをドッグフードすることは私たちにとって重要です。

こんにちは。 ドキュメントをスペイン語に翻訳するお手伝いをさせていただきます。

ほとんどのソフトウェアドキュメントは英語で書かれていることを私は知っています。つまり、理想的にはすべての開発者がそれを読むことができるはずです。 しかし、そうではありません。 自国語の「公式」ドキュメントがない場合、その代わりになるのは、かなり疑わしい権限を持つブログやビデオなどです。スペイン語でReactを学ぶための推奨リソースをご覧ください： https ：//github.com/jlobos

必要に応じて、スペイン語/ポルトガル語の翻訳も喜んでお手伝いします。

中国でのシェアを見ると、Material-UIの翻訳ストーリーを前進させる必要があると思います。 たとえば、フランスよりも中国からのトラフィックが少ない…

私は業界が行っていることのベンチマークを開始しました。 それを検討するためのいくつかのソリューションは、アーキテクチャの観点から興味深いものです。

• Vue 。 彼らは内部でHexoを使用していますが、ライブラリのi18n機能を使用していないと思います。
  彼らのワークフローはhttps://github.com/vuejs/vuejs.org/issues/271#issuecomment-266476746で説明されています。 コミュニティがドキュメントをフォークし、彼らの側で翻訳を行うことを奨励しています。 たとえば、 vuejs-fr / vuejs.org 、 vuejs-ru /vuejs.org 。
  これは、私たちの側でより少ない作業を必要とするソリューションです。 しかし、私はそれが非効率的だと思います。 これは、Bootstrapで使用されるアプローチでもあります。
• Nuxtはそのためにさまざまなツールを使用しています。 うまくいけば、私たちにとって、いくつかの詳細があります:)。 GitLocalizeを試してみる価値はあると思います。
• JestはDocusaurusを使用してドキュメントを作成しています。 また、クラウドインを使用してドキュメントを翻訳します。 私はcrowdinがGitLocalizeの競争相手だと信じています。 試してみるのもいいですね。

また： https ：//www.transifex.com

コミュニティがドキュメントをフォークし、彼らの側で翻訳を行うことを奨励しています。 [...]私はそれが非効率的だと思います。

私は同意します-あなたがあなたのコメントを提出する前にコメントを書き始めました。私たちが何をするにしても、変更の追跡は自動化する必要があるという趣旨です。 そうでなければ、翻訳の寄稿者が変更を最新に保つための簡単な方法はなく、翻訳されたドキュメントのユーザーがどの部分が古くなっている可能性があるかを知る方法もありません。

理想的には、ユーザーは、古いテキストとしてフラグが付けられたテキストにカーソルを合わせると、最新の英語のオリジナルが表示され、コンテキスト内で更新された翻訳を送信することもできます。 同様に、新しく追加されたテキストの場合、英語が表示され、翻訳をインラインで送信できます。

これをサポートするために利用できるものがあると想定する必要があります。これは、生きているドキュメントの複数の翻訳を最新の状態に保ちながら、ユーザーが元のドキュメントをコンテキストで確認できるようにするための唯一の実用的なソリューションだからです。 -）

必要に応じて、フランス語の翻訳を喜んでお手伝いさせていただきます。

ここで中国語！ また、ハイのために働いています...中国のドキュメントを喜んで手伝ってくれます。

ポルトガル語の翻訳を手伝うことができます。

私の主な言語はスペイン語です、私は翻訳を手伝うことができます。

@oliviertassinari material-uiは中国の開発者に非常に人気がありますが、多くの企業はそれを嫌っています。 Reactを使っているから！ 中国から来ました。 0.xバージョンからmaterial-uiを使い始めました。 私は彼がとても好きです。 ちなみに、私の友達もmaterial-uiが好きです。 必要に応じて、文書を中国語に変換する能力に貢献したいと思います。 しかし、私は現在、公式のドキュメント構造が他の言語に変更されたフォークを助長していないことを確認しています！

GitHubのトラフィックの発信元を見ると、最初は英語と中国語だけに焦点を当てるべきだと思います。

https://www.similarweb.com/website/github.com

Bootstrapで使用されているアプローチのベンチマークを行っています。 彼らはそれを行うためにコミュニティに依存しています。 中国語版は世界のトラフィックの約10％を占めています。 悪くないです。

@medzフィードバックをありがとう。 はい、コアドキュメント構造に取り組む必要があります。
重要な課題の1つは、最新の状態を維持することです。 どのプロセスを使用する必要がありますか？
私はいくつかのウェブサイトがグーグル翻訳に依存しているのを見ました…しかし人々は私たちがグーグル翻訳を使う必要はありません。

@oliviertassinari言語パッケージのi18n構造またはディレクトリ構造がすべて適切であるか、フォーク変更言語を提供できる構造も適切な選択ですが、フォーク変更言語の構造には、新しいドメイン名をデプロイする必要があります。 ユーザーの使用の観点からは、i18n言語のパッケージ構造またはディレクトリ構造の方が適しています。

中国語のドキュメントがある場合、material-uiは中国でより人気があります。 小さな事実を明らかにするために、中国の多くの英語開発者は非常に悪いです。 英語を見ると諦めたくなりますし、英語力も非常に悪いです。返事には文法の問題がたくさんあると思います！

😄申し訳ありませんが、あなたが間違って何を意味しているのか理解しています。 つまり、他の言語のドキュメントを最新の状態に保つことです。 Docusaurusがi18n構造を使用してファイルを生成した後、翻訳にCrowdinを使用していることを確認しました。 私はCrowdinの翻訳の非常に珍しいバージョンを経験しました！ docusaurusによると、Crowdinはオープンソースプロジェクトに無料の翻訳サポートを提供できます。 このように、翻訳者はドキュメントへの翻訳の送信に参加するだけで済みます。 Crowdinは、ウェアハウスファイルのビルドに基づいて、更新が必要なパーツを自動的に識別します。

ありがとう。

正直なところ、開発リソースの大部分が英語である世界では、ドキュメントの複数の翻訳を維持しようとすると、無駄になり、わずかな利益しか得られないと思います。

いいですね！

@oliviertassinariわかりましたが、他の国で使われていないのは英語だからです。 たとえば、ポルトガル語版では、ブラジル人がプロジェクトでもっと使用するだろうと確信しています。

@fizzvr

ドキュメントの複数の翻訳を維持しようとすると、無駄になります

いいですね！

おそらく、単語のより良い選択は「手動で維持しようとする」ことでした。さもなければ、翻訳でソース資料への変更が見落とされるか、翻訳がソース（または他の）言語に含まれていないコンテンツで補足される可能性があります。

その後、理想的なソリューション（https://github.com/mui-org/material-ui/issues/9511#issuecomment-377815552）について説明しましたが、これを実現しようとするサードパーティのサービスがあるようです。

Material-UIのドキュメントサイトと構造に大規模なオーバーホールなしで統合できるものを見つける必要がありますが、それは価値のあるものにするのに十分なユーティリティも提供します。

@fpudo適切な解決策を見つけることができれば、言語の数は、翻訳作業を引き受ける人々の意志によってのみ制限されます。

中国語の翻訳を喜んでお手伝いさせていただきます。 @私が必要です。 :)

@earvinLi @medz @ xiaoyu-tamuしばらくお待ちいただき、ありがとうございます。いよいよ準備が整いました。 https://crowdin.com/project/material-ui-docs

@earvinLi中国語の翻訳の所有者になって幸せですか？

@mbrookesこんにちはマット、それはちょっと長いです。 私はまだ助けたいと思っていますが、他の2人の良い仲間に、彼らが所有者になりたいかどうか尋ねてもらえますか？

私は必要なスペイン語の翻訳を手伝うことができます！

私は振り返って、それをポルトガル語に翻訳するために再び自分自身を提供しています。

@opusartificis @fpudo 、ありがとう。 中国語から始めますが、このスペースを見てください。

@earvinLi 、確かに、ありがとう。 1、2ページを翻訳してプロセスをテストし、どのように進行するか教えていただけますか？

@mbrookes正解です！

@earvinLiGitterでpingを

@ xiaoyu-tamu始めてくれてありがとう！ 上矢印で示す「優先度が高い」として、使用量に基づく上位10を設定しました。 また、下位10個のファイルと下位3個のディレクトリの優先順位を下げました。

ナンバーワン（マークダウンファイル）はgetting-started/installationです-ホームページも個別に翻訳する必要がありますが、最初にそれをコーディングする必要があります。

ホットリストは次のとおりです。

ドキュメントを翻訳するための助けを求める通知をプッシュします。 中国語で適切な「召喚状」を思い付くことができると思いますか？

素晴らしい！ 中国語を喜んでお手伝いします。

@akaxiaok https://translate.material-ui.com/project/material-ui-docs :)で私たちの努力をフォローし、私たちを助けることができます。

こんにちは、muiウェブサイトの自動翻訳をオフにする方法はありますか？ 元の英語のドキュメントを表示したいのですが、その方法がわかりません。

こんにちは、muiウェブサイトの自動翻訳をオフにする方法はありますか？ 元の英語のドキュメントを表示したいのですが、その方法がわかりません。

@mbrookesこのユースケースを箱の外でサポートしたい場合は、サブフォルダーアプローチを進める必要があるかもしれません。 @marsonmaoが?lang=enを追加すると、機能するはずでした🤔そうでない場合は、ブラウザで使用できる言語を変更する必要があります：/。

@oliviertassinariうーん、このようなURLを試しましたが、機能しませんでした： https://material-ui.com/demos/chips/?lang=en 、Chromeブラウザの言語設定を変更しようとしましたが、どちらも機能しませんでした。 IEのエッジを使ってドキュメントのウェブサイトを開きます。

それだけですが、この翻訳機能は手動で制御するべきではありませんか？ 誰もが常に母国語でドキュメントを表示したいかどうかわかりませんか？ 私自身は、ソースコードとの整合性が高いため、ほとんどの場合英語のドキュメントを読んでいます。 Chieseのドキュメントを読むのは、何か新しいことをすばやく学ぶ必要がある場合だけです。 だから私は手動スイッチがより合理的なアプローチだと思いますか？

@marsonmaoエンドツーエンドで機能させるために、可能な限りシンプルなソリューションを採用しました。 ドキュメントを改善するために活用できるのは、このようなフィードバックです。 はい私は同意する。

@oliviertassinari素晴らしいです、そして私が将来それを使うことができることを願っています。 IEを使用して、回避策のドキュメントを開きます😄また、マテリアルUIの作業に感謝します！

@ marsonmao- @ oliviertassinariは正しいです。 あなたが言うように、あなたの好みが英語でウェブサイトを読むことであるならば、あなたはあなたのブラウザの言語の好みを変える必要があります。 Firefox、Safari、Chromeで再度テストしましたが、期待どおりに動作しています。

将来的には、ブラウザで設定された言語設定を上書きするオプションを追加する可能性がありますが、今のところ、ブラウザの設定を使用してください。

ポルトガル語の翻訳を手伝うことができます。 ブラジルのエントリーレベルとミドルレベルの開発者のほとんどは、英語の勉強に興味がありません。

@andreacornaglia @ fpudo @ caiobessa助けてくれてありがとう。 ブラジルポルトガル語の翻訳が公開されました！

ねえ、私もポルトガル語の翻訳を手伝うことができます。 Crowdinで文字列を翻訳するプロセスはどのようになっているのでしょうか。 誰が翻訳を承認し、誰が新しい翻訳、レビュー担当者、または作成者を使用してプルリクエストを作成する必要がありますか？

ごめん！ 翻訳の変更をリポジトリにプッシュするボットがあることに気付いたので、承認された後、翻訳はレビューのための新しいプルリクエストに自動的に含まれると思いますよね？

@nicolasiensen正解です！ 最初のページでそれを試していただきありがとうございます:)。

明日から翻訳を始めます!!! 超クール！

誰かがポルトガル語で通知の言い回しを提案してくれたら、それをドキュメントに追加します。

中国語の場合、「Material-UIドキュメントを中国語に翻訳するのを手伝って」と提案しましたが、翻訳は「Help Material-UIがドキュメントを中国語に翻訳するのを手伝って」と戻ってきたので、これらの線に沿ったものなら何でもいいでしょう。 自由に創造性を発揮してください。あなたが最も助けになると思うものは何でも。

また、翻訳を簡単にするためのヒントをいくつか紹介します。

• コピーボタンはあなたの友達です！ これを使用して、テキストを翻訳する前に、書式設定を使用してソーステキストをコピーします。
• Material-UI、Reactなどのプロジェクト名を文字通り翻訳しないでください。
• コードサンプルのコメントとレンダリングされた文字列（ボタンラベルなど）を翻訳してください。
• 「ボタン」などのコンポーネント名は翻訳しないでください。 （たとえば、「ボタンを使用できます」、または一般的なボタンを指す見出しとして「ボタン」など、一般的なオブジェクトを参照する場合は、翻訳しても問題ありません。）
• キーボードショートカットを確認してください。時間を節約できます。 （エディター内のアプリバーの右側にあるキーボードアイコン。）お好みに合わせてカスタマイズできます。
• できるだけ多くの人に協力してもらいましょう。 それは大きな仕事です！
• 何かが正しく機能していないように思われる場合は、お知らせください。 微調整できる設定はたくさんあります。

校正者の方は、デモオブジェクトなどのソースから直接コピーされたものを除いて、独自の翻訳を承認しないでください。たとえば、 {{"demo": "pages/demos/app-bar/SimpleAppBar.js"}}は、コピーボタンを使用して翻訳せずにコピーする必要があります。すぐに承認することができます。

@mbrookesありがとう:)

@mbrookesのポルトガル語への翻訳は、スペイン語の「小さな」に似ています。 スペイン語の翻訳を手伝ってくれる人もいます。 含めました。

@fizzvrブラジルポルトガル語の翻訳のトラクションは控えめに言ってもがっかりしました、私たちはまだそれを放棄するかもしれません。 私もスペイン語については知りません-それを求める声はあまりありませんでした。 ほとんどの（ヨーロッパの）スペイン語話者は英語がかなり流暢だと思います。

@mbrookesブラジルポルトガル語の翻訳を進めない場合に備えて、12月31日までお待ちください。 とても静かになります
今年のこの時期の職場で、私はそれに取り組む時間がたくさんあります。

@mbrookes @fpudo私の知る限り、ポルトガル語の翻訳はどこにも掲載されていません。 中国語の場合のように、編集ボタンがなくても機能するとは思いません。

        if (userLanguage === 'zh') {
          return (
            <Button component="a" href="https://translate.material-ui.com/project/material-ui-docs">
              {'将此页面翻译成中文'}
            </Button>
          );
        }

        return (
          <Button component="a" href={`${sourceCodeRootUrl}${markdownLocation}`}>
            {'Edit this page'}
          </Button>
        );

翻訳が欠落している場合は、バナーを使用するとさらに良いでしょう。

@oliviertassinariが最初に中国語に役立ったのは通知でしたが、CrowdInとここで、ポルトガル語での提案された言葉遣い（例として中国語の通知の英語訳を示します）をボランティアに尋ねましたが、提案はありませんでした。

@fpudo 、忙しくないときにこれに取り組むことを申し出てくれてありがとう。 優先事項として、ドキュメント通知の召喚状を提案し、物事を動かすことができるかどうかを確認してください。

これがその場所ならDunnoですが、イタリア語の翻訳で助けを探すなら、私は手を貸すことができます

@mbrookes通知は複数の言語に拡張されません。 私は以下を提案します：

1. ＃13765で前進します。
2. 最終的にサポートしたいすべての言語を追加します。
3. フォールバックを実装します。翻訳が利用できない場合は、英語バージョンを表示します（1.それを有効にします）。
4. 編集ボタンをサポートする言語に翻訳します

1. フォールバックすると、翻訳の助けを求める素敵なバナーが表示されます。 （オプション）

通知は複数の言語に拡張されません。

は？ これは、通知が複数のリリースに拡張されないと言っているようなものです。

可能性のあるすべての翻訳のタップをオンにする前に、いくつかの言語で水域をテストしたいと思います。 通知は、中国語の場合と同様に、ポルトガル語の翻訳作業を開始するのに役立つことを願っています。十分なコンテンツができたら、ローカライズされた編集ボタンを使用してポルトガル語でライブ配信します。

1/3は機能しません-＃13765の説明で述べたように、CrowdIn同期を（永続的または定期的に）有効にすると、翻訳が欠落することはありません。

コードの単純化を除けば、フォールバックPRは冗長です。

は？ これは、通知が複数のリリースに拡張されないと言っているようなものです。

@mbrookesつまり、中国語の翻訳速度が大幅に低下したということです。これは、ドキュメント通知の使用の終了に関連していると思います。 プロセスを開始することはできますが、それを維持するのに十分ではないと思います。 だから私はそれがスケーリングできるとは思わないのです。 また、関心のない人へのメッセージも表示しています。 まだまだ改善の余地があると思います。

翻訳が欠落することはありません。

しかし、私たちはそれを検出しようとすることができます。 存在と翻訳の長さを比較できます。 ターゲットとソースの間のサイズが非常に類似している場合、何も翻訳されていないと結論付けることができます。

最初の2つのコメントは矛盾しているように見えます。通知を削除すると（なぜ削除されたのですか？）、翻訳アクティビティが低下する場合は、通知を保持しておくと維持されます。 -中国語の翻訳はおそらく今ではほとんど完成しているでしょう。

そうは言っても、ボタンCTAが効果的でないのはなぜだろうか。

複数の翻訳を並行して（またはほぼ並行して）開始した場合、現在の通知は拡大縮小されないことに同意します。

それらのIPジオロケーションが役立つのだろうか？

編集ボタンはあまり見えないと思います。 必ずしも明確な支援が必要なわけではありません。 IPジオロケーションが役立ちます。

翻訳を手伝うことに興味がある人のために、フランス語、ドイツ語、スペイン語、ロシア語、日本語が（中国語とポルトガル語と一緒に）ライブになりました：

https://translate.material-ui.com/

今すぐ問題を解決できます：https：//next.material-ui.com/discover-more/languages/。 皆さんの助けと貢献に感謝します！ インフラストラクチャの作業の大部分を実行しました。 現在、翻訳を最新の状態に保つための継続的な取り組みが必要です:)。