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

Incorporated suggestions by @MDLC01

Browse Source
This commit is contained in:
Ullrich Koethe 2025-03-04 20:47:56 +01:00 committed by GitHub
parent e1244479ac
commit 262ec96a90
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/reference/language/context.md
View File

@ -42,16 +42,14 @@ keyword refers to "right here":
Note that calling `#text.lang` directly would be an error, because the request
cannot be answered without knowledge of the context. The field names supported
by a given element function **always??|usually??** correspond to the names of
the optional arguments in the element's constructor.
_Remark: it would be nice to have a `.fields()` function for all types,
not just content._
by a given element function always correspond to the named parameters documented
on each element's page.
Moreover, some functions, such as [`to-absolute`]($length.to-absolute)
**(more examples)** are only applicable in a context, because their
results depend on the current settings of style properties. When another
function `foo()` calls a context-dependent function, it becomes itself
context-dependent:
and [`counter.display`]($counter.display) are only applicable in a context,
because their results depend on the current settings of style properties.
When another function `foo()` calls a context-dependent function, it becomes
itself context-dependent:
```example
#let foo() = 1em.to-absolute()
@ -72,7 +70,7 @@ When a property is changed, the response to the query changes accordingly:
```
The output of a `#context ...` call is _read-only_ in the form of opaque
`[content]`. Write access is prohibited, as it would often result in
`content`. Write access is prohibited, as it would often result in
invalid code: If the context changes between read and write, overwriting
a property would cause an inconsistent system state. In fact,
context-dependent property fields are read-only even within the context