Skip to content

Commit

Permalink
feat: 重新组织脚本Ⅱ和排版Ⅲ
Browse files Browse the repository at this point in the history
  • Loading branch information
Myriad-Dreamin committed Dec 4, 2024
1 parent 5b868f0 commit 16a23c2
Show file tree
Hide file tree
Showing 6 changed files with 18 additions and 12 deletions.
14 changes: 8 additions & 6 deletions src/book.typ
Original file line number Diff line number Diff line change
Expand Up @@ -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")[维护文档状态 -- 制作页眉标题法二]
Expand All @@ -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. 脚本Ⅱ
Expand Down
2 changes: 1 addition & 1 deletion src/intermediate/content-stateful-2.typ
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion src/intermediate/content-stateful-3.typ
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#import "mod.typ": *

#show: book.page.with(title: "维护文档状态 —— 制作页眉标题法二")
#show: book.page.with(title: [维护文档状态])

在上一节(法一)中,我们仅靠「#typst-func("query")」函数就完成制作所要求页眉的功能。

Expand Down
4 changes: 2 additions & 2 deletions src/intermediate/content-stateful.typ
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
#import "mod.typ": *

#show: book.page.with(title: "维护和查询文档状态")
#show: book.page.with(title: [Typst架构与原理])

在上一节中我们理解了作用域,也知道如何简单把「`show`」规则应用于文档中的部分内容。

它看起来似乎已经足够强大。但还有一种可能,Typst可以给你更强大的原语。

我是说有一种可能,Typst对文档内容的理解至少是二维的。这二维,有一维可以比作空间,另一维可以比作时间。你可以从文档的任意位置,
+ 空间维度(From Space to Space):查询文档任意部分的状态(这里的内容和那里的内容)。
+ 时间维度(From TimeLoc to TimeLoc):查询文档任意脚本位置的状态(过去的状态和未来的状态)。
+ 时间维度(From TimeLoc to TimeLoc):查询脚本执行到文档任意位置的状态(过去的状态和未来的状态)。

这里有一个示意图,红色线段表示Typst脚本的执行方向。最后我们形成了一个由S1到S4的“时间线”。

Expand Down
2 changes: 1 addition & 1 deletion src/intermediate/modulize-modules.typ
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#import "mod.typ": *

#show: book.page.with(title: "模块")
#show: book.page.with(title: "模块化文档")

正如我们在《基础文档》中所说的,Typst提供了脚本语言方便排版。但事实上,若是能少写甚至不写脚本,便能完成排版,这才算便捷之至。我们总希望Typst能够允许我们以一种优雅的方式#strike[复制粘贴]引入已有代码。理想情况下,当某位前辈为我们准备好了模板,我们可以只用两行代码便可完成排版的配置:

Expand Down
6 changes: 5 additions & 1 deletion src/introduction.typ
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,11 @@ typst watch file.typ
- 本书只有《基础教程》完成了校对和润色,后续部分还非常不完善。甚至《基础教程》部分还有待改进。
- #link("https://typst-doc-cn.github.io/docs/")[非官方中文文档]是GPT机翻后润色的的结果,有可能错翻、漏翻,内容也可能有些许迟滞。

+ 接着,同时阅读《基础参考》和《进阶教程》。你可以根据你的需求挑选《基础参考》的部分章节阅读。即便不阅读任何《基础参考》中的内容,你也可以继续阅读《进阶教程》。
+ 接着,阅读《基础教程》脚本Ⅱ和排版Ⅲ的五篇文章。

这两部分分别介绍了如何使用Typst的模块功能与状态功能。模块允许你将文档拆分为多个文件。状态则类似于其他编程语言中的全局变量的概念,可用于收集和维护数据。

+ 最后,同时阅读《基础参考》和《进阶教程》。你可以根据你的需求挑选《基础参考》的部分章节阅读。即便不阅读任何《基础参考》中的内容,你也可以继续阅读《进阶教程》。

经过这一步,你应该已经完全学会了目前Typst的所有理念与内容。

Expand Down

0 comments on commit 16a23c2

Please sign in to comment.