caisin/typst
1
0
Fork 0
mirror of https://github.com/typst/typst synced 2025-05-14 17:15:28 +08:00
Code Issues Packages Projects Releases Wiki Activity

minor style fixes

Browse Source
This commit is contained in:
Ullrich Koethe 2025-03-06 18:07:52 +01:00 committed by GitHub
parent 50fa078451
commit a1bf9f20b8
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/reference/language/styling.md
View File

@ -124,15 +124,12 @@ Note that you cannot pass positional arguments in a set rule – a set rule
is not really a function call, it just uses the same syntax for convenience. is not really a function call, it just uses the same syntax for convenience.
A set rule refers to all instances of the given EF type and stays in effect A set rule refers to all instances of the given EF type and stays in effect
until the end of the present scope. until the end of the present scope. In particular, a top level set rule
In particular, a top level set rule stays in effect until the end of the file stays in effect until the end of the file unless explicitly overridden by
unless explicitly another set rule. To restrict a set rule's lifetime, you can enclose it in
overridden by another set rule. To restrict a set rule's lifetime, you can a code block, i.e. in brackets or braces. Then, the rule expires at the end
enclose it in a code of the block, and the previous behavior is restored. Below, we use a content
block, i.e. in brackets or braces. Then, the rule expires at the end of the block to apply the modified list styling only to the list in brackets:
block, and the previous behavior is restored.
Below, we use a content block to apply the modified list styling only to the
list in brackets:
```example ```example
This list is affected: #[ This list is affected: #[
@ -195,7 +192,7 @@ but unleashes the full range of customization options:
} }
``` ```
The [selector] pattern specifies the situation where the desired The [selector]-pattern specifies the situation where the desired
modifications shall apply. modifications shall apply.
The most common form of `selector-pattern` is an [element The most common form of `selector-pattern` is an [element
function]($function/#element-functions) identifier. This means that the function]($function/#element-functions) identifier. This means that the
@ -230,10 +227,11 @@ Plain text stays black as well.
A complete list of supported selector patterns is provided below. A complete list of supported selector patterns is provided below.
To overcome the limitations of set rules, you use the `function` variant of To overcome the limitations of set rules on the right-hand side, you use the
the show rule. In this variant, the right-hand side is the name of an `function` variant of the show rule. In this variant, the right-hand side is
arbitrary [function] that accepts exactly one positional argument (it can have the name of an arbitrary [function] that accepts exactly one positional
arbitrarily many named arguments) and returns arbitrary content: argument (it can have additional named arguments) and returns arbitrary
content:
```example ```example
#let always-say-thank-you(it) = { #let always-say-thank-you(it) = {
@ -243,12 +241,11 @@ arbitrarily many named arguments) and returns arbitrary content:
} }
#show heading: always-say-thank-you #show heading: always-say-thank-you
= This heading is boring = This heading is boring
``` ```
The function's argument (conventionally called `it`) is the EF that matched The function's argument (conventionally called `it`) is the EF that matched
the left-hand side of the show rule. The function implements arbitrary the left-hand side of the show rule. The function implements the desired
modifications (via embedded set and show rules or any other code) and then modifications (via embedded set and show rules or any other code) and then
forwards the content for further processing, returns entirely new content, or forwards the content for further processing, returns entirely new content, or
a combination thereof. a combination thereof.
@ -265,7 +262,8 @@ accessible.
#let always-say-thank-you(it) = { #let always-say-thank-you(it) = {
it it
if it.depth == 1 { if it.depth == 1 {
set text(red, size: text.size * 150%) set text(red,
size: text.size * 150%)
[I don't care] [I don't care]
} else { } else {
set text(green) set text(green)
@ -279,7 +277,7 @@ accessible.
== This one is better == This one is better
``` ```
In pratice, the function is usually implemented in-place as an unnamed function In practice, the function is usually implemented in-place as an unnamed function
(aka. "lambda expression") with the syntax `it => { implementation }` for an (aka. "lambda expression") with the syntax `it => { implementation }` for an
implementation in script mode or `it => [ implementation ]` for an implementation in script mode or `it => [ implementation ]` for an
implementation in markup mode. In this more involved example, we define a implementation in markup mode. In this more involved example, we define a