konevsa/typst
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Documentation fixes

Browse Source
This commit is contained in:
Laurenz 2023-05-11 11:36:25 +02:00
parent 998a3c44fd
commit 8ac7be95e6
4 changed files with 16 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
library/src/meta/figure.rs
View File

@ -331,11 +331,8 @@ impl FigureElem {
.cloned()
}
/// Builds the supplement and numbering of the figure.
/// If there is no numbering, returns [`None`].
///
/// # Errors
/// If a numbering is specified but the [`Self::data()`] is `None`.
/// Builds the supplement and numbering of the figure. Returns [`None`] if
/// there is no numbering.
pub fn show_supplement_and_numbering(
&self,
vt: &mut Vt,
@ -364,11 +361,8 @@ impl FigureElem {
}
}
/// Builds the caption for the figure.
/// If there is a numbering, will also try to show the supplement and the numbering.
///
/// # Errors
/// If a numbering is specified but the [`Self::element`] is `None`.
/// Builds the caption for the figure. If there is a numbering, will also
/// try to show the supplement and the numbering.
pub fn show_caption(&self, vt: &mut Vt) -> SourceResult<Content> {
let Some(mut caption) = self.caption(StyleChain::default()) else {
return Ok(Content::empty());

7
library/src/meta/reference.rs
View File

@ -245,10 +245,9 @@ cast_to_value! {
}
}
/// Marks an element as being able to be referenced.
/// This is used to implement the `@ref` macro.
/// It is expected to build the [`Content`] that gets linked
/// by the [`RefElement`].
/// Marks an element as being able to be referenced. This is used to implement
/// the `@ref` element. It is expected to build the [`Content`] that gets linked
/// by the [`RefElem`].
pub trait Refable {
/// Tries to build a reference content for this element.
///

4
library/src/text/shaping.rs
View File

@ -90,7 +90,7 @@ impl ShapedGlyph {
matches!(self.c.script(), Hiragana | Katakana | Han) || self.c == '\u{30FC}'
}
/// See https://www.w3.org/TR/clreq/#punctuation_width_adjustment
/// See <https://www.w3.org/TR/clreq/#punctuation_width_adjustment>
pub fn is_cjk_left_aligned_punctuation(&self) -> bool {
// CJK quotation marks shares codepoints with latin quotation marks.
// But only the CJK ones have full width.
@ -101,7 +101,7 @@ impl ShapedGlyph {
matches!(self.c, '，' | '。' | '、' | '：' | '；' | '》' | '）' | '』' | '」')
}
/// See https://www.w3.org/TR/clreq/#punctuation_width_adjustment
/// See <https://www.w3.org/TR/clreq/#punctuation_width_adjustment>
pub fn is_cjk_right_aligned_punctuation(&self) -> bool {
// CJK quotation marks shares codepoints with latin quotation marks.
// But only the CJK ones have full width.

9
src/model/styles.rs
View File

@ -405,8 +405,10 @@ cast_from_value! {
location: Location => Self::Location(location),
}
/// A selector that can be used with `query`. Hopefully, this is made obsolete
/// by a more powerful query mechanism in the future.
/// A selector that can be used with `query`.
///
/// Hopefully, this is made obsolete by a more powerful query mechanism in the
/// future.
#[derive(Clone, PartialEq, Hash)]
pub struct LocatableSelector(pub Selector);
@ -462,6 +464,9 @@ impl Cast for LocatableSelector {
}
/// A selector that can be used with show rules.
///
/// Hopefully, this is made obsolete by a more powerful showing mechanism in the
/// future.
#[derive(Clone, PartialEq, Hash)]
pub struct ShowableSelector(pub Selector);