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 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 cannot be answered without knowledge of the context. The field names supported
by a given element function **always??|usually??** correspond to the names of by a given element function always correspond to the named parameters documented
the optional arguments in the element's constructor. on each element's page.
_Remark: it would be nice to have a `.fields()` function for all types,
not just content._
Moreover, some functions, such as [`to-absolute`]($length.to-absolute) Moreover, some functions, such as [`to-absolute`]($length.to-absolute)
**(more examples)** are only applicable in a context, because their and [`counter.display`]($counter.display) are only applicable in a context,
results depend on the current settings of style properties. When another because their results depend on the current settings of style properties.
function `foo()` calls a context-dependent function, it becomes itself When another function `foo()` calls a context-dependent function, it becomes
context-dependent: itself context-dependent:
```example ```example
#let foo() = 1em.to-absolute() #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 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 invalid code: If the context changes between read and write, overwriting
a property would cause an inconsistent system state. In fact, a property would cause an inconsistent system state. In fact,
context-dependent property fields are read-only even within the context context-dependent property fields are read-only even within the context