From bb841e4d65fa1910b302a84ce0ad9ae80430ff03 Mon Sep 17 00:00:00 2001 From: Shunsuke Kimura Date: Tue, 29 Apr 2025 10:55:41 +0000 Subject: [PATCH 1/6] Add: translation of syntax Signed-off-by: Shunsuke Kimura --- docs/reference/language/syntax.md | 61 +++++++++++++++---------------- 1 file changed, 30 insertions(+), 31 deletions(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index f62d712e19..2b10af04f4 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -23,7 +23,6 @@ Typst文書では、マークアップモードがデフォルトであり、数 | 数式 | 式を`[$..$]`で囲む | `[$-x$ is the opposite of $x$]` | | マークアップ | マークアップを`[[..]]`で囲む | `{let name = [*Typst!*]}` | - 一度`#`でコードモードに入ると、途中でマークアップモードや数式モードに切り替えない限り、さらにハッシュを使う必要はありません。 ## マークアップ { #markup } @@ -171,47 +170,47 @@ I got an ice cream for ``` ## パス { #paths } -Typst has various features that require a file path to reference external -resources such as images, Typst files, or data files. Paths are represented as -[strings]($str). There are two kinds of paths: Relative and absolute. -- A **relative path** searches from the location of the Typst file where the - feature is invoked. It is the default: +Typstは、画像、Typstファイル、データファイルなどの他ファイル（リソース）を参照するためにファイルパスを必要とするさまざまな機能を持ちます。 +パスは[文字列]($str)で指定して、相対パスと絶対パスの2種類あります。 + +- **相対パス**は、その関数を使用するTypstファイルの場所からの場所を指定します。デフォルトではこれです。 + ```typ #image("images/logo.png") ``` -- An **absolute path** searches from the _root_ of the project. It starts with a - leading `/`: +- **絶対パス**はプロジェクトの _ルート_ から指定します。先頭を`/`から始めます。 + ```typ #image("/assets/logo.png") ``` -### Project root -By default, the project root is the parent directory of the main Typst file. -For security reasons, you cannot read any files outside of the root directory. +### プロジェクトルート + +デフォルトでは、プロジェクトのルートディレクトリはメインのTypstファイルの親ディレクトリです。 +セキュリティ上の理由により、ルートディレクトリの外にあるファイルは読み取れません。 + +プロジェクトのルートとして特定のフォルダーを設定したい場合は、CLIの`--root`フラグを使用できます。 +メインファイルがそのフォルダーのサブディレクトリ内に含まれていることを確認してください。 -If you want to set a specific folder as the root of your project, you can use -the CLI's `--root` flag. Make sure that the main file is contained in the -folder's subtree! ```bash typst compile --root .. file.typ ``` -In the web app, the project itself is the root directory. You can always read -all files within it, no matter which one is previewed (via the eye toggle next -to each Typst file in the file panel). - -### Paths and packages -A package can only load files from its own directory. Within it, absolute paths -point to the package root, rather than the project root. For this reason, it -cannot directly load files from the project directory. If a package needs -resources from the project (such as a logo image), you must pass the already -loaded image, e.g. as a named parameter `{logo: image("mylogo.svg")}`. Note that -you can then still customize the image's appearance with a set rule within the -package. - -In the future, paths might become a -[distinct type from strings](https://github.com/typst/typst/issues/971), so that -they can retain knowledge of where they were constructed. This way, resources -could be loaded from a different root. +Webアプリでは、プロジェクト自体がルートディレクトリとして扱われます。 +どのファイルをプレビューしていても（プレビューはファイルパネル内の各Typstファイルの横にある目のアイコンで切り替え可能）、 +その中にあるすべてのファイルを常に読み取れます。 + +### パスとパッケージ + +パッケージは、それ自身のディレクトリ内にあるファイルしか読み込むことができません。 +その中では、絶対パスはプロジェクトのルートディレクトリではなく、パッケージのルートを指します。 +このため、パッケージはプロジェクトディレクトリ内のファイルを直接読み込むことができません。 +パッケージがプロジェクトのリソース（たとえばロゴ画像など）を必要とする場合は、 +あらかじめ読み込んだ画像を`{logo: image("mylogo.svg")}`のように名前付きパラメーターとして渡す必要があります。 +その後でも、パッケージ内でルールを設定することで画像の見た目をカスタマイズすることは可能です。 + +将来的には、パスが[文字列とは異なる独立した型](https://github.com/typst/typst/issues/971)になるかもしれません。 +そうすることで、そのパスがどこで生成されたかという情報が保持できるようになります。 +これにより、異なるルートからリソースを読み込むことも可能になるでしょう。 From 27c18ed052edaa90c8bf2f415212863bb57f72d1 Mon Sep 17 00:00:00 2001 From: Shunsuke Kimura Date: Tue, 29 Apr 2025 12:34:25 +0000 Subject: [PATCH 2/6] Update: translation of syntax Signed-off-by: Shunsuke Kimura --- docs/reference/language/syntax.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index 2b10af04f4..3e681434b6 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -171,16 +171,16 @@ I got an ice cream for ## パス { #paths } -Typstは、画像、Typstファイル、データファイルなどの他ファイル（リソース）を参照するためにファイルパスを必要とするさまざまな機能を持ちます。 -パスは[文字列]($str)で指定して、相対パスと絶対パスの2種類あります。 +Typstは、画像、Typstファイル、データファイルなどのリソース（他ファイル）を参照するためにファイルパスを必要とするさまざまな機能を持ちます。 +パスは[文字列型]($str)で指定するものあり、相対パスと絶対パスの2種類あります。 -- **相対パス**は、その関数を使用するTypstファイルの場所からの場所を指定します。デフォルトではこれです。 +- **相対パス**は、その機能を呼び出すTypstファイルの場所からのパスを指定します。デフォルトはこれです。 ```typ #image("images/logo.png") ``` -- **絶対パス**はプロジェクトの _ルート_ から指定します。先頭を`/`から始めます。 +- **絶対パス**はプロジェクトの _ルートディレクトリ_ からのパスを指定します。先頭を`/`から始めます。 ```typ #image("/assets/logo.png") @@ -191,8 +191,8 @@ Typstは、画像、Typstファイル、データファイルなどの他ファ デフォルトでは、プロジェクトのルートディレクトリはメインのTypstファイルの親ディレクトリです。 セキュリティ上の理由により、ルートディレクトリの外にあるファイルは読み取れません。 -プロジェクトのルートとして特定のフォルダーを設定したい場合は、CLIの`--root`フラグを使用できます。 -メインファイルがそのフォルダーのサブディレクトリ内に含まれていることを確認してください。 +プロジェクトのルートディレクトリとして特定のフォルダーを設定したい場合は、CLIの`--root`フラグを使用できます。 +対象のファイルがそのフォルダーのサブディレクトリ内に含まれていることを確認してください。 ```bash typst compile --root .. file.typ @@ -205,12 +205,12 @@ Webアプリでは、プロジェクト自体がルートディレクトリと ### パスとパッケージ パッケージは、それ自身のディレクトリ内にあるファイルしか読み込むことができません。 -その中では、絶対パスはプロジェクトのルートディレクトリではなく、パッケージのルートを指します。 +その中では、絶対パスはプロジェクトのルートディレクトリではなく、パッケージのルートディレクトリを指します。 このため、パッケージはプロジェクトディレクトリ内のファイルを直接読み込むことができません。 パッケージがプロジェクトのリソース（たとえばロゴ画像など）を必要とする場合は、 あらかじめ読み込んだ画像を`{logo: image("mylogo.svg")}`のように名前付きパラメーターとして渡す必要があります。 -その後でも、パッケージ内でルールを設定することで画像の見た目をカスタマイズすることは可能です。 +その後でも、パッケージ内でsetルールを記述することで画像の見た目をカスタマイズも可能です。 -将来的には、パスが[文字列とは異なる独立した型](https://github.com/typst/typst/issues/971)になるかもしれません。 +将来的には、パスが[文字列とは異なるパス専用の型](https://github.com/typst/typst/issues/971)になるかもしれません。 そうすることで、そのパスがどこで生成されたかという情報が保持できるようになります。 これにより、異なるルートからリソースを読み込むことも可能になるでしょう。 From 9d11bf5118e9a97c4fc7aa31ed6fd6b7faca709f Mon Sep 17 00:00:00 2001 From: Shunsuke KIMURA Date: Fri, 2 May 2025 04:32:29 +0900 Subject: [PATCH 3/6] Update docs/reference/language/syntax.md Co-authored-by: 3w36zj6 <52315048+3w36zj6@users.noreply.github.com> --- docs/reference/language/syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index 3e681434b6..b5e0b95164 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -172,7 +172,7 @@ I got an ice cream for ## パス { #paths } Typstは、画像、Typstファイル、データファイルなどのリソース（他ファイル）を参照するためにファイルパスを必要とするさまざまな機能を持ちます。 -パスは[文字列型]($str)で指定するものあり、相対パスと絶対パスの2種類あります。 +パスは[文字列型]($str)で指定し、相対パスと絶対パスの2種類があります。 - **相対パス**は、その機能を呼び出すTypstファイルの場所からのパスを指定します。デフォルトはこれです。 From 93060048637518b85548e83ecc35655e436a4562 Mon Sep 17 00:00:00 2001 From: Shunsuke KIMURA Date: Fri, 2 May 2025 04:32:45 +0900 Subject: [PATCH 4/6] Update docs/reference/language/syntax.md Co-authored-by: 3w36zj6 <52315048+3w36zj6@users.noreply.github.com> --- docs/reference/language/syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index b5e0b95164..a4099f27b0 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -209,7 +209,7 @@ Webアプリでは、プロジェクト自体がルートディレクトリと このため、パッケージはプロジェクトディレクトリ内のファイルを直接読み込むことができません。 パッケージがプロジェクトのリソース（たとえばロゴ画像など）を必要とする場合は、 あらかじめ読み込んだ画像を`{logo: image("mylogo.svg")}`のように名前付きパラメーターとして渡す必要があります。 -その後でも、パッケージ内でsetルールを記述することで画像の見た目をカスタマイズも可能です。 +その後でも、パッケージ内でsetルールを記述することで画像の見た目をカスタマイズすることも可能です。 将来的には、パスが[文字列とは異なるパス専用の型](https://github.com/typst/typst/issues/971)になるかもしれません。 そうすることで、そのパスがどこで生成されたかという情報が保持できるようになります。 From 2a42e57a3c42a8cb4f04fac598829abe0636e9ca Mon Sep 17 00:00:00 2001 From: Shunsuke KIMURA Date: Fri, 2 May 2025 04:32:53 +0900 Subject: [PATCH 5/6] Update docs/reference/language/syntax.md Co-authored-by: 3w36zj6 <52315048+3w36zj6@users.noreply.github.com> --- docs/reference/language/syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index a4099f27b0..a217ef4771 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -212,5 +212,5 @@ Webアプリでは、プロジェクト自体がルートディレクトリと その後でも、パッケージ内でsetルールを記述することで画像の見た目をカスタマイズすることも可能です。 将来的には、パスが[文字列とは異なるパス専用の型](https://github.com/typst/typst/issues/971)になるかもしれません。 -そうすることで、そのパスがどこで生成されたかという情報が保持できるようになります。 +そうすることで、そのパスがどこで生成されたかという情報を保持できるようになります。 これにより、異なるルートからリソースを読み込むことも可能になるでしょう。 From 902b2400b4426cd88919c3239b9511a76d485c95 Mon Sep 17 00:00:00 2001 From: Shunsuke Kimura Date: Thu, 1 May 2025 19:40:15 +0000 Subject: [PATCH 6/6] Update: translation of project root Signed-off-by: Shunsuke Kimura --- docs/reference/language/syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/language/syntax.md b/docs/reference/language/syntax.md index a217ef4771..fdc1792e28 100644 --- a/docs/reference/language/syntax.md +++ b/docs/reference/language/syntax.md @@ -186,7 +186,7 @@ Typstは、画像、Typstファイル、データファイルなどのリソー #image("/assets/logo.png") ``` -### プロジェクトルート +### プロジェクトのルートディレクトリ デフォルトでは、プロジェクトのルートディレクトリはメインのTypstファイルの親ディレクトリです。 セキュリティ上の理由により、ルートディレクトリの外にあるファイルは読み取れません。