vuejs / jp.vuejs.org

:jp: Japanese translation for vuejs.org

vuejs/jp.vuejs.org

このリポジトリは Vue.js バージョン 2.x 向けのドキュメントを管理しているレポジトリです。

• Vue.js 3.x 向けドキュメント管理リポジトリ: こちら
• Vue.js 1.x 向けドキュメント管理リポジトリ: こちら

このサイトは hexo で構築されています。サイトコンテンツは src の位置に markdown フォーマットで書かれています。プルリクエスト、歓迎します！

貢献ガイド

Vue.js 公式サイト日本語翻訳ガイド を一読お願いします！

開発

$ npm install
$ npm start # http://localhost:4000 で開発サーバを開始

デプロイ

このサイトは lang-jaにコミットまたはプルリクエストがマージされるとNetlifyを介して、自動的にデプロイされます。

貢献者

貢献された方々は、こちら

jp.vuejs.org's Issues

"Priority D Rules: Use with Caution" セクションの翻訳

英語

https://vuejs.org/v2/style-guide/#Priority-D-Rules-Use-with-Caution-Potentially-Dangerous-Patterns

翻訳対象

https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/src/v2/style-guide/index.md#priority-d-rules-use-with-caution-potentially-dangerous-patterns

関連 Issue (追記: 2017-10-02 23:31)

#368

"Components" の翻訳

英語: Components
翻訳対象: src/guide/components.md

