translate introduction.md into Japanese #3
Conversation
docs/introduction.md
Outdated
| --- | ||
|
|
||
| import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import constants from '@site/core/TabsConstants'; | ||
|
|
||
| <div className="content-banner"> | ||
| <p> | ||
| Welcome to the very start of your React Native journey! If you're looking for environment setup instructions, they've moved to <a href="environment-setup">their own section</a>. Continue reading for an introduction to the documentation, Native Components, React, and more! | ||
| React Nativeの旅のスタート地点へようこそ！環境構築手順を探している場合は、この<a href="environment-setup">ページ</a>へどうぞ。 |
There was a problem hiding this comment.
Welcome to the very start of your React Native journey! をうまく訳せなくて直訳っぽくなってしまいました。もっと良い訳があればコメントして欲しいです。
There was a problem hiding this comment.
これ難しいですね・・・！！
僕もちょっと訳してて難しい部分があります・・・。
もういっそのことこういうのは意訳で『React Nativeの最初の一歩へようこそ！』みたいな感じでいいのでは思っているんですが、どう思われます・・・？
There was a problem hiding this comment.
ちなみにReactのプロジェクトを参考にすると
Declarative views make your code more predictable and easier to debug.
これは直訳すると（めっちゃ固くしています）
『宣言的なviewはあなたのコードをより予測通りにし、デバックしやすくします』
なんですが、日本語版では
『宣言的な View を用いてアプリケーションを構築することで、コードはより見通しが立ちやすく、デバッグのしやすいものになります。』
になってて、結構意味を通すところに重きを置いている気がします。
英文から飛躍した意訳や表現の追加・改変を行わない。一方で分かりづらくなるような逐語訳もしない。
というのが、Reactの翻訳プロジェクトの方針みたいです。
僕らもこんな感じで方針を立てていった方がいいかもしれないですね・・！
There was a problem hiding this comment.
どこまで意訳するかのさじ加減難しいですね…！
gatsbyの翻訳プロジェクト( https://github.com/gatsbyjs/gatsby-ja/blob/master/style-guide.md )だと
原文がわかりにくかったり、タイポがあったとしても、基本的に原文に忠実に訳してください。
かつ
意訳を恐れず、日本語として自然な文章を心掛けましょう。
と書いてありました。Reactの方針とも似てそうですね。この辺 @Naturalclar がメンテナーだったので詳しいかも。
いずれにせよ、意訳の方針がはじめに定義してあると翻訳しやすそうですね！
There was a problem hiding this comment.
原文との分数が同じで、各文で意味が通っていれば意訳は問題無いと思っています。
「React Nativeの旅のスタート地点へようこそ！」の部分は @YutamaKotaro さんが言っているように 「React Nativeの最初の一歩へようこそ！」など、日本語としてわかりやすく書き換えてしまって問題無さそう！
There was a problem hiding this comment.
@YutamaKotaro @takahi5 @Naturalclar コメントありがとうございます！意訳の方針が明文化されていると、今後の翻訳がやりやすくなること間違い無いですね！修正してコミットしておきます！
|
|
||
| <Tabs groupId="guide" defaultValue="web" values={constants.getDevNotesTabs(["android", "ios", "web"])}> | ||
|
|
||
| <TabItem value="web"> | ||
|
|
||
| > Web developers may be familiar with this concept. | ||
| > Web 開発者にはおなじみのコンセプト |
There was a problem hiding this comment.
うまく訳せてないような気がします。より良い訳があったらコメントお願いします...！
docs/introduction.md
Outdated
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。ではさっそく、上の"Try editing me!"と書かれているテキストを"Hello, world!"に変更してみてください。 | |||
There was a problem hiding this comment.
「ではさっそく」は唐突感あるなと思ったので、「試しに」の方が表現柔らかいかも
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。ではさっそく、上の"Try editing me!"と書かれているテキストを"Hello, world!"に変更してみてください。 | |
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。 |
There was a problem hiding this comment.
@Naturalclar 諸々のコメントありがとうございます！修正しますね！
docs/introduction.md
Outdated
|
|
||
| > Optionally, if you want to setup a local development environment, [you can follow our guide to setting up your environment on your local machine](environment-setup) and paste the code examples into your `App.js` file there. (If you are a web developer, you may already have a local environment set up for mobile browser testing!) | ||
| > 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、モバイルブラウザのテスト用にローカル環境を設定しているかもしれません) |
There was a problem hiding this comment.
| > 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、モバイルブラウザのテスト用にローカル環境を設定しているかもしれません) | |
| > 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、すでにモバイルブラウザのテスト用にローカル環境を設定しているかもしれません。) |
docs/introduction.md
Outdated
|
|
||
| --- | ||
|
|
||
| Now that you know how this guide works, it's time to get to know the foundation of React Native: [Native Components](intro-react-native-components.md). | ||
| このガイドがどのように動作するのかわかったと思います。では次の[ネイティブコンポーネント](intro-react-native-components.md)で React Native の基礎を知ることにしましょう。 |
There was a problem hiding this comment.
[imo]若干上から目線ぽさを感じたので少し変えてみました。
| このガイドがどのように動作するのかわかったと思います。では次の[ネイティブコンポーネント](intro-react-native-components.md)で React Native の基礎を知ることにしましょう。 | |
| このガイドの読み方について紹介したところで、次は React Native の基礎である、[ネイティブコンポーネント](intro-react-native-components.md)について学びましょう。 |
|
レビューでもらったコメントの修正をしました！ |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
docs/introduction.md
Outdated
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。 | |||
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/sentence-length> reported by reviewdog 🐶
Line 50 sentence length(102) exceeds the maximum sentence length of 100.
Over 2 characters. (ja-technical-writing/sentence-length)
docs/introduction.md
Outdated
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。 | |||
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/ja-no-redundant-expression> reported by reviewdog 🐶
【dict2】 "することができます"は冗長な表現です。"することが"を省き簡潔な表現にすると文章が明瞭になります。
解説: https://github.com/textlint-ja/textlint-rule-ja-no-redundant-expression#dict2 (ja-technical-writing/ja-no-redundant-expression)
docs/introduction.md
Outdated
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。 | |||
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/no-exclamation-question-mark> reported by reviewdog 🐶
Disallow to use "!". (ja-technical-writing/no-exclamation-question-mark)
docs/introduction.md
Outdated
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。 | |||
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/no-exclamation-question-mark> reported by reviewdog 🐶
Disallow to use "!". (ja-technical-writing/no-exclamation-question-mark)
docs/introduction.md
Outdated
|
|
||
| > Optionally, if you want to setup a local development environment, [you can follow our guide to setting up your environment on your local machine](environment-setup) and paste the code examples into your `App.js` file there. (If you are a web developer, you may already have a local environment set up for mobile browser testing!) | ||
| > 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、すでにモバイルブラウザのテスト用にローカル環境を設定しているかもしれません。) |
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/ja-no-weak-phrase> reported by reviewdog 🐶
弱い表現: "かも" が使われています。 (ja-technical-writing/ja-no-weak-phrase)
docs/introduction.md
Outdated
|
|
||
| With React, you can make components using either classes or functions. Originally, class components were the only components that could have state. But since the introduction of React's Hooks API, you can add state and more to function components. | ||
| React では、クラスか関数のどちらかを使ってコンポーネントを作ることができます。元々、ステートを持てるのはクラスコンポーネントだけでした。しかし、React のフック API が導入されてからは、関数コンポーネントにステートなどを追加することができるようになりました。 |
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/ja-no-redundant-expression> reported by reviewdog 🐶
【dict2】 "することができるよう"は冗長な表現です。"することが"を省き簡潔な表現にすると文章が明瞭になります。
解説: https://github.com/textlint-ja/textlint-rule-ja-no-redundant-expression#dict2 (ja-technical-writing/ja-no-redundant-expression)
docs/introduction.md
Outdated
|
|
||
| People from many different development backgrounds are learning React Native. You may have experience with a range of technologies, from web to Android to iOS and more. We try to write for developers from all backgrounds. Sometimes we provide explanations specific to one platform or another like so: | ||
| 様々な開発背景を持つ人が React Native を学んでいます。Web、Android、iOS など、様々な技術を経験している方もいるかもしれません。私たちは、あらゆるバックグラウンドを持つ開発者のために書くようにしています。時には、このように 1 つのプラットフォームに特化した説明を、それぞれ以下のように提供することもあります。 |
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/ja-no-weak-phrase> reported by reviewdog 🐶
弱い表現: "かも" が使われています。 (ja-technical-writing/ja-no-weak-phrase)
docs/introduction.md
Outdated
|
|
||
| People from many different development backgrounds are learning React Native. You may have experience with a range of technologies, from web to Android to iOS and more. We try to write for developers from all backgrounds. Sometimes we provide explanations specific to one platform or another like so: | ||
| 様々な開発背景を持つ人が React Native を学んでいます。Web、Android、iOS など、様々な技術を経験している方もいるかもしれません。私たちは、あらゆるバックグラウンドを持つ開発者のために書くようにしています。時には、このように 1 つのプラットフォームに特化した説明を、それぞれ以下のように提供することもあります。 |
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/no-doubled-joshi> reported by reviewdog 🐶
一文に二回以上利用されている助詞 "に" がみつかりました。 (ja-technical-writing/no-doubled-joshi)
| @@ -46,15 +47,15 @@ const YourApp = () => { | |||
| export default YourApp; | |||
| ``` | |||
|
|
|||
| The above is a Snack Player. It’s a handy tool created by Expo to embed and run React Native projects and share how they render in platforms like Android and iOS. The code is live and editable, so you can play directly with it in your browser. Go ahead and try changing the "Try editing me!" text above to "Hello, world!" | |||
| 上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正できます。試しに、上の "Try editing me" と書かれているテキストを "Hello, world" に変更してみてください。 | |||
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/sentence-length> reported by reviewdog 🐶
Line 50 sentence length(102) exceeds the maximum sentence length of 100.
Over 2 characters. (ja-technical-writing/sentence-length)
There was a problem hiding this comment.
基本的に改行は原文に合わせたいのでこのlint rule は消したいな
There was a problem hiding this comment.
これはもう消えているはずなので、しょーけんさんが取り込んでいただければ大丈夫ですー！！
@shoken0x お願いしますーー
|
|
||
| People from many different development backgrounds are learning React Native. You may have experience with a range of technologies, from web to Android to iOS and more. We try to write for developers from all backgrounds. Sometimes we provide explanations specific to one platform or another like so: | ||
| 様々な開発背景を持つ人が React Native を学んでいます。Web、Android、iOS など、様々な技術を経験している方もいるでしょう。私たちは、あらゆるバックグラウンドを持つ開発者のために書くようにしています。時には、このように 1 つのプラットフォームに特化した説明を、それぞれ以下のように提供することもあります。 |
There was a problem hiding this comment.
🚫 [checkstyle] <eslint.rules.ja-technical-writing/no-doubled-joshi> reported by reviewdog 🐶
一文に二回以上利用されている助詞 "に" がみつかりました。 (ja-technical-writing/no-doubled-joshi)
introduction.md を翻訳しました。最初のたたき台として、気になる点はコメントしてくださいー！
オリジナルページ : https://reactnative.dev/docs/next/getting-started
ローカルでの動作確認ページ : http://localhost:3000/docs/next/getting-started
取り組んでわかったこと
このページで気になった単語
Hooksにしました。関数コンポーネントとしました。ネイティブコンポーネントとスペースなしにしました。ステートにしました。