diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml index 0c0600f..89e1ed4 100644 --- a/.github/workflows/release.yaml +++ b/.github/workflows/release.yaml @@ -43,7 +43,6 @@ jobs: --exclude=.gitignore \ --exclude=.vscode \ --exclude=packages \ - --exclude=doc \ --exclude=tests \ ../ \ packages/preview/${{ env.PACKAGE_NAME }}/$PKG_VERSION/ diff --git a/NEWS.md b/NEWS.md index 1c09fe6..036712f 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,5 +1,11 @@ # Changelog +## 0.3.1 (2026-03-17) + +- 新特性：支持设置 `title` 创建标题的字体 +- 新特性：支持在设置标题编号时使用函数 +- 修复：标题格式在悬挂缩进小于首行缩进时的错误 + ## 0.3.0 (2025-10-30) - 新特性：编号列表和符号列表支持设置每级列表的样式，包括编号宽度、编号与内容之间的间隔、对齐方式等。 diff --git a/README.md b/README.md index 03cee33..b929a1d 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ CTyp 是一个用于提供 Typst 中文排版支持的包。 通过以下代码快速使用 CTyp 包的设置，默认使用 Fandol 字体（需自行安装）： ```typ -#import "@preview/ctyp:0.3.0": ctyp +#import "@preview/ctyp:0.3.1": ctyp #let (ctypset, cjk) = ctyp() #show: ctypset ``` @@ -30,7 +30,7 @@ CTyp 是一个用于提供 Typst 中文排版支持的包。 如果在 Typst Web App 环境中，可以直接使用 Noto CJK 字体系列。 ```typ -#import "@preview/ctyp:0.3.0": ctyp +#import "@preview/ctyp:0.3.1": ctyp #let (ctypset, cjk) = ctyp( fontset-cjk: "noto" ) diff --git a/doc/manual.pdf b/doc/manual.pdf index 6834fe5..73cc1f5 100644 Binary files a/doc/manual.pdf and b/doc/manual.pdf differ diff --git a/doc/manual.typ b/doc/manual.typ index bc0d56a..943afd0 100644 --- a/doc/manual.typ +++ b/doc/manual.typ @@ -1,9 +1,9 @@ #import "@preview/tidy:0.4.3" -#import "@local/ctyp:0.3.0": ctyp, fandol-fontset, page-grid +#import "@preview/ctyp:0.3.1": ctyp, fandol-fontset, page-grid #import "@preview/codly:1.3.0": * -#import "@preview/codly-languages:0.1.8": * +#import "@preview/codly-languages:0.1.10": * #codly(languages: codly-languages) -#import "@preview/theorion:0.3.3": cosmos +#import "@preview/theorion:0.5.0": cosmos #import cosmos.default: * #import "@preview/marge:0.1.0": sidenote @@ -56,13 +56,13 @@ #set align(center) #text(size: 1.5em, strong[CTyp 使用手册]) - #emph[版本: 0.3.0] + #emph[版本: 0.3.1] ] CTyp 是一个用于提供 Typst 中文排版支持的包。 该包集成了一些常用的中文排版设置，用于提供快速的中文排版体验。 -#warning-box[ +#warning-block[ 由于 Typst 的中文排版支持仍不完善，该包只能提供非语言级的排版支持。 并不保证能够实现所有中文排版需求。 ] @@ -74,19 +74,19 @@ CTyp 是一个用于提供 Typst 中文排版支持的包。 通过以下代码快速使用 CTyp 包的设置： ```typ -#import "@preview/ctyp:0.3.0": ctyp +#import "@preview/ctyp:0.3.1": ctyp #let (ctypset, cjk) = ctyp() #show: ctypset ``` -#note-box[ +#note-block[ 变量名 `ctypset` 和 `cjk` 可以自行设置，无需使用文档中的名字。 ] 在 Typst Web App 环境中，可以直接使用 Noto CJK 字体系列，通过以下代码进行设置： ```typ -#import "@preview/ctyp:0.3.0": * +#import "@preview/ctyp:0.3.1": * #let (ctypset, cjk) = ctyp( fontset-cjk: "noto" ) @@ -152,7 +152,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 西文字体的字形为 `fontset.map.[element].latin` 中所用到的值，一般情况下是 `serif`, `sans`, `mono` 三种。 该参数需要为这些字形指定具体的字体。 -#tip-box(title: [修改字体映射])[ +#tip-block(title: [修改字体映射])[ 将 `strong` 元素从使用#strong[黑体]改为使用宋体 ```typ @@ -186,7 +186,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 这通常也是 LaTeX 中的默认行为。 如果偏好 Microsoft Word 的行为，即使用黑体的情况下加粗，那么可以在 `font-cjk-map` 中将对应元素的 `cjk` 字段增加一个 `:bold` 后缀。 -#important-box(title: [注意])[ +#important-block(title: [注意])[ 为了实现这一效果，`strong` 元素的 `delta` 被设置为 `0`，并全局生效。如果这导致了异常的行为，可以在 `ctyp()` 函数中设置 `reset-strong-delta` 参数为 `300`，则恢复默认行为。 该值是 Typst 文档中标注的默认值。如果希望使用其他值，可以自行设置。 ] @@ -196,7 +196,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 函数 `ctyp()` 的返回值中的第二个元素 `cjk` 是一个字典。字典的键都来自于字体集合中 `family` 字段的键，也就是字形的名称；值是一个函数，直接使用可以修改内容的字体。 这些函数提供一个参数 `weight` 用于设置字体粗细。 -#tip-box(title: [直接使用 CJK 字体])[ +#tip-block(title: [直接使用 CJK 字体])[ ```typ #let (ctypset, cjk) = ctyp() #let (song, hei, kai, fang) = cjk @@ -217,7 +217,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 这些函数中的西文字体默认使用 `ctyp()` 函数参数 `font-latin` 中的 `serif` 字体。 若要修改西文字体，可以通过这些修改这些函数中的 `latin` 参数来实现，该参数接受 `font-latin` 中的键，或具体的字体名称。 -#tip-box(title: [使用CJK字体并设置西文字体])[ +#tip-block(title: [使用CJK字体并设置西文字体])[ ```typ #fang(latin: "mono")[使用仿宋体和 monospace 西文字体。] ``` @@ -233,7 +233,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 考虑到中文书写时，往往不会使用智能引号，而是依赖输入法进行输入；而使用英文时，却往往需要智能引号，尤其是在纯文本编辑器中。 因此，该包默认开启了智能引号的字体设置。 -#warning-box[ +#warning-block[ 该功能启用时，无论是中文还是英文，智能引号都会使用西文字体。反之，手动引号（使用 `sym.quote.l` 和 `sym.quote.r` 或与之相应的字符）都会使用中文字体。也就是说： - 中文应当使用“手动引号”，使用"智能引号"则会使用西文字体。 - Users should use "smartquote" in Latin text; otherwise, “manual quotes” will result in CJK characters. @@ -250,7 +250,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 该包重新设置了列表的样式，使得列表项目符号与内容基线对齐。 该功能默认开启。 -#note-box(title: [修复后的列表])[ +#note-block(title: [修复后的列表])[ + 项目1 + 项目2 - 项目2.1 @@ -266,7 +266,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 如果不喜欢该功能，可以将 `ctyp()` 函数的参数 `fix-list-enum` 设置为 `false`，则不修复列表样式。 -#tip-box(title: [不修复列表])[ +#tip-block(title: [不修复列表])[ ```typ #let (theme, _) = ctyp( fix-list-enum: false, @@ -336,9 +336,9 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source 该包提供了一个 `page-grid()` 函数，可以根据字符数设置页面的边距。 该函数接收 `page()` 函数的 `margin` 参数的所有合法值，但是对于 `width` 和 `height` 参数，必须是整数，表示字符的数量。 -#tip-box(title: [页面设置])[ +#tip-block(title: [页面设置])[ ```typ -#import "@local/ctyp:0.3.0": page-grid +#import "@local/ctyp:0.3.1": page-grid #show: page-grid.with( width: 45, height: 70 @@ -346,7 +346,7 @@ CTyp 包提供了以下预定义的字体集合：`fandol`, `fangzheng`, `source ``` ] -#note-box[ +#note-block[ 由于 Typst 的限制，页面设置不能放在 `ctyp()` 函数中。 目前采用的是提供单独的 `page-grid()` 函数来设置页面。 这也有一些额外的好处，例如可以与其他包结合使用。 @@ -364,7 +364,9 @@ Typst 提供了实现任何标题编号格式的能力，但这种方法往往 - `none`：无编号。 - 字符串：接受所有 Typst 支持的编号格式，即 `numbering()` 函数可接受的值。 - 字典：用于设置编号格式的字典，包含以下字段： - - `format`：字符串，表示编号格式。也是接受所有 Typst 支持的编号格式。 + - `format`：表示编号格式。 + - 接受所有 Typst 支持的编号格式。 + - 接受一个函数 ```typst (..nums) => content``` 其中 `nums` 是一个数组，包含了当前标题的所有级别的编号。函数的返回值是一个内容，用于显示编号。 - `sep`：间隔，表示编号与标题内容之间的间隔。可以是任何合法的长度值。 - `align`：对齐方式，可以是 `left`, `center`, `right` 中的一个。默认值为 `left`。 - `hanging-indent`：悬挂缩进。设置该值可调整标题悬挂缩进长度。默认为编号部分的宽度。 @@ -376,7 +378,7 @@ Typst 提供了实现任何标题编号格式的能力，但这种方法往往 #context[ #let current-heading-number = counter(heading.where(level: 1)).get() #counter(heading).update(0) - #tip-box(title: [中文编号格式示例一])[ + #tip-block(title: [中文编号格式示例一])[ ```typ #let (ctypset_, cjk_) = ctyp( heading-numbering: (( @@ -405,7 +407,7 @@ Typst 提供了实现任何标题编号格式的能力，但这种方法往往 #context[ #let current-heading-number = counter(heading.where(level: 1)).get() #counter(heading).update(0) - #tip-box(title: [中文编号格式示例二])[ + #tip-block(title: [中文编号格式示例二])[ ```typ #let (ctypset_, cjk_) = ctyp( heading-numbering: (( diff --git a/tests/heading-numbering/ref/9.png b/tests/heading-numbering/ref/9.png new file mode 100644 index 0000000..789a3c9 Binary files /dev/null and b/tests/heading-numbering/ref/9.png differ diff --git a/tests/heading-numbering/test.typ b/tests/heading-numbering/test.typ index e82c260..c6a7190 100644 --- a/tests/heading-numbering/test.typ +++ b/tests/heading-numbering/test.typ @@ -147,3 +147,22 @@ #test-content ] + +#testcase[ + #let (theme, (song, hei, kai, fang)) = ctyp( + heading-numbering: (( + format: "一", + sep: 1em, + ), ( + format: (..nums) => numbering("1.1", ..nums.pos().slice(1)), + sep: " ", + first-line-indent: 22pt, + hanging-indent: 0em + )) + ) + #show: theme + + = 使用函数的编号格式 + + #test-content +] diff --git a/typst.toml b/typst.toml index a873328..2609341 100644 --- a/typst.toml +++ b/typst.toml @@ -1,6 +1,6 @@ [package] name = "ctyp" -version = "0.3.0" +version = "0.3.1" entrypoint = "lib.typ" authors = ["HPDell "] license = "MIT"