ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Typst 快速上手:从安装到编译第一份 PDF 的完整流程

Typst 快速上手:从安装到编译第一份 PDF 的完整流程 Typst 快速上手从安装到编译第一份 PDF 的完整流程【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst打开终端敲一条命令30 秒后就能拿到第一份 PDF。Typst 是一个基于标记语言的排版系统你写一个 .typ 文件它编译出 PDF、HTML 或 SVG整个工具链只有一个二进制。本文带你装好 Typst、验证环境、编译出第一份文档并给出日常会用到的三档设置。30 秒看懂单二进制、零依赖、直接出 PDFTypst 是 LaTeX 的轻量替代写几行标记得到排版规范的成品文档。它适合写论文的学生、写技术文档的人以及需要程序化生成报告的开发。核心卖点是安装包就是一个静态二进制内置常用字体装完不改任何配置就能直接编译。项目说明支持平台Windows 10、macOS 12、主流 Linuxx86_64 / arm64主要依赖无字体已内嵌从源码构建需 Rust 1.92许可证Apache-2.0版本来源官方发布版 0.15.1可用typst update自行升级装之前自检最低要求三条逐行过一遍下面三行全部满足就直接进安装环节不用做任何准备。检查项最低要求说明系统版本Windows 10 / macOS 12 / 主流 Linux 发行版预编译二进制覆盖 x86_64 与 arm64 两大架构磁盘空间约 30 MB二进制本身几十 MB另需存放产物与字体网络能访问系统包管理器源仅首次下载需要装完离线可用最短路径安装winget、brew、cargo 各一条命令用你系统对应的官方渠道装然后跑typst --version看到版本号即算成功。Windows 一键安装wingetwinget install --id Typst.Typst装完开一个新终端验证typst --version预期输出typst 0.15.1。备选安装方式对比方式适用场景命令HomebrewmacOSbrew install typstAPT / DNFUbuntu、Fedora 等sudo apt install typstPacmanArchsudo pacman -S typst源码构建包管理器里没有二进制时cargo install --locked typst-cli编译 hello.typ拿到你的第一份 PDF三步写文件、编译、看产物。成功时终端无任何输出同目录出现hello.pdf约 15 KB、单页。新建hello.typ内容如下 Hello 这是一个 *Typst* 文档公式是 $E mc^2$。执行编译命令typst compile hello.typ预期结果终端无报错命令直接退出文件同目录生成hello.pdf打开可见标题「Hello」、正文和行内公式想控制输出位置加第二个参数即可typst compile hello.typ out/result.pdf。日常使用循环watch 自动编译 编辑器实时预览第 1 天只需要形成「编辑 → 保存 → 预览更新」的肌肉记忆不用背任何新命令。第 1 天VS Code 装上 Typst 扩展打开hello.typ保存即自动编译右侧直接看 PDF 预览或者终端跑typst watch main.typ会启动本地预览服务并自动打开浏览器改动实时生效HTTP 服务默认开启日常只改 .typ 文件然后保存watch 或扩展负责重编单页文档通常几十毫秒出结果换项目或换电脑后先跑typst update对齐版本新版本有问题用typst update --revert回滚设置分三档必配 / 推荐 / 选配按需取用每一档都是独立片段拷进文档头部改一个变量即可生效。必配一行搞定中文字体二进制内置的是拉丁字体中文需要指向系统里的 CJK 字体思源黑体/宋体或 Noto Sans CJK。在文档顶部加这一行#set text(font: Noto Sans CJK SC)拿不准字体名时跑typst fonts看系统实际识别到的名称。推荐统一页面风格长文档建议在开头集中设置一次版式之后全文一致#set page(paper: a4, margin: 2.2cm, footer: align(center)[#counter(page).display()]) #set heading(numbering: 1.)选配团队共享字体目录字体不在每个人机器上时用--font-path临时加一个搜索目录typst compile --font-path ~/team/fonts main.typ要长期生效就把TYPST_FONT_PATHS环境变量写进你的 shell 配置文件效果相同。踩坑速查表五个高频现象与一行解法遇到下面的症状对号入座执行修复列即可。现象可能原因一条修复命令或操作typst: command not found装完没重开终端PATH 未刷新新开终端重跑typst --version中文显示为空白方块缺中文字体或字体名拼错装思源字体文档里#set text(font: Noto Sans CJK SC)编译报错并指出行列号语法错误括号/引号不匹配按报错的行号列号直接改Typst 报错自带精确定位图片加载不出来相对路径写错或格式不受支持核对路径仅支持 PNG、JPEG、GIF、WebP、SVG想用新功能但没效果版本过旧typst update升级出问题加--revert回滚Typst 对照 LaTeX元素映射表 迁移设置从 LaTeX 迁过来按下表做心智映射第一天就不会迷路。元素LaTeXTypst章节标题\section{...} 标题加粗 / 斜体\textbf{...}/\emph{...}*粗体*/_斜体_图片\includegraphics{...}#image(a.png)表格tabular环境#table(...)行内公式$Emc^2$$Emc^2$写法相同想保留 LaTeX 的版式手感在文档开头放这三行#set page(margin: 1.75in) #set par(leading: 0.55em, spacing: 0.55em, justify: true) #set text(font: New Computer Modern)现在可以直接开写了。卡住时按下面的仓库内文档顺序查官方教程从零到进阶docs/content/tutorial/index.typ文档源函数与语法参考docs/架构与模块说明docs/dev/architecture.md项目信息与许可证README.md、LICENSE【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表