Skip to content

常见问题

常见问题

本文档收录了日经问题(QQ 群中经常有人问的问题),以及官方文档小蓝书中未提到的一些零碎的使用技巧。

由于问题已有数十个,单页面实在是太长,因此将每个问题拆开了。请活用页面上方的搜索框查找问题。

TIP

阅读本文档之前,推荐首先阅读官方文档小蓝书

如果页面上的内容有错误或者对内容有疑问,可以直接提交 issue

问题目录

如何贡献

修改已有的页面

每个下面下方会都有 在 GitHub 上编辑此页面 按钮,点击即可编辑页面内容。

创建新页面

点击这个链接创建一个新的 .md 文件,编辑完成 commit 后提交 pull request 即可。

https://github.com/typst-doc-cn/guide/new/master/docs/FAQ

模板
md
---
tags: [template, code]
---

# 问题/页面标题

写一些说明文字。

如果你需要展示 demo,可以像下面这样使用 typst 代码块。

```typst
Let $a$, $b$, and $c$ be the side
lengths of right-angled triangle.
Then, we know that:
$ a^2 + b^2 = c^2 $

Prove by induction:
$ sum_(k=1)^n k = (n(n+1)) / 2 $
```

上面的代码块在生成文档时,会自动调用 typst 编译器生成预览图片并附在代码块后面。从而让网站维护者和读者知道这段代码是可以正常使用的。

如果你的代码片段还需要与其他内容配合,不能直接运行,可以在语言后面加上 no-render,这样的代码块就不会被渲染,例如下面这个:

```typst no-render
// 设置中英文字体
#set text(font: ("New Computer Modern", "Noto Serif CJK SC"), lang: "zh")
```

嗯,暂时没有需要补充的了。

注意:渲染器在将文档中的 typst 代码渲染成图片时会自动在前面插入这两行代码,避免生成的图片过大,改善阅读体验。因此需要较大的页面展示代码效果的时候记得手动设置页面尺寸。

typst
#set page(height: 4cm, width: 6cm)
#set text(font: ("New Computer Modern", "Source Han Serif SC"))

另外,如果问题已在新版 typst 修复或改进,可在标题开头添加【已修复】,并注明版本。

md
# 【已修复】……?

::: tip ✅ Typst 0.0 已修复/已改进
[#000](https://github.com/typst/typst/pull/000) 已经……
:::
What do you think?
  • 0
  • 0
  • 0
  • 0
  • 0
  • 0
Comments
  • Latest
  • Oldest
  • Hottest
Powered by Waline v3.5.1

基于 MIT 许可发布