Translate language extensions of playground examples into japanese #230
Conversation
|
|
sasurau4
changed the title
| const stringBadRequest = StatusCodes[400] | ||
|
|
||
| // Enumsに異なる型を設定することもできます。文字列型が一般的です。 | ||
| // 文字列型を用いると、runtimeで数字を探す必要がなくなるので、 |
There was a problem hiding this comment.
これは、どこまで英字表記 / カタカナ語を使うか、という話で正解があるわけではないのですが、個人的には runtime は 実行時 と日本語にしてしまってもいいのかなーと思います。
|
|
||
| // const enumの値は | ||
| // runtimeでobjectを介して対応する値を見つけるのではなく、 | ||
| // TypeScriptによるコードのトランスパイル時に置換されます。 |
There was a problem hiding this comment.
ここも上の話と近いです。 トランスパイル をカタカナで扱うのであれば、やはり runtimeで は 実行時に と訳したほうがスッキリするかな、と。
| // EnumsはTypeScriptを用いてJavaScriptで | ||
| // 固定値の集合を簡単に扱うための機能です。 | ||
|
|
||
| // デフォルトでは、enumは0から始まり |
There was a problem hiding this comment.
Enums と enum の二種類の表記が使われているのが少し気になりました。
原文で、複数形・単数形の種別、冒頭の大文字有無があったからなのかなぁ、と思うのですが、こういうケースってどうするのが適切なんでしょう。。。
enumで統一Enumで統一列挙型で統一
あたりなんでしょうか。。。他案件の翻訳でどうしてたか、とかあれば知りたいです。。。
There was a problem hiding this comment.
Gatsby の翻訳では基本的に以下のようなフォーマットでやっています。
- 固有名詞（Wordpressなど)は英語、大文字。
- コマンドの一部(
gatsby deployなど)はコマンドのまま。 - 一般的に英語で見る単語（完全にOpinionated ですが、Github の Issue など）は英語、大文字。
- それ以外の単語は適切な訳、またはカタカナ英語
Enum は TypeScript の言語機能の一部であり、他の言語でも Enum としてよく見られる印象（imo)なので、
Enum で統一が良いかなと思いました。
There was a problem hiding this comment.
const enumだけそのままで残して、他はEnumに統一しました
|
|
||
| // 文字列をValidatedInputString型に変換するために関数を使います。 | ||
| // 注目に値するのは、validateUserInputを通過した文字列はValidatedInputStringだと | ||
| // TypeScriptに__伝えて__いる点です。 |
There was a problem hiding this comment.
原文だと、 _telling_ なので、左右のアンダースコアは1ずつ？
There was a problem hiding this comment.
React の翻訳の時、日本語の文字は斜体でも強調が伝わりづらいと言う理由から、あえて太字にしてたりしましたね。
ただ、これは Markdown ではないので原文通りアンダースコア１つずつで良さそう。
| const bird3: BirdInterface = bird1 | ||
|
|
||
| // どちらも他のinterfacesやtypesからの拡張をサポートしています。 | ||
| // type aliasesは交差型を、 |
There was a problem hiding this comment.
ここも単数形と複数形の違いが少し気になりました。
（このファイルの冒頭では、 2つの主なツールがinterfacesとtype alias となっているので）
There was a problem hiding this comment.
これも主観に左右される話なので、あくまでIMOとして書きます。極力日本語 or カタカナ語に置き換えてしまって良いと思っています。
インタフェース or インターフェース
FYI: 以下の書籍では インタフェース となっていました
There was a problem hiding this comment.
コード中に使う言語機能に紐付いた単語は英語のままの方が読みやすいのでは？というIMOです
とはいえ、 @Quramy さんの言うことも分かるので、どっちかに統一してそっちに合わせたいところ
| NotFound, | ||
| } | ||
|
|
||
| // enumはEnumName.Valueで参照できます。 |
There was a problem hiding this comment.
[imo] Enumname.Valueで伝わるかが悩ましい、そういった予約語のように見えてしまう気がします。
| // enumはEnumName.Valueで参照できます。 | |
| // 各EnumはEnum名.値名で参照できます。 |
|
|
||
| const bird3: BirdInterface = bird1 | ||
|
|
||
| // どちらも他のinterfacesやtypesからの拡張をサポートしています。 |
There was a problem hiding this comment.
日本語では単数形で良さそう。
| // どちらも他のinterfacesやtypesからの拡張をサポートしています。 | |
| // どちらも他のinterfaceやtypeからの拡張をサポートしています。 |
| // そうは言っても、type aliasesよりもinterfacesを使うことをおすすめします。 | ||
| // 具体的には、より良いエラーメッセージが得られるからです。 | ||
| // 以下のエラーにマウスオーバーしてみると、 | ||
| // Chickenのようなinterfacesを使ったときの方が簡潔でより分かりやすいメッセージが |
There was a problem hiding this comment.
| // Chickenのようなinterfacesを使ったときの方が簡潔でより分かりやすいメッセージが | |
| // Chickenのようなinterfaceを使ったときの方が簡潔でより分かりやすいメッセージが |
| @@ -0,0 +1,83 @@ | |||
| // オブジェクトの形を宣言するのに使う | |||
| // 2つの主なツールがinterfacesとtype aliasです。 | |||
There was a problem hiding this comment.
日本語では単数形で良さそう。
| // 2つの主なツールがinterfacesとtype aliasです。 | |
| // 2つの主なツールがinterfaceとtype aliasです。 |
Overview
part of #100, #220
I translated Language Extensions playground-examples.
Screenshot