summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--crates/typst-library/src/text/mod.rs17
1 files changed, 15 insertions, 2 deletions
diff --git a/crates/typst-library/src/text/mod.rs b/crates/typst-library/src/text/mod.rs
index bfa77586..27dd4a3f 100644
--- a/crates/typst-library/src/text/mod.rs
+++ b/crates/typst-library/src/text/mod.rs
@@ -66,14 +66,28 @@ pub(super) fn define(global: &mut Scope) {
/// ```
#[elem(Construct, PlainText)]
pub struct TextElem {
- /// A prioritized sequence of font families.
+ /// A font family name or priority list of font family names.
///
/// When processing text, Typst tries all specified font families in order
/// until it finds a font that has the necessary glyphs. In the example
/// below, the font `Inria Serif` is preferred, but since it does not
/// contain Arabic glyphs, the arabic text uses `Noto Sans Arabic` instead.
///
+ /// The collection of available fonts differs by platform:
+ ///
+ /// - In the web app, you can see the list of available fonts by clicking on
+ /// the "Ag" button. You can provide additional fonts by uploading `.ttf`
+ /// or `.otf` files into your project. They will be discovered
+ /// automatically.
+ ///
+ /// - Locally, Typst uses your installed system fonts. In addition, you can
+ /// use the `--font-path` argument or `TYPST_FONT_PATHS` environment
+ /// variable to add directories that should be scanned for fonts.
+ ///
/// ```example
+ /// #set text(font: "PT Sans")
+ /// This is sans-serif.
+ ///
/// #set text(font: (
/// "Inria Serif",
/// "Noto Sans Arabic",
@@ -81,7 +95,6 @@ pub struct TextElem {
///
/// This is Latin. \
/// هذا عربي.
- ///
/// ```
#[default(FontList(vec![FontFamily::new("Linux Libertine")]))]
pub font: FontList,