CeTZ：一个Typst绘图库的使用指南

项目介绍

CeTZ（CeTZ，ein Typst Zeichenpaket）是专为Typst设计的一个图形绘制库，其API灵感来自于TikZ和Processing。它简化了在Typst中创作复杂图形的过程，提供了丰富的绘图功能，适合绘制从简单的几何形状到复杂的图表等各种图形。CeTZ旨在成为Typst用户进行可视化表达的强大工具。

项目快速启动

要快速开始使用CeTZ，首先确保你的环境中已安装Typst及其必要的开发工具。接下来，按照以下步骤集成CeTZ到你的Typst文档：

1. 安装CeTZ： 在你的本地Typst包目录下安装CeTZ，可以通过仓库中的脚本完成。但为了简便起见，最新的使用方式是直接通过版本号导入。在Typst文档中加入以下代码来导入CeTZ（示例为特定版本）:

   #import "@preview/cetz:0.2.2"
   

2. 基本使用示例： 接下来，在你的文档内使用CeTZ绘制图形：

   #cetz(canvas([
     import cetz.draw: *
     // 示例绘制代码开始
     cetz.draw.circle.center(0, 0).radius(1);
     cetz.draw.text("Hello CeTZ", 0, 0);
     // 示例结束
   ]))
   

这个示例将在画布上绘制一个圆心位于原点，半径为1的圆，并在其上标注“Hello CeTZ”。

应用案例和最佳实践

CeTZ的灵活性支持多种应用场景，如自动机渲染、数学图表、流程图等。最佳实践中，充分利用CeTZ提供的库函数，比如cetz-plot用于创建各种图表，cetz-venn轻松绘制Venn图。为了提升可读性和重用性，建议将常用的图形定义封装成函数或模块。

例如，绘制一个简单的饼状图可以遵循这样的结构化编程方法，利用CeTZ的绘制函数来实现数据视觉化的清晰展示。

典型生态项目

CeTZ因其强大的绘图能力被多个项目所采用，这里列举两个突出的例子：

• cirCeTZ：这是将circuitikz的功能移植到Typst的项目，允许用户在Typst文档中方便地绘制电路图。

• conchord：专门用于编写歌词并结合和弦符号的包，自动生成指板图谱，充分展示了CeTZ在音乐文档制作中的潜力。

结语

CeTZ不仅极大地丰富了Typst的内容创造能力，还促进了技术文档和学术出版物中图形的高质量呈现。通过上述指导，开发者和作者可以迅速上手，探索CeTZ带来的无限可能。不断增长的社区和丰富的生态项目进一步证明了CeTZ作为绘图库的价值。