Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ Dockerコンテナー上に上記と同一の環境を構築して作業する
Visual Studio Codeにおける操作フロー例は以下の通りです。

1. Ctrl+Shift+Pを押してから`> Dev Containers: Reopen in Container`を実行します。
2. Webサーバーが起動したらブラウザで http://localhost:5173 にアクセスします。
2. Webサーバーが起動したらブラウザーで http://localhost:5173 にアクセスします。
3. 翻訳したファイルの変更を反映させるためにはCtrl+Shift+Bで再ビルドしてください。
4. 体裁を確認したい場合、Ctrl+Shift+Pを押してから`> Tasks: Run task`を実行し以下のいずれかを選択します。
- `textlint-html` : Rustソースコードを翻訳した場合
Expand Down
2 changes: 1 addition & 1 deletion crates/typst-library/src/model/document.rs
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ use crate::text::{Locale, TextElem};
#[elem(Construct)]
pub struct DocumentElem {
/// 文書のタイトル。
/// これはPDFビューアーのウィンドウタイトルやブラウザタブに表示されます
/// これはPDFビューアーのウィンドウタイトルやブラウザータブに表示されます
///
/// タイトルの設定はアクセシビリティ上重要であり、他の文書の中から識別しやすくなります。
/// PDF/UAへのエクスポート時にはタイトルが必須です。
Expand Down
2 changes: 1 addition & 1 deletion crates/typst-library/src/model/numbering.rs
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ pub fn numbering(
/// **プレフィックス**は、カウント記号でもサフィックスでもない文字列です。
/// それぞれのカウント記号の前に、そのままの形で繰り返し表示されます。
///
/// このパラメータには、数値を個別の引数として受け取る任意の関数も指定できます。
/// このパラメーターには、数値を個別の引数として受け取る任意の関数も指定できます。
/// 関数が与えられた場合、`numbering`関数はその引数をそのまま関数に渡します。
/// これ自体は特に便利というわけではありませんが、番号付けがパターン指定であっても関数指定であっても、番号付けの定義を`numbering`関数に適用できるという意味を持ちます。
numbering: Numbering,
Expand Down
4 changes: 2 additions & 2 deletions crates/typst-library/src/visualize/image/mod.rs
Original file line number Diff line number Diff line change
Expand Up @@ -143,9 +143,9 @@ pub struct ImageElem {
/// 視覚に障害のある利用者へ画像を説明するために使われます。
///
/// 画像が[`figure`]($figure)に包まれている場合は、
/// [図表の`alt`パラメータ]($figure.alt)ではなくこちらを使って説明してください。
/// [図表の`alt`パラメーター]($figure.alt)ではなくこちらを使って説明してください。
/// 例外は、画像と図表内の他要素が単一の意味単位を形成する場合です。
/// その場合は図表の`alt`で全体を説明し、このパラメータは使いません
/// その場合は図表の`alt`で全体を説明し、このパラメーターは使いません
///
/// 良い代替説明の書き方は
/// [アクセシビリティガイド]($guides/accessibility/#textual-representations)を参照してください。
Expand Down
2 changes: 1 addition & 1 deletion docs/tutorial/1-writing.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Typstでは、PNG、JPEG、GIF、SVG、PDF、WebPの形式の画像をサポー
ここにはプロジェクト内の全てのファイルのリストが表示されます。
現在、ここにあるのはあなたが書いているメインのTypstファイルだけです。
別のファイルをアップロードするには、右上隅の矢印のボタンをクリックします。
これによりアップロードダイアログが開き、コンピュータからアップロードするファイルを選択できます
これによりアップロードダイアログが開き、コンピューターからアップロードするファイルを選択できます
レポートに用いる画像ファイルを選んでください。

![Upload dialog](1-writing-upload.png)
Expand Down
8 changes: 4 additions & 4 deletions docs/tutorial/4-template.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,7 @@ You are #amazed[beautiful]!
I am #amazed(color: purple)[amazed]!
```

テンプレートは`amazed`のようなカスタム関数でドキュメント全体をラップすることで機能します。しかし、文書全体を巨大な関数呼び出しでラップするのは面倒でしょう!代わりに、「everything」showルールを使用して、より洗練されたコードで同じことを実現できます。そのようなshowルールを書くには、showキーワードの直後にコロンを置き、関数を提供します。この関数にはドキュメントの残りの部分がパラメータとして渡されます。関数はこのコンテンツに対して何でも行うことができます。`amazed`関数は単一のコンテンツ引数で呼び出せるので、showルールに名前で渡すだけで良いのです。試してみましょう。
テンプレートは`amazed`のようなカスタム関数でドキュメント全体をラップすることで機能します。しかし、文書全体を巨大な関数呼び出しでラップするのは面倒でしょう!代わりに、「everything」showルールを使用して、より洗練されたコードで同じことを実現できます。そのようなshowルールを書くには、showキーワードの直後にコロンを置き、関数を提供します。この関数にはドキュメントの残りの部分がパラメーターとして渡されます。関数はこのコンテンツに対して何でも行うことができます。`amazed`関数は単一のコンテンツ引数で呼び出せるので、showルールに名前で渡すだけで良いのです。試してみましょう。

```example
>>> #let amazed(term, color: blue) = {
Expand Down Expand Up @@ -257,7 +257,7 @@ It's going great so far!

2. さらに、コンテンツブロックの代わりに中括弧で囲まれたコードブロックを使用しました。この方法では、全てのsetルールや関数呼び出しの前に`#`を付ける必要がなくなります。代わりに、コードブロック内に直接マークアップを書くことはできなくなります。

また、タイトルがどこから来ているかに注目してください。以前は変数に格納しましたが、今はテンプレート関数の最初のパラメータとして受け取っています。そのために、everythingのshowルールにクロージャー(その場で使用される名前のない関数)を渡しました。`conf`関数は2つの引数(タイトルと本文)を期待しますが、showルールは本文のみを渡すからです。したがって、論文のタイトルを設定し、showルールからの単一パラメータを使用できる新しい関数定義を追加します
また、タイトルがどこから来ているかに注目してください。以前は変数に格納しましたが、今はテンプレート関数の最初のパラメーターとして受け取っています。そのために、everythingのshowルールにクロージャー(その場で使用される名前のない関数)を渡しました。`conf`関数は2つの引数(タイトルと本文)を期待しますが、showルールは本文のみを渡すからです。したがって、論文のタイトルを設定し、showルールからの単一パラメーターを使用できる新しい関数定義を追加します

## 名前付き引数を持つテンプレート { #named-arguments }
前章の論文にはタイトルと著者リストがありました。これらの要素をテンプレートに追加しましょう。タイトルに加えて、所属機関を含む著者リストと論文の要約をテンプレートに受け付けるようにします。可読性を保つために、これらを名前付き引数として追加します。最終的には、次のように機能させたいと思います。
Expand Down Expand Up @@ -287,9 +287,9 @@ It's going great so far!
...
```

この新しいテンプレート関数を構築しましょう。まず、`title`引数にデフォルト値を追加します。これにより、タイトルを指定せずにテンプレートを呼び出すことができます。また、空のデフォルト値を持つ名前付き引数として`authors`および`abstract`パラメータを追加します。次に、前章からタイトル、要約、著者を生成するコードをテンプレートにコピーし、固定の詳細をパラメータに置き換えます
この新しいテンプレート関数を構築しましょう。まず、`title`引数にデフォルト値を追加します。これにより、タイトルを指定せずにテンプレートを呼び出すことができます。また、空のデフォルト値を持つ名前付き引数として`authors`および`abstract`パラメーターを追加します。次に、前章からタイトル、要約、著者を生成するコードをテンプレートにコピーし、固定の詳細をパラメーターに置き換えます

新しい`authors`パラメータは、`name`、`affiliation`、`email`というキーを持つ[辞書]($dictionary)の[配列]($array)を想定しています。任意の数の著者を持つことができるため、著者リストに1列、2列、または3列が必要かどうかを動的に決定します。まず、`authors`配列の[`.len()`]($array.len)メソッドを使用して著者の数を決定します。次に、列数を著者数と3の最小値に設定し、3列以上作成しないようにします。3人以上の著者がいる場合は、代わりに新しい行が挿入されます。この目的のために、`grid`関数に`row-gutter`パラメータも追加しました。そうしないと、行同士が近すぎてしまいます。辞書から著者の詳細を抽出するには、[フィールドアクセス構文]($scripting/#fields)を使用します。
新しい`authors`パラメーターは、`name`、`affiliation`、`email`というキーを持つ[辞書]($dictionary)の[配列]($array)を想定しています。任意の数の著者を持つことができるため、著者リストに1列、2列、または3列が必要かどうかを動的に決定します。まず、`authors`配列の[`.len()`]($array.len)メソッドを使用して著者の数を決定します。次に、列数を著者数と3の最小値に設定し、3列以上作成しないようにします。3人以上の著者がいる場合は、代わりに新しい行が挿入されます。この目的のために、`grid`関数に`row-gutter`パラメーターも追加しました。そうしないと、行同士が近すぎてしまいます。辞書から著者の詳細を抽出するには、[フィールドアクセス構文]($scripting/#fields)を使用します。

各著者についてグリッドに引数を提供する必要があります。ここで配列の[`map`メソッド]($array.map)が便利です。これは引数として関数を取り、その関数が配列の各アイテムで呼び出されます。各著者の詳細をフォーマットし、コンテンツ値を含む新しい配列を返す関数を渡します。これで、グリッドの複数の引数として使用したい値の配列ができました。[`spread`演算子]($arguments)を使用してこれを実現できます。これは配列を取り、その各アイテムを関数の個別の引数として適用します。

Expand Down
7 changes: 7 additions & 0 deletions prh.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -221,3 +221,10 @@ rules:
- expected: わけではない
patterns:
- 訳ではない
# カタカナ語の末尾の長音の統一
- expected: コンピューター
pattern: /コンピュータ(?!ー)/
- expected: パラメーター
pattern: /パラメータ(?!ー)/
- expected: ブラウザー
pattern: /ブラウザ(?!ー)/
Loading