[Doc]: fix code tags (#1262)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@ce5efe4

"Plugins" の翻訳

英語: Plugins
翻訳対象: src/guide/plugins.md

"The Vue Instance" の翻訳

英語: The Vue Instance
翻訳対象: src/guide/instance.md

"Installation" の翻訳

英語: Installation
翻訳対象: src/guide/installation.md

"Conditional Rendering" の翻訳

英語: Conditional Rendering
翻訳対象: src/guide/conditional.md

"Comparison with Other Frameworks" の翻訳

英語: Comparison with Other Frameworks
翻訳対象: src/guide/comparison.md

"Routing" の翻訳

英語: Routing
翻訳対象: src/guide/routing.md

"Priority B Rules: Strongly Recommended" セクションの翻訳

英語

https://jp.vuejs.org/v2/style-guide/#Priority-B-Rules-Strongly-Recommended-Improving-Readability

翻訳対象

https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/src/v2/style-guide/index.md#priority-b-rules-strongly-recommended-improving-readability

関連 Issue (追記: 2017-10-02 23:31)

#368

[Doc]: Updated code example to include closing tag. (#1216)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@6b57036

"Mixins" の翻訳

英語: Mixins
翻訳対象: src/guide/mixins.md

"Computed Properties and Watchers" の翻訳

英語: Computed Properties and Watchers
翻訳対象: src/guide/computed.md

"Migration from Vue 1.x" の翻訳

英語: Migration from 1.x
翻訳対象: src/guide/migration.md

[Doc]: typescript.md: mentioned support in WebStorm (#1240)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@eaedd4c

"Class and Style Bindings" の翻訳

英語: Class and Style Bindings
翻訳対象: src/guide/class-and-style.md

"Unit Testing" の翻訳

英語: Unit Testing
翻訳対象: src/guide/unit-testing.md

"Priority C Rules: Recommended" セクションの翻訳

英語

https://vuejs.org/v2/style-guide/#Priority-C-Rules-Recommended-Minimizing-Arbitrary-Choices-and-Cognitive-Overhead

翻訳対象

https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/src/v2/style-guide/index.md#priority-c-rules-recommended-minimizing-arbitrary-choices-and-cognitive-overhead

関連 Issue (追記: 2017-10-02 23:31)

#368

[Doc]: Add description about `scope` in API doc (#1264)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@0ffc42a

what is '糖衣構文' ?

https://github.com/vuejs/jp.vuejs.org/blame/9db9ca643ff72eb1ff24f43afa7672c69fa1cbb5/src/v2/guide/components.md#L543

'同一' or '等意' or ...
Thanks.

"Join the Vue.js Community!" の翻訳

英語: Join the Vue.js Community!
翻訳対象: src/guide/join.md

[Doc]: Update directive documentation with tip relating to v-html and scoped…

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@604c9da

"Single File Components" の翻訳

英語: Single File Components
翻訳対象: src/guide/single-file-components.md

blog: "2015-10-28: Why Vue.js doesn't support templateURL" の翻訳

下記のブログ記事の翻訳。

vuejs/v2.vuejs.org@1f3841b

"Style Guide" の翻訳

背景

Vue.js のスタイルガイドが公式の下記ドキュメントとして公開されました。それに伴い、翻訳したい方を募集します。
https://vuejs.org/v2/style-guide/

翻訳該当ファイル

本レポジトリの下記ファイル

• src/v2/style-guide/index.md

貢献した際の特典

Vue.js 日本語公式サイトの貢献ページに、あなたの GitHub アカウントがクレジットとして掲載されます。

貢献方法

1. 翻訳したい方は、本 issue で、「翻訳やります！」的なコメントで宣言します 🙋
2. メンテナである @kazupon に同 issue でコメントで承認されたら、正式に自分が選んだ issue の翻訳担当者としてアサインされたことになります
3. このリポジトリをフォークします!
4. 必要なら翻訳作業の環境をセットアップします: node.js のインストール、npm install など
5. lang-ja ブランチからトピックブランチを作成します: 例 git branch style-guide lang
6. Vue.js 公式サイト日本語翻訳ガイドに従って翻訳作業をします 📝
7. 翻訳作業での変更をコミットします: 例 git add src/v2/style-guide/index.md && git commit -am 'Fix some files'
8. フォークした自分のレポジトリに Push します: 例 git push origin style-guide
9. 問題がなければ、プルリクエストを vuejs/jp.vuejs.org の lang-ja ブランチに送ります
10. レビュー 👀 で指摘事項があったら修正し、再度 Push します 📝
11. レビュー 👀 で OK ならば、マージされて担当した翻訳は晴れて終了になります! 🎉

翻訳における注意事項

• 翻訳の締切は OSS なので特に設けませんが、作業開始してレビュー完了まで含めてだいだい 1 ヶ月以内ぐらいを目処に進めて頂けると助かります 🙇
• Style Guide ですがまだ beta なので変更される可能性がありますが、翻訳開始時の内容で大丈夫です。差分はこちらで対応します。
• Style Guide かなり量が多いので、WIP(Work In Progress:作業中)な状態でプルリクエスト送り、区切りがよいセクション単位(段落)等で、適宜コミットしてその都度 Push して頂けると、レビュー 👀 もしやすく、翻訳される方も気分的に楽になると思いますので、して頂ける助かります 🙏
• 翻訳作業を開始する際は、翻訳開始する際に、なるべく lang-ja ブランチの最新をものを使用してください。lang-ja は随時本家の最新内容を取り入れており、翻訳漏れが少なくなります
• 翻訳作業中に翻訳について不明点がある場合は、自分が翻訳宣言した issue にコメントお願いします 💬

[Doc]: Fix header link (#1263)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@b73f126

html要素のlang属性値

現状、html要素のlang属性値がenになっている。日本語のドキュメントなので、それはjaであるべきである。

https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/themes/vue/layout/layout.ejs#L3

"State Management" の翻訳

英語: State Management
翻訳対象: src/guide/state-management.md

"Introduction" の翻訳

英語: Introduction
翻訳対象: src/guide/index.md

"Migration from Vue Router 0.7.x" の翻訳

英語: http://rc.vuejs.org/guide/migration-vue-router.html
翻訳対象: src/guide/migration-vue-router.md

"Transitioning State" の翻訳

英語: Transitioning State
翻訳対象: src/guide/transitioning-state.md

"Form Input Bindings" の翻訳

英語: Form Input Bindings
翻訳対象: src/guide/forms.md

[Doc]: typescript.md: mentioned support in WebStorm (#1240)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@eaedd4c

"Custom Directives" の翻訳

英語: Custom Directives
翻訳対象: src/guide/custom-directive.md

[Doc]: Updated code example to include closing tag. (#1216)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@6b57036

[Doc]: Fixed typo (In -> If)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@de0a793

"List Rendering" の翻訳

英語: List Rendering
翻訳対象: src/guide/list.md

"API" の翻訳

英語: API
翻訳対象: src/api/index.md

[Doc]: chore(readme): Add persian translation repo (#1267)

本家のドキュメントに更新がありました:page_facing_up:
Original:vuejs/v2.vuejs.org@ad3092e

"Template syntax" の翻訳

英語: Template syntax
翻訳対象: src/guide/syntax.md

"Server-Side Rendering" の翻訳

英語: Server-Side Rendering
翻訳対象: src/guide/ssr.md

b2e583d のLintエラーの修正

b2e583d がTextLintで落ちているので修正する
(今日中にやります)

"Reactivity in Depth" の翻訳

英語: Reactivity in Depth
翻訳対象: src/guide/reactivity.md

"Transitions: Entering, Leaving, and Lists" の翻訳

英語: Transitions: Entering, Leaving, and Lists
翻訳対象: src/guide/transitions.md

adjustment tasks for 2.0 official translation docs

• add Migration from Vuex 0.6.x to 1.0
• Pick up difference commits from vuejs/vuejs.org
• spelling inconsistency and deadlink checking
• Add translation credits to top page
• setting vuejs/1.0-jp.vuejs.org for 1.x documentations (to @yyx990803)
• release the translated jp.vuejs.org for 2.0
• add jp.vuejs.org link to vuejs.org

"Event Handling" の翻訳

英語: Event Handling
翻訳対象: src/guide/events.md

"Render Functions" の翻訳

英語: Render Functions
翻訳対象: src/guide/render-function.md

support vue.js development の翻訳

下記ページの翻訳
http://vuejs.org/support-vuejs/

ソース
https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/src/support-vuejs/index.md

"Priority A Rules: Essential" セクションの翻訳

英語

https://jp.vuejs.org/v2/style-guide/#Priority-A-Rules-Essential-Error-Prevention

翻訳対象

Priority A Rules: Essential セクションの部分
https://github.com/vuejs/jp.vuejs.org/blob/lang-ja/src/v2/style-guide/index.md#priority-a-rules-essential-error-prevention

関連 Issue (追記: 2017-10-02 23:31)

#368

Vue 2.0 ドキュメントの翻訳

Vue 2.0 ドキュメント翻訳ガイド

背景

本家公式ドキュメント の 2.0 向けのドキュメント、大方作業が終わりました。それに伴い翻訳作業が出来る状態になりましたので、2.0 向けドキュメントの翻訳を開始します。

Vue 2.0 翻訳プロジェクトの作業項目

下記 vuejs/jp.vuejs.org の GitHub Projects を参照

• vue.js 2.0 document translation
  https://github.com/vuejs/jp.vuejs.org/projects/1

Vue 2.0 翻訳プロジェクトのマイルストーン

vuejs/jp.vuejs.org の下記 URL を参照

• 2.0 document translation
  https://github.com/vuejs/jp.vuejs.org/milestone/1

ビジネスではないので堅苦しい納期の設定はしませんが、リリースは遅くとも11月End までには公開する予定

翻訳完了次第、リリース

貢献した際の特典

README.md (Vue.js日本語公式サイトに翻訳貢献者クレジット専用ページも検討中) に Vue.js 2.0 向けに用意した貢献者一覧にあなたの GitHub アカウントがクレジットとして掲載されます

貢献方法

1. こちら にある backlog の中から自分が翻訳したい issue を選びます
2. 選んだ issue 内で、「翻訳やります！」的なコメントで宣言します 🙋
3. メンテナである @kazupon に同 issue でコメントで承認されたら、正式に自分が選んだ issue の翻訳担当者としてアサインされたことになります
4. このリポジトリをフォークします!
5. 必要なら翻訳作業の環境をセットアップします: node.js のインストール、npm install など
6. lang-ja-2.0 ブランチからトピックブランチを作成します: 例 git branch guide-installation lang-ja-2.0
7. 翻訳作業をします 📝
8. 翻訳作業での変更をコミットします: 例 git add src/guide/installation.md && git commit -am 'Fix some files'
9. フォークした自分のレポジトリに Push します: 例 git push origin guide-installation
10. 問題がなければ、プルリクエストを vuejs/jp.vuejs.org の lang-ja-2.0 ブランチに送ります
11. レビュー 👀 で指摘事項があったら修正し、再度 Push します 📝
12. レビュー 👀 で OK ならば、マージされて担当した翻訳は晴れて終了になります! 🎉

翻訳スタイル

• JTF日本語標準スタイルガイド（翻訳用） に準拠
• JTF日本語標準スタイルのチェックツールは textlint-plugin-JTF-style を使用し、ルールはVue.js 公式サイト向けに一部カスタマイズ

翻訳のゆらぎ & トーン

文体

「だである」ではなく「ですます」調

Vue.js is a library for building modern web interfaces.

• NG : Vue.js はモダンな Web インターフェースを構築するためのライブラリである。
• OK : Vue.js はモダンな Web インターフェースを構築するためのライブラリです。

半角スペースでアルファベット両端を入れて読みやすく！

Vue.js is a library for building modern web interfaces.

• NG : Vue.jsはモダンなWebインターフェースを構築するためのライブラリです。
• OK : Vue.js はモダンな Web インターフェースを構築するためのライブラリです。

例外として、句読点の前後にアルファベットがある場合は、スペースを入れなくてもいいです。

• 読点: 技術的に、Vue.js は MVVM パターンの ViewModel レイヤに注目しています。

原則、一語一句翻訳、ただ日本語として分かりにくい場合は読みやすさを優先

Alternatively, you can bind the directive directly to an Object. The keys of the object will be the list of classes to toggle based on corresponding values.

• NG: 別な方法としては、直接ディレクティブをオブジェクトにバインドできます。オブジェクトのキーは、クラスのリストは対応する値に基づいてトグルします。
• OK: 別な方法としては、直接ディレクティブをオブジェクトにバインドできます。オブジェクトのキーは、対応する値に基づいてトグルする class のリストになります。

原文に使われる ':' や '!' や '?' などの記号は極力残して翻訳

Example:

• NG: 例
• OK: 例:

ただし、文の途中にハイフン- や セミコン; がある場合は、その記号があると理解しづらい訳になる場合は、例外として削除てもよいです。

• 原文:

  Avoid using track-by="$index" in two situations: when your repeated block contains form inputs that can cause the list to re-render; or when you are repeating a component with mutable state in addition to the repeated data being assigned to it.

• 訳文:

  track-by="$index" は2つの状況で使用を回避してください。繰り返されたブロックにリストを再描画するために使用することができる form の input を含んでいるとき、または、繰り返されるデータがそれに割り当てられる他に、可変な状態でをコンポーネントを繰り返しているときです。

単語の統一 (特に技術用語)

• 技術用語は基本英語、ただ日本語で一般的に使われている場合は日本語 OK !!
  • 例: 英語の filter 、日本語のフィルタ
• 和訳に困った、とりあえず英語
  • 例: expression -> 式、表現
• 和訳にして分かりづらい場合は、翻訳と英語(どちらかに括弧付け)でも OK
  • 例: Two way -> Two way (双方向)

今回の Vue 2.0 の翻訳における注意事項

• 担当する翻訳作業はセクション単位です
• 翻訳は 1 つだけでなく複数翻訳しても OK です (むしろ助かります！:bow:)
• 翻訳作業のアサイン順位は、issue 内に宣言したコメントの先着順です
• 翻訳作業を開始する際は、なるべく lang-ja-2.0 の最新をものを使用してください。lang-ja-2.0 は随時本家の最新内容を取り入れており、翻訳漏れが少なくなります
• 翻訳作業中に発生した本家(vuejs/vuejs.org)との差分が発生している場合は考慮しなくて OK です (もし、差分内容も入れてもらえると @kazupon が泣いて喜びます 😹)
• 翻訳の締切は OSS なので特に設けませんが、作業開始してレビュー完了まで含めてだいだい 1 ヶ月以内ぐらいを目処に進めて頂けると助かります 🙇
• 翻訳作業中に翻訳について不明点がある場合は、自分が翻訳宣言した issue にコメントお願いします 💬