caisin/typst
1
0
Fork 0
mirror of https://github.com/typst/typst synced 2025-05-13 20:46:23 +08:00
Code Issues Packages Projects Releases Wiki Activity

Clarify docs: Weak spacings eat markup space (#1648)

Browse Source 
Co-authored-by: Laurenz <laurmaedje@gmail.com>
This commit is contained in:
raphCode 2023-07-05 12:54:33 +02:00 committed by GitHub
parent 8bf0bb5da9
commit 8711b5eeed
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
crates/typst-library/src/layout/spacing.rs
View File

@ -31,15 +31,26 @@ pub struct HElem {
/// Moreover, from multiple adjacent weak spacings all but the largest one
/// collapse.
///
/// Weak spacing in markup also causes all adjacent markup spaces to be
/// removed, regardless of the amount of spacing inserted. To force a space
/// next to weak spacing, you can explicitly write `[#" "]` (for a normal
/// space) or `[~]` (for a non-breaking space). The latter can be useful to
/// create a construct that always attaches to the preceding word with one
/// non-breaking space, independently of wether a markup space existed in
/// front or not.
///
/// ```example
/// #h(1cm, weak: true)
/// We identified a group of
/// _weak_ specimens that fail to
/// manifest in most cases. However,
/// when #h(8pt, weak: true)
/// supported
/// #h(8pt, weak: true) on both
/// sides, they do show up.
/// We identified a group of _weak_
/// specimens that fail to manifest
/// in most cases. However, when
/// #h(8pt, weak: true) supported
/// #h(8pt, weak: true) on both sides,
/// they do show up.
///
/// Further #h(0pt, weak: true) more,
/// even the smallest of them swallow
/// adjacent markup spaces.
/// ```
#[default(false)]
pub weak: bool,