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

translate introduction.md into Japanese #3

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 26 additions & 25 deletions docs/introduction.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,34 @@
---
id: getting-started
title: Introduction
description: This helpful guide lays out the prerequisites for learning React Native, using these docs, and setting up your environment.
title: イントロダクション
description: このガイドは、React Nativeの学習やこのドキュメントの使い方、環境セットアップを行うための前提条件を提示します。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved
---

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>へどうぞ。
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welcome to the very start of your React Native journey! をうまく訳せなくて直訳っぽくなってしまいました。もっと良い訳があればコメントして欲しいです。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

これ難しいですね・・・!!
僕もちょっと訳してて難しい部分があります・・・。

もういっそのことこういうのは意訳で『React Nativeの最初の一歩へようこそ!』みたいな感じでいいのでは思っているんですが、どう思われます・・・?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ちなみにReactのプロジェクトを参考にすると

Declarative views make your code more predictable and easier to debug.

これは直訳すると(めっちゃ固くしています)
『宣言的なviewはあなたのコードをより予測通りにし、デバックしやすくします』
なんですが、日本語版では
『宣言的な View を用いてアプリケーションを構築することで、コードはより見通しが立ちやすく、デバッグのしやすいものになります。』
になってて、結構意味を通すところに重きを置いている気がします。

英文から飛躍した意訳や表現の追加・改変を行わない。一方で分かりづらくなるような逐語訳もしない。

というのが、Reactの翻訳プロジェクトの方針みたいです。
僕らもこんな感じで方針を立てていった方がいいかもしれないですね・・!

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

どこまで意訳するかのさじ加減難しいですね…!

