From 16a23c2664c582c5919a853241e05a5f31b2d0cc Mon Sep 17 00:00:00 2001 From: Myriad-Dreamin Date: Wed, 4 Dec 2024 16:44:57 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E9=87=8D=E6=96=B0=E7=BB=84=E7=BB=87?= =?UTF-8?q?=E8=84=9A=E6=9C=AC=E2=85=A1=E5=92=8C=E6=8E=92=E7=89=88=E2=85=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/book.typ | 14 ++++++++------ src/intermediate/content-stateful-2.typ | 2 +- src/intermediate/content-stateful-3.typ | 2 +- src/intermediate/content-stateful.typ | 4 ++-- src/intermediate/modulize-modules.typ | 2 +- src/introduction.typ | 6 +++++- 6 files changed, 18 insertions(+), 12 deletions(-) diff --git a/src/book.typ b/src/book.typ index 16de728..66f9ff9 100644 --- a/src/book.typ +++ b/src/book.typ @@ -25,11 +25,13 @@ - #chapter("basic/scripting-length-and-layout.typ")[度量与布局] - #chapter("basic/scripting-color-and-shape.typ")[色彩与图表] = 基础教程 — 脚本Ⅱ - - #chapter("intermediate/modulize-modules.typ")[模块化] - - #chapter("intermediate/modulize-packages.typ")[外部库] - - #chapter("intermediate/modulize-multi-files.typ")[多文件] - - #chapter("intermediate/content-stateful-2.typ")[计数器] - - #chapter("intermediate/content-stateful.typ")[状态化] + - #chapter("intermediate/modulize-modules.typ")[文件与模块] + - #chapter("intermediate/modulize-packages.typ")[使用外部库] + - #chapter("intermediate/modulize-multi-files.typ")[多文件文档] + = 基础教程 — 排版Ⅲ + - #chapter("intermediate/content-stateful.typ")[Typst架构与原理] + - #chapter("intermediate/content-stateful-2.typ")[查询文档状态] + - #chapter("intermediate/content-stateful-3.typ")[维护文档状态] // - #chapter("intermediate/content-stateful.typ")[维护和查询文档状态] // - #chapter("intermediate/content-stateful-2.typ")[查询文档状态 -- 制作页眉标题法一] // - #chapter("intermediate/content-stateful-3.typ")[维护文档状态 -- 制作页眉标题法二] @@ -50,7 +52,7 @@ - #chapter("basic/reference-math-mode.typ")[数学模式] - #chapter("basic/reference-bibliography.typ")[参考文献] - #chapter("basic/reference-wasm-plugin.typ")[WASM插件] - = 进阶教程 — 排版Ⅲ + = 进阶教程 — 排版Ⅳ // - #chapter("basic/writing-chinese.typ")[数学排版] - #chapter("basic/writing-chinese.typ")[中文排版] // 6. 脚本Ⅱ diff --git a/src/intermediate/content-stateful-2.typ b/src/intermediate/content-stateful-2.typ index deea1da..8101dfa 100644 --- a/src/intermediate/content-stateful-2.typ +++ b/src/intermediate/content-stateful-2.typ @@ -1,6 +1,6 @@ #import "mod.typ": * -#show: book.page.with(title: "查询文档状态 —— 制作页眉标题法一") +#show: book.page.with(title: [查询文档状态]) #import "/typ/embedded-typst/lib.typ": svg-doc, default-fonts, default-cjk-fonts diff --git a/src/intermediate/content-stateful-3.typ b/src/intermediate/content-stateful-3.typ index 49f9367..bf9b4c2 100644 --- a/src/intermediate/content-stateful-3.typ +++ b/src/intermediate/content-stateful-3.typ @@ -1,6 +1,6 @@ #import "mod.typ": * -#show: book.page.with(title: "维护文档状态 —— 制作页眉标题法二") +#show: book.page.with(title: [维护文档状态]) 在上一节（法一）中，我们仅靠「#typst-func("query")」函数就完成制作所要求页眉的功能。 diff --git a/src/intermediate/content-stateful.typ b/src/intermediate/content-stateful.typ index 42bc7f4..057015b 100644 --- a/src/intermediate/content-stateful.typ +++ b/src/intermediate/content-stateful.typ @@ -1,6 +1,6 @@ #import "mod.typ": * -#show: book.page.with(title: "维护和查询文档状态") +#show: book.page.with(title: [Typst架构与原理]) 在上一节中我们理解了作用域，也知道如何简单把「`show`」规则应用于文档中的部分内容。 @@ -8,7 +8,7 @@ 我是说有一种可能，Typst对文档内容的理解至少是二维的。这二维，有一维可以比作空间，另一维可以比作时间。你可以从文档的任意位置， + 空间维度（From Space to Space）：查询文档任意部分的状态（这里的内容和那里的内容）。 -+ 时间维度（From TimeLoc to TimeLoc）：查询文档任意脚本位置的状态（过去的状态和未来的状态）。 ++ 时间维度（From TimeLoc to TimeLoc）：查询脚本执行到文档任意位置的状态（过去的状态和未来的状态）。 这里有一个示意图，红色线段表示Typst脚本的执行方向。最后我们形成了一个由S1到S4的“时间线”。 diff --git a/src/intermediate/modulize-modules.typ b/src/intermediate/modulize-modules.typ index 4b59c45..a333cc9 100644 --- a/src/intermediate/modulize-modules.typ +++ b/src/intermediate/modulize-modules.typ @@ -1,6 +1,6 @@ #import "mod.typ": * -#show: book.page.with(title: "模块") +#show: book.page.with(title: "模块化文档") 正如我们在《基础文档》中所说的，Typst提供了脚本语言方便排版。但事实上，若是能少写甚至不写脚本，便能完成排版，这才算便捷之至。我们总希望Typst能够允许我们以一种优雅的方式#strike[复制粘贴]引入已有代码。理想情况下，当某位前辈为我们准备好了模板，我们可以只用两行代码便可完成排版的配置： diff --git a/src/introduction.typ b/src/introduction.typ index 9e44fe9..f34c1f4 100644 --- a/src/introduction.typ +++ b/src/introduction.typ @@ -157,7 +157,11 @@ typst watch file.typ - 本书只有《基础教程》完成了校对和润色，后续部分还非常不完善。甚至《基础教程》部分还有待改进。 - #link("https://typst-doc-cn.github.io/docs/")[非官方中文文档]是GPT机翻后润色的的结果，有可能错翻、漏翻，内容也可能有些许迟滞。 -+ 接着，同时阅读《基础参考》和《进阶教程》。你可以根据你的需求挑选《基础参考》的部分章节阅读。即便不阅读任何《基础参考》中的内容，你也可以继续阅读《进阶教程》。 ++ 接着，阅读《基础教程》脚本Ⅱ和排版Ⅲ的五篇文章。 + + 这两部分分别介绍了如何使用Typst的模块功能与状态功能。模块允许你将文档拆分为多个文件。状态则类似于其他编程语言中的全局变量的概念，可用于收集和维护数据。 + ++ 最后，同时阅读《基础参考》和《进阶教程》。你可以根据你的需求挑选《基础参考》的部分章节阅读。即便不阅读任何《基础参考》中的内容，你也可以继续阅读《进阶教程》。 经过这一步，你应该已经完全学会了目前Typst的所有理念与内容。