From 178c3beb4eeabe23bd91037268fb77f5dfdb31f3 Mon Sep 17 00:00:00 2001 From: hpcfzl Date: Mon, 28 Jul 2025 12:00:31 +0200 Subject: [PATCH] Improve Guide for LaTeX users, Query Function, and replace invisible emojis (#6620) Co-authored-by: PgBiel <9021226+PgBiel@users.noreply.github.com> Co-authored-by: Laurenz --- crates/typst-library/src/introspection/query.rs | 2 +- crates/typst-library/src/layout/page.rs | 2 +- crates/typst-library/src/model/table.rs | 2 +- docs/guides/guide-for-latex-users.md | 17 +++++++++-------- 4 files changed, 12 insertions(+), 11 deletions(-) diff --git a/crates/typst-library/src/introspection/query.rs b/crates/typst-library/src/introspection/query.rs index 1691c0f0c..02f6385e9 100644 --- a/crates/typst-library/src/introspection/query.rs +++ b/crates/typst-library/src/introspection/query.rs @@ -6,7 +6,7 @@ use crate::foundations::{Array, Context, LocatableSelector, Value, func}; /// Finds elements in the document. /// -/// The `query` functions lets you search your document for elements of a +/// The `query` function lets you search your document for elements of a /// particular type or with a particular label. To use it, you first need to /// ensure that [context] is available. /// diff --git a/crates/typst-library/src/layout/page.rs b/crates/typst-library/src/layout/page.rs index 7d586c2c1..8f4fd0e63 100644 --- a/crates/typst-library/src/layout/page.rs +++ b/crates/typst-library/src/layout/page.rs @@ -340,7 +340,7 @@ pub struct PageElem { /// This content will overlay the page's body. /// /// ```example - /// #set page(foreground: text(24pt)[🥸]) + /// #set page(foreground: text(24pt)[🤓]) /// /// Reviewer 2 has marked our paper /// "Weak Reject" because they did diff --git a/crates/typst-library/src/model/table.rs b/crates/typst-library/src/model/table.rs index c815fc159..58dd0e950 100644 --- a/crates/typst-library/src/model/table.rs +++ b/crates/typst-library/src/model/table.rs @@ -625,7 +625,7 @@ pub struct TableVLine { /// cell(align: left)[🌴🚗], /// cell( /// inset: 0.06em, -/// text(1.62em)[🛖🌅🌊], +/// text(1.62em)[🏝️🌅🌊], /// ), /// ) /// ``` diff --git a/docs/guides/guide-for-latex-users.md b/docs/guides/guide-for-latex-users.md index e8078086b..eb0ce14e5 100644 --- a/docs/guides/guide-for-latex-users.md +++ b/docs/guides/guide-for-latex-users.md @@ -33,9 +33,10 @@ collaborative editor and run Typst in your browser, no installation required. If you choose to use Typst on your computer instead, you can download the compiler as a single, small binary which any user can run, no root privileges -required. Unlike LaTeX, packages are downloaded when you first use them and -then cached locally, keeping your Typst installation lean. You can use your own -editor and decide where to store your files with the local compiler. +required. Unlike popular LaTeX distributions such as TeX Live, packages are +downloaded when you first use them and then cached locally, keeping your Typst +installation lean. You can use your own editor and decide where to store your +files with the local compiler. ## How do I create a new, empty document? { #getting-started } That's easy. You just create a new, empty text file (the file extension is @@ -459,7 +460,7 @@ and their corresponding Typst functions. | LaTeX Package | Typst Alternative | |:--------------------------------|:-------------------------------------------| | graphicx, svg | [`image`] function | -| tabularx | [`table`], [`grid`] functions | +| tabularx, tabularray | [`table`], [`grid`] functions | | fontenc, inputenc, unicode-math | Just start writing! | | babel, polyglossia | [`text`]($text.lang) function: `[#set text(lang: "zh")]` | | amsmath | [Math mode]($category/math) | @@ -550,8 +551,8 @@ $ f(x) = (x + 1) / x $ to include more than one value in a sub- or superscript, enclose their contents in parentheses: `{$x_(a -> epsilon)$}`. -Since variables in math mode do not need to be prepended with a `#` or a `/`, -you can also call functions without these special characters: +Since variables in math mode do not need to be prepended with a `#` (or a `\` +like in LaTeX), you can also call functions without these special characters: ```example $ f(x, y) := cases( @@ -580,8 +581,8 @@ their call with a `#`. Nobody can stop you from using rectangles or emoji as your variables anymore: ```example -$ sum^10_(🥸=1) - #rect(width: 4mm, height: 2mm)/🥸 +$ sum^10_(🤓=1) + #rect(width: 4mm, height: 2mm)/🤓 = 🧠 maltese $ ```