gatsbyの翻訳プロジェクト( https://github.com/gatsbyjs/gatsby-ja/blob/master/style-guide.md )だと

原文がわかりにくかったり、タイポがあったとしても、基本的に原文に忠実に訳してください。

かつ

意訳を恐れず、日本語として自然な文章を心掛けましょう。

と書いてありました。Reactの方針とも似てそうですね。この辺 @Naturalclar がメンテナーだったので詳しいかも。

いずれにせよ、意訳の方針がはじめに定義してあると翻訳しやすそうですね!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

原文との分数が同じで、各文で意味が通っていれば意訳は問題無いと思っています。
「React Nativeの旅のスタート地点へようこそ!」の部分は @YutamaKotaro さんが言っているように 「React Nativeの最初の一歩へようこそ!」など、日本語としてわかりやすく書き換えてしまって問題無さそう!

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@YutamaKotaro @takahi5 @Naturalclar コメントありがとうございます!意訳の方針が明文化されていると、今後の翻訳がやりやすくなること間違い無いですね!修正してコミットしておきます!

このページにはドキュメント、ネイティブコンポーネント、Reactなどの紹介がありますので、読み進めてみてください。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved
</p>
<img className="content-banner-img" src="/docs/assets/p_android-ios-devices.svg" alt=" " />
</div>

Many different kinds of people use React Native: from advanced iOS developers to React beginners, to people getting started programming for the first time in their career. These docs were written for all learners, no matter their experience level or background.
多くの人が使う React Native : 熟練 iOS エンジニアから React 初心者、プログラミングを始めたての人まで、様々な人が React Native を使っています。このドキュメントは、経験レベルやバックグラウンドに関係なく、すべての学習者のために書かれています。

## How to use these docs
## ドキュメントの使い方

You can start here and read through these docs linearly like a book; or you can read the specific sections you need. Already familiar with React? You can skip [that section](intro-react)—or read it for a light refresher.
このページから始めて、ドキュメント全体を本のように読み進めることができます。もしすでに React に慣れているのであれば、[React の紹介](intro-react) はスキップしても良いですし、軽く復習するために読んでも良いです。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved

## Prerequisites
## 前提条件

To work with React Native, you will need to have an understanding of JavaScript fundamentals. If you’re new to JavaScript or need a refresher, you can [dive in](https://developer.mozilla.org/en-US/docs/Web/JavaScript) or [brush up](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript) at Mozilla Developer Network.
React Native を使うためには、JavaScript の基礎を理解している必要があります。JavaScript が初めての方や再学習が必要な方は、Mozilla Developer Network の [JavaScript](https://developer.mozilla.org/ja/docs/Web/JavaScript) や [JavaScript 「再」入門](https://developer.mozilla.org/ja/docs/Web/JavaScript/A_re-introduction_to_JavaScript) などを参照してください。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved

> While we do our best to assume no prior knowledge of React, Android, or iOS development, these are valuable topics of study for the aspiring React Native developer. Where sensible, we have linked to resources and articles that go more in depth.
> React, Android, iOS 開発の予備知識がないことを前提にしていますが、React Native 開発者を目指す方にとっては貴重な勉強になるトピックです。必要に応じて、より深く掘り下げたリソースや記事にリンクしています。

## Interactive examples
## インタラクティブな例

This introduction lets you get started immediately in your browser with interactive examples like this one:
この紹介ページでは、下のようなインタラクティブな例を使って、すぐにブラウザからコードを触り始めることができるようにしています。

```SnackPlayer name=Hello%20World
import React from 'react';
Expand All @@ -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!"に変更してみてください。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「ではさっそく」は唐突感あるなと思ったので、「試しに」の方が表現柔らかいかも

Suggested change
上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。ではさっそく、上の"Try editing me!"と書かれているテキストを"Hello, world!"に変更してみてください。
上記は Snack Player です。これは Expo が作成した、React Native プロジェクトを埋め込んで実行し、Android や iOS などのプラットフォームでどのようにレンダリングされるかを共有するための便利なツールです。コードはライブで反映されるので、ブラウザで直接修正することができます。試しに、上の "Try editing me!" と書かれているテキストを "Hello, world!" に変更してみてください。

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Naturalclar 諸々のコメントありがとうございます!修正しますね!


> 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` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、モバイルブラウザのテスト用にローカル環境を設定しているかもしれません)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、モバイルブラウザのテスト用にローカル環境を設定しているかもしれません)
> 必要に応じて、ローカルの開発環境を設定したい場合は、[ローカルマシン上での環境設定ガイド](environment-setup)を参照して、`App.js` ファイルにコード例を貼り付けてください。(あなたがウェブ開発者であれば、すでにモバイルブラウザのテスト用にローカル環境を設定しているかもしれません。)


## Function Components and Class Components
## 関数コンポーネントとクラスコンポーネント

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 では、クラスか関数のどちらかを使ってコンポーネントを作ることができます。元々、ステートを持てるのはクラスコンポーネントだけでした。しかし、ReactHooks API が導入されてからは、関数コンポーネントにステートなどを追加することができるようになりました。

[Hooks were introduced in React Native 0.59.](/blog/2019/03/12/releasing-react-native-059), and because Hooks are the future-facing way to write your React components, we wrote this introduction using function component examples. Where useful, we also cover class components under a toggle like so:
[Hooks React Native 0.59 で導入され](/blog/2019/03/12/releasing-react-native-059)、また未来を見据えた React コンポーネントの書き方なので、この紹介文は関数コンポーネントの例を使って書いています。リンクを切り換えることで、クラスコンポーネントでの書き方を見ることもできます。

<Tabs groupId="syntax" defaultValue={constants.defaultSyntax} values={constants.syntax}>
<TabItem value="functional">
Expand Down Expand Up @@ -105,35 +106,35 @@ export default HelloWorldApp;
</TabItem>
</Tabs>

You can find more examples of class components in [previous versions of this documentation](/versions).
クラスコンポーネントの例をもっと見たい場合は [過去バージョンのドキュメント](/versions)を参照してください。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved

## Developer Notes
## 開発者ノート

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、AndroidiOS など、様々な技術を経験している方もいるかもしれません。私たちは、あらゆるバックグラウンドを持つ開発者のために書くようにしています。時には、このように 1 つのプラットフォームに特化した説明を、それぞれ提供することもあります。
Naturalclar marked this conversation as resolved.
Show resolved Hide resolved

<Tabs groupId="guide" defaultValue="web" values={constants.getDevNotesTabs(["android", "ios", "web"])}>

<TabItem value="web">

> Web developers may be familiar with this concept.
> Web 開発者にはおなじみのコンセプト
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

うまく訳せてないような気がします。より良い訳があったらコメントお願いします...!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一旦問題ないと思います!


</TabItem>
<TabItem value="android">

> Android developers may be familiar with this concept.
> Android 開発者にはおなじみのコンセプト

</TabItem>
<TabItem value="ios">

> iOS developers may be familiar with this concept.
> iOS 開発者にはおなじみのコンセプト

</TabItem>
</Tabs>

## Formatting
## フォーマット

Menu paths are written in bold and use carets to navigate submenus. Example: **Android Studio > Preferences**
メニューパスは太字で書かれており、サブメニューをナビゲートするためにキャレットを使用します。例: **Android Studio > Preferences**

---

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 の基礎を知ることにしましょう。
Copy link
Member

@Naturalclar Naturalclar Feb 10, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[imo]若干上から目線ぽさを感じたので少し変えてみました。

Suggested change
このガイドがどのように動作するのかわかったと思います。では次の[ネイティブコンポーネント](intro-react-native-components.md)で React Native の基礎を知ることにしましょう
このガイドの読み方について紹介したところで、次は React Native の基礎である、[ネイティブコンポーネント](intro-react-native-components.md)について学びましょう