Translate Leaf to Japanese #1005

KaitoMuraoka · 2024-09-01T07:58:15Z

Leaf content translated into Japanese

getting-started.md
overview.md
custom-tags.md

lemo-nade-room · 2024-09-01T10:49:59Z

docs/leaf/getting-started.ja.md

@@ -0,0 +1,95 @@
+# Leaf
+
+Leaf は、Swift にインスパイアされた構文を持つ強力なテンプレート言語です。これを使って、フロントエンドのウェブサイト向けに動的な HTML ページを生成したり、API から送信するリッチなメールを生成したりできます。


~~テンプレート言語よりテンプレート構文の方がニュアンス的に近いのではないかと思いました~~

~~参考: https://ja.vuejs.org/guide/essentials/template-syntax~~

Template Syntaxがあるので、Template Languageと混合しないためにはテンプレート言語の方が良さそうですね

lemo-nade-room · 2024-09-01T10:54:18Z

docs/leaf/getting-started.ja.md

+    Leaf には、ページをレンダリングするための内部キャッシュがあります。`Application` の環境が `.development` に設定されている場合、このキャッシュは無効になり、テンプレートへの変更が即座に反映されます。`.production` やその他の環境では、キャッシュがデフォルトで有効になっており、テンプレートに加えた変更はアプリケーションを再起動するまで反映されません。
+
+!!! warning 
+    Xcode から実行する際に Leaf がテンプレートを見つけられるようにするためには、 Xcode ワークスペースの [custom working directory](../getting-started/xcode.md#custom-working-directory) を設定する必要があります。


リンク先のid指定がずれていました。以下のものが正しいと思います

../getting-started/xcode/#_1

リンクがずれている場合、原文を修正した方が良いともうのですが、どうでしょうか？

https://github.com/vapor/docs/blob/b6846b8ac25f6957e1d50ae24d70537f4d86643b/docs/leaf/getting-started.md?plain=1#L48C116-L48C168

あ、いえ、日本語に飛ぼうとするのですが、見出しを日本語で書いちゃうとidに反映されなくてURLが変わってしまうので原文は大丈夫だと思います

# Custom Working Directory // → id="custom-working-directory"が属性としてつくため大丈夫

# カスタムワーキングディレクトリ // → idが連番で id="_1"がついてしまうのでURLが変わる

このリンクの方を合わせるか、日本語時の見出しを英語にするかにすると合うと思います！

@KaitoMuraoka こちら確認していただきたいです！

修正しました！：674c164

.md は必要みたいでした
#1005 (comment)

../getting-started/xcode.md/#_1

すみません、ありがとうございます

lemo-nade-room · 2024-09-01T10:55:35Z

docs/leaf/getting-started.ja.md

+    Xcode から実行する際に Leaf がテンプレートを見つけられるようにするためには、 Xcode ワークスペースの [custom working directory](../getting-started/xcode.md#custom-working-directory) を設定する必要があります。
+## フォルダ構成
+
+Leaf を設定したら、`.leaf` ファイルを格納するための `Views` フォルダを用紙する必要があります。デフォルトでは、Leaf はプロジェクトのルートに対して `./Resources/Views` というフォルダを期待します。


用紙、タイポと思われます

（どちらでも構わないものですが）
期待しますより要求しますの方がニュアンス的に近い気がしました

lemo-nade-room · 2024-09-01T11:00:05Z

docs/leaf/getting-started.ja.md

+
+Leaf を設定したら、`.leaf` ファイルを格納するための `Views` フォルダを用紙する必要があります。デフォルトでは、Leaf はプロジェクトのルートに対して `./Resources/Views` というフォルダを期待します。
+
+JavaScript や CSS ファイルを提供する予定がある場合は、Vapor の [`FileMiddleware`](https://api.vapor.codes/vapor/documentation/vapor/filemiddleware) を有効にして、 `/Public` フォルダからファイルを提供できるようにすることをお勧めします。


（どちらでも構わないですが )
英語の方で、提供することも可能ですとありますが、おすすめとは書いていないように感じました。

「フォルダからファイルを提供できるようにすることも可能です。」に変更します

lemo-nade-room · 2024-09-01T11:01:57Z

docs/leaf/getting-started.ja.md

+```
+
+!!! tip
+    もし、コードエディタとして VSCode を使用している場合、シンタックスハイライトを有効にするために、Leaf 拡張機能をインストールすることをお勧めします：Leaf HTML](https://marketplace.visualstudio.com/items?itemName=Francisco.html-leaf)


Leave HTML]となっていて、[が抜けていました。

lemo-nade-room · 2024-09-01T11:48:14Z

docs/leaf/custom-tags.ja.md

+- `parameters`: タグのパラメータを含む配列です
+- `data`: コンテキストとして `render(_:_:)` に渡されたビューのデータを含む辞書です
+
+### サンプルの Hello タグ


Helloタグによる実例とかの方がしっくりくる気がします。英語そのままでもいいかもです

lemo-nade-room · 2024-09-01T11:49:13Z

docs/leaf/custom-tags.ja.md

+
+### サンプルの Hello タグ
+
+これを理解するために、両方のプロパティを使ったシンプルな hello タグを実装してみましょう。


lemo-nade-room · 2024-09-01T11:52:17Z

docs/leaf/custom-tags.ja.md

+
+#### パラメータの使用
+
+最初のパラメータに名前が含まれていることを想定しています。


少しニュアンスが違うような気がしました。

直訳で名前を含む最初のパラメータにアクセスできます。
整えるとnameの値が提供される、1つ目のパラメータにアクセスできます
な気がします

lemo-nade-room · 2024-09-01T11:54:11Z

docs/leaf/custom-tags.ja.md

+#### データの使用
+
+データプロパティの中の "name" キーを使って名前の値にアクセスします。


dataがプロパティ名なのでそのままdataと英語表記の方がわかりやすいかもです

lemo-nade-room · 2024-09-01T11:55:13Z

docs/leaf/custom-tags.ja.md

+
+これを理解するために、両方のプロパティを使ったシンプルな hello タグを実装してみましょう。
+
+#### パラメータの使用


parametersがプロパティ名なのでそのままparametersと英語表記の方がわかりやすいかもです

KaitoMuraoka · 2024-09-01T13:29:45Z

@lemo-nade-room
I fixed docs and replied to your comment.

lemo-nade-room · 2024-09-01T13:49:10Z

docs/leaf/custom-tags.ja.md

@@ -100,7 +99,7 @@ struct HelloTag: UnsafeUnescapedLeafTag {

 #### データの使用


こちらもdataの方がいいかと思われます！

DONE! : 820ab00

データの使用-> data の使用

lemo-nade-room

I approved this Pull request.

0xTim · 2024-09-06T16:08:42Z

@KaitoMuraoka thanks for this! There's one broken link in the new page - as soon as that's fixed we can merge. Are you able to take a look?

KaitoMuraoka · 2024-09-09T05:54:38Z

@0xTim
Fix DONE! 🚀

KaitoMuraoka added 3 commits August 31, 2024 23:37

Translated getting-started in Japanese

b7311dd

Translated overview in Japanese

ae66e50

Translated custom-tags in Japanese

6d616f5

KaitoMuraoka requested a review from a team as a code owner September 1, 2024 07:58

lemo-nade-room suggested changes Sep 1, 2024

View reviewed changes

KaitoMuraoka added 3 commits September 1, 2024 22:13

review fix getting-started.ja.md

e9d7a60

review fix overview.ja.md

2844462

review fix custom-tags.ja.md

293824c

lemo-nade-room reviewed Sep 1, 2024

View reviewed changes

KaitoMuraoka added 3 commits September 4, 2024 10:20

review-fix Replace katakana with alphabets

820ab00

データの使用-> data の使用

review-fix link id

674c164

review-fix: Link was incorrect

b33141d

lemo-nade-room approved these changes Sep 6, 2024

View reviewed changes

0xTim enabled auto-merge (squash) September 6, 2024 15:56

Merge branch 'main' into feature/leaf-getting-started-translation

2bcc80b

0xTim added the translation-update This PR contains translations for the docs label Sep 6, 2024

review-fix broken link

862d3ba

auto-merge was automatically disabled September 9, 2024 05:49
Head branch was pushed to by a user without write access

Merge branch 'main' into feature/leaf-getting-started-translation

eb1634f

0xTim approved these changes Sep 9, 2024

View reviewed changes

0xTim merged commit 6f6b907 into vapor:main Sep 9, 2024
1 check passed

KaitoMuraoka deleted the feature/leaf-getting-started-translation branch September 9, 2024 10:14

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate Leaf to Japanese #1005

Translate Leaf to Japanese #1005

KaitoMuraoka commented Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024 •

edited

Loading

KaitoMuraoka Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 4, 2024

KaitoMuraoka Sep 5, 2024

KaitoMuraoka Sep 9, 2024

lemo-nade-room Sep 9, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024 •

edited

Loading

lemo-nade-room Sep 1, 2024

KaitoMuraoka Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024

lemo-nade-room Sep 1, 2024

KaitoMuraoka commented Sep 1, 2024

lemo-nade-room Sep 1, 2024

KaitoMuraoka Sep 4, 2024

lemo-nade-room left a comment

0xTim commented Sep 6, 2024

KaitoMuraoka commented Sep 9, 2024

		@@ -0,0 +1,95 @@
		# Leaf

		Leaf は、Swift にインスパイアされた構文を持つ強力なテンプレート言語です。これを使って、フロントエンドのウェブサイト向けに動的な HTML ページを生成したり、API から送信するリッチなメールを生成したりできます。


		Leaf を設定したら、`.leaf` ファイルを格納するための `Views` フォルダを用紙する必要があります。デフォルトでは、Leaf はプロジェクトのルートに対して `./Resources/Views` というフォルダを期待します。

		JavaScript や CSS ファイルを提供する予定がある場合は、Vapor の [`FileMiddleware`](https://api.vapor.codes/vapor/documentation/vapor/filemiddleware) を有効にして、 `/Public` フォルダからファイルを提供できるようにすることをお勧めします。


		### サンプルの Hello タグ

		これを理解するために、両方のプロパティを使ったシンプルな hello タグを実装してみましょう。


		#### パラメータの使用

		最初のパラメータに名前が含まれていることを想定しています。

		#### データの使用

		データプロパティの中の "name" キーを使って名前の値にアクセスします。

		@@ -100,7 +99,7 @@ struct HelloTag: UnsafeUnescapedLeafTag {

		#### データの使用

Translate Leaf to Japanese #1005

Translate Leaf to Japanese #1005

Conversation

KaitoMuraoka commented Sep 1, 2024

Choose a reason for hiding this comment

lemo-nade-room Sep 1, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lemo-nade-room Sep 1, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

KaitoMuraoka commented Sep 1, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lemo-nade-room left a comment

Choose a reason for hiding this comment

0xTim commented Sep 6, 2024

KaitoMuraoka commented Sep 9, 2024

lemo-nade-room Sep 1, 2024 •

edited

Loading

lemo-nade-room Sep 1, 2024 •

edited

Loading