search

mozilla-japan / translation

Mozilla 関連のドキュメント翻訳リクエストとステータス管理
220 stars 13 forks source link

アドオンのJavaScriptAPI #246

Open Uemmra3 opened 6 years ago

Uemmra3 commented 6 years ago

72 の中で特に実用的な部分として

https://developer.mozilla.org/ja/Add-ons/WebExtensions/API

Uemmra3 commented 6 years ago

とりあえず見出しをつけるまで

Uemmra3 commented 6 years ago

ちゃんとした翻訳

Uemmra3 commented 6 years ago

(MDN初心者の人が試みに訳してくれないかなぁ…)

miminashi commented 6 years ago

アドオン関連興味あるのでやってみたいです

Uemmra3 commented 6 years ago

@miminashi よろしくですー。 Acknowledgements(謝辞)のところはほぼ定型文なので、ほぼ他のコピペでいけるハズです

miminashi commented 6 years ago

https://developer.mozilla.org/en-US/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNodeType を編集中、プレビューを表示させてみたところ、 {{WebExtExamples}} マクロで、以下のようなエラーが出ました。 とりあえず、ToDo: WebExtExamplesマクロを挿入という文字列に置き換えてあります。

 There was a scripting error on this page. While it is being addressed by site editors, you can view partial content below.

Anyone with an MDN profile can edit a document to fix an error. Use the KumaScript troubleshooting guide as a starting point.

    Error type:
        TemplateExecutionError 
    In macro:
        WebExtExamples (View Macro) 
    Parsing macro:
        WebExtExamples ([]) 
    Full text of error:

        Problem executing template WebExtExamples:
            1 | <div>{{AddonSidebar()}}<br></div><div><br></div><p><strong><code></code></strong><strong><code>bookmarks.BookmarkTreeNodeType</code></strong> 型は、ブックマークツリーのノードが ブックマーク、フォルダ、セパレータのどれなのかを示します。<br></p><h2 id="Type">値の型<a data-cke-saved-href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode$edit#値の型" href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode$edit#値の型" rel="nofollow, noindex" class="button section-edit only-icon"><em aria-hidden="true" class="icon-pencil"></em><span>Edit</span></a><br></h2><p><code>bookmarks.BookmarkTreeNodeType</code> は以下の3つのうちいずれかの値を取りうる{{jsxref("string")}}です。<br></p><ul><li><code>"bookmark"</code>: ノードがブックマークであることを示します<br></li><li><code>"folder"</code>: ノードがフォルダであることを示します<br></li><li><code>"separator"</code>: ノードがセパレータであることを示します<br></li></ul><h2 id="Browser_compatibility">ブラウザ実装状況<a data-cke-saved-href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode$edit#ブラウザ実装状況" href="https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode$edit#ブラウザ実装状況" rel="nofollow, noindex" class="button section-edit only-icon"><em aria-hidden="true" class="icon-pencil"></em><span>Edit</span></a><br></h2><p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a data-cke-saved-href="https://github.com/mdn/browser-compat-data" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.<br></p><p>{{Compat("webextensions.api.bookmarks.BookmarkTreeNodeType", 10)}}<br></p><p>ToDo: WebExtExamplesマクロを挿入<br></p><p>{{WebExtExamples}}<br></p>
        -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------^

        TypeError: ejs:1
         >> 1| <%
            2| 
            3| /*
            4| The "examples.json" file from the https://github.com/mdn/webextensions-examples

        Cannot read property 'split' of undefined
            at eval (eval at compile (/node_modules/ejs/lib/ejs.js:549:12), <anonymous>:105:22)
            at returnedFn (/node_modules/ejs/lib/ejs.js:580:17)
            at /app/lib/kumascript/templates.js:71:26
miminashi commented 6 years ago

https://developer.mozilla.org/ja/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNodeUnmodifiable こちらでも同じくマクロでエラーが出ていました

Uemmra3 commented 6 years ago

マクロエラーの件は #261 で確認したいと思います。

Uemmra3 commented 6 years ago

そもそもやりたいことである翻訳の話に戻ると、 現状アルファベット順で history までの翻訳が終わっています。(中身の妥当性は置いといて)

i18n ～ windows までは見出しだけ翻訳した段階で、中身の翻訳がまだですので、 @miminashi さんのご興味のあるところで進めていただけるとありがたいです。

ktkki commented 4 years ago

https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/identity こちらの記事を翻訳してみました。（初翻訳です！）

OAuth側の用語については、対応する日本語用語になるようにしてみましたが、 関連用語として認識できてない部分でズレが生じているかもしれません。

また、原文において記載（設定項目名）が古い箇所がありました。 「Getting the redirect URL」の２パラグラフ目にある「applications」が該当部分です。

こちらは拡張機能のmanifest.jsonの設定項目名ですが、 現在は「browser_specific_settings」というキー名に変更されているようです。 https://github.com/mdn/browser-compat-data/issues/2540

原文と食い違ってしまうので、一旦古いキー名で訳出しています。 （リンクは最新ページにリダイレクトされているので実用上大きな問題はないかと思います。）

原文へのフィードバックについてアドバイス頂けると助かります！

hmatrjp commented 4 years ago

MDN は、原文も日本語訳と同様に編集できますので、 https://wiki.developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/identity$edit から正しい内容に変更し、ページ下部の Revision Comment 欄に理由を書いて Publish すれば OKです。

hmatrjp commented 4 years ago

訳出された文章も見ました。 ・冒頭の identity API は、IDのAPIでなく、後に出てくるようにそのままの方が良いでしょう。ページ左にあるように、API階層内の固有名なので。 ・domain that you control.は、規定するドメイン　でなく、　管理しているドメイン　だと思います。

ktkki commented 4 years ago

コメントありがとうございます！ 英語原文も普通に編集できたので、修正しました。 また日本語訳に関しても、レビューコメント反映しました。

hmatrjp commented 4 years ago

反映ありがとうございました。原文も直っていることを確認してきました。 訳し残しがなければ、翻訳途中フラグは降ろして大丈夫です。 他に気になるところがなければ、編集レビューフラグも降ろしてこのIssue を Close してください。

hmatrjp commented 4 years ago

このIssue を Close してください。

すみません、これは Uemmra3 が開いた上階層の Issue でしたね。Close は全部片付いてからですので、今は気にしないでください。

翻訳レビューフラグと、翻訳途中フラグは、降ろして大丈夫です。やり方がわからなければお尋ねください。

ktkki commented 4 years ago

確認遅くなりましたが、コメントありがとうございます。

原文を修正したのですが、日本語への反映が漏れていたところ、 別の方に修正頂き、翻訳フラグも下ろして頂いたようです。

Issueについても承知しましたので、 引き続きAPIの翻訳を進めて行こうと思います。

Uemmra3 commented 4 years ago

@ktkki さんが進めてくれてますが、少し加速するために下から(wから)訳しております。 編集履歴に関しては歯車メニューの「履歴」から確認できますよ。

Uemmra3 commented 4 years ago

Advent Calendar にのっかって、 単体の翻訳(sessionsからwindows)を完了しました。

引き続き、runtimeから上へ翻訳していきます。

あと、Advent Calendar書いてくれる人も募集しますw

dynamis commented 2 years ago

さっと見て残っているページをリストにしておきます: