Skip to content

Fix reference styling #59

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.

Sign up for GitHub

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

Merged
merged 2 commits into from
Sep 16, 2024
Merged

Fix reference styling #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
94c8321
Remove half-width space
kimushun1101 Sep 14, 2024
856bf0d
形式→スタイル設定に修正
kimushun1101 Sep 14, 2024
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
4 changes: 2 additions & 2 deletions docs/glossary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ description: |
| documentation | ドキュメント | 文档 | |
| content | コンテンツ | 内容 / 内容块 | 型の一種で、マークアップによって表される |
| styling | スタイル設定 | 样式 　　　　 | |
| set rule | setルール | set 规则 | [形式]($styling)に出てきます |
| show rule | showルール | show 规则 | [形式]($styling)に出てきます |
| set rule | setルール | set 规则 | [スタイル設定]($styling)に出てきます |
| show rule | showルール | show 规则 | [スタイル設定]($styling)に出てきます |
| markup | マークアップ | 标记 / 标记模式 | Typstのデフォルトモード |
| script | スクリプト | 脚本 / 脚本模式 | Typstのスクリプトモード、「#」で始まる行 |
| figure | 図表 | 图表 | キャプション付きの図表、`image`ではない |
44 changes: 22 additions & 22 deletions docs/reference/styling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ description: Typst で文書のスタイル設定をするために必要な概

# スタイル設定

Typst には柔軟なスタイル設定機能を持ち、出力される文書に対して自動的に任意のスタイル設定を適用します。
Typstには柔軟なスタイル設定機能を持ち、出力される文書に対して自動的に任意のスタイル設定を適用します。
_setルール_ ではエレメントの基本プロパティを設定できます。
しかし、やりたいことすべてに対応するプロパティがあらかじめ実装されているとは限りません。
このため、Typst はエレメントの外観を完全に再定義できる _showルール_ もサポートしています。
このため、Typstはエレメントの外観を完全に再定義できる _showルール_ もサポートしています。

## setルール { #set-rules }

set ルールを使うと、エレメントの外観をカスタマイズできます。
これらは、`{set}` キーワード（マークアップでは `[#set]`）を前に置いた [element 関数]($function/#element-functions) への[関数呼び出し]($function)として記述されます。
setルールを使うと、エレメントの外観をカスタマイズできます。
これらは、`{set}`キーワード（マークアップでは`[#set]`）を前に置いた[element 関数]($function/#element-functions)への[関数呼び出し]($function)として記述されます。
set ルールに指定できるのは、その関数のオプションのパラメーターだけです。
どのパラメーターがオプションであるかは、各関数のドキュメントを参照してください。
以下の例では、2 つの set ルールを使って、[フォント]($text.font)と[見出し番号]($heading.numbering)を変更しています。
Expand All @@ -28,10 +28,10 @@ With set rules, you can style
your document.
```

set ルールは、そのまま記述するとファイルの最後まで適用されます。
setルールは、そのまま記述するとファイルの最後まで適用されます。
ブロックの中にネストすると、そのブロックの終わりまで適用されます。
ブロックを使えば、set ルールの効果を指定した部分に限定できます。
以下では、content ブロックを用いてスコープすることで、特定のリストのスタイルのみを変更しています。
ブロックを使えば、setルールの効果を指定した部分に限定できます。
以下では、contentブロックを用いてスコープすることで、特定のリストのスタイルのみを変更しています。

```example
This list is affected: #[
Expand All @@ -43,7 +43,7 @@ This one is not:
- Bullet
```

ときには、set ルールを条件付きで設定したい場合もあるでしょう。
ときには、setルールを条件付きで設定したい場合もあるでしょう。
その場合には _set-if_ ルールを使用します。

```example
Expand All @@ -58,10 +58,10 @@ This one is not:

## showルール { #show-rules }

show ルールを使えば、特定の種類のエレメントの外観を詳細に設定できます。
show ルールの基本的な記述方法は、show-set ルールです。
`{show}` キーワードの後に [セレクター]($selector)、コロン、set ルールと続けて記述します。
セレクターの基本的な記述方法は [element関数]($function/#element-functions) を置くことであり、set ルールは選択されたエレメントにのみ適用されます。
showルールを使えば、特定の種類のエレメントの外観を詳細に設定できます。
showルールの基本的な記述方法は、show-setルールです。
`{show}` キーワードの後に [セレクター]($selector)、コロン、setルールと続けて記述します。
セレクターの基本的な記述方法は [element関数]($function/#element-functions)を置くことであり、setルールは選択されたエレメントにのみ適用されます。
下の例では、見出しは紺色になり、他のテキストは黒色のままです。

```example
Expand All @@ -71,13 +71,13 @@ show ルールの基本的な記述方法は、show-set ルールです。
But this stays black.
```

show-set ルールを使えば、さまざまな関数のプロパティを組み合わせることが可能です。
しかし、組み合わせられるプロパティは Typst であらかじめ定義されているものに限定されます。
最大限の柔軟性を得るには、エレメントをゼロからフォーマットする方法を定義する show ルールを書くことができます。
このような show ルールを書くには、コロンの後の set ルールを任意の[関数]($function)に置き換えてください。
show-setルールを使えば、さまざまな関数のプロパティを組み合わせることが可能です。
しかし、組み合わせられるプロパティはTypstであらかじめ定義されているものに限定されます。
最大限の柔軟性を得るには、エレメントをゼロからフォーマットする方法を定義するshowルールを書くことができます。
このようなshowルールを書くには、コロンの後のsetルールを任意の[関数]($function)に置き換えてください。
この関数は対象のエレメントを受け取り、任意の内容を返すことができます。
関数に渡されたエレメントで利用可能な[フィールド]($scripting/#fields)は、それぞれの element 関数のパラメーターと一致します。
以下は、ファンタジー百科事典の見出しをフォーマットする show ルールを定義する例です。
関数に渡されたエレメントで利用可能な[フィールド]($scripting/#fields)は、それぞれのelement関数のパラメーターと一致します。
以下は、ファンタジー百科事典の見出しをフォーマットするshowルールを定義する例です。

```example
#set heading(numbering: "(I)")
Expand All @@ -101,10 +101,10 @@ dragon, the manticore gets
extra style points.
```

set ルールと同様に、show ルールは、現在のブロック内またはファイルの終わりまで有効です。
setルールと同様に、showルールは、現在のブロック内またはファイルの終わりまで有効です。

関数の代わりに、show ルールのコロン右側は、エレメントに直接置換されるべきリテラル文字列またはコンテンツブロックを取ることもできます。
また show ルールのコロン左側は、以下に示すように、変換を適用する対象を定義する _セレクター_ を受け取ることができます。
関数の代わりに、showルールのコロン右側は、エレメントに直接置換されるべきリテラル文字列またはコンテンツブロックを取ることもできます。
また showルールのコロン左側は、以下に示すように、変換を適用する対象を定義する _セレクター_ を受け取ることができます。

- **すべて：** `{show: rest => ..}` \
showルール以降のすべてを変換する。
Expand All @@ -119,7 +119,7 @@ set ルールと同様に、show ルールは、現在のブロック内また

- **関数やフィールド：** `{show heading.where(level: 1): ..}` \
指定されたフィールドを持つエレメントのみを変換します。
たとえば、レベル 1 の見出しのスタイルだけを変更したい場合などに有効です。
たとえば、レベル1の見出しのスタイルだけを変更したい場合などに有効です。

- **ラベル：** `{show <intro>: ..}` \
指定されたラベルを持つエレメントに対して適用する。
Expand Down
Loading