Package Information
- Last Updated
- Minimum Typst Version
- 0.13.0
- Authors
- Song Xinjie
- Categories
- report
- Disciplines
- physics
Preview
1. Get the package
Download the package using the TPIX CLI:
tpix get @preview/unofficial-pku-mpl:0.1.02. Initialize from template
Create a new project from this template:
typst init @preview/unofficial-pku-mpl:0.1.0概述
北京大学《近代物理实验》课程的 Typst 报告模板,由 LaTeX 模板 PKUMpLtX 移植而来。本项目是独立的非官方 Typst 实现。
功能特性
- 对齐 revtex 版式 — 正文 12pt、行距、标题间距与编号均按
revtex4-2的 preprint 样式校准 - 中文排版 — Roman/Sans/Mono 映射到宋体/黑体/仿宋,斜体回退正确;提供
macos、windows、noto、notofandol、fandol五套字体预设 - APS 参考文献 — 通过内置 CSL 文件近似复现
apsrev4-2,Typst 原生读取.bib - 双横线表格 —
ruled-table复现ruledtabular的首尾双横线风格 - 首页标题区 — 一个
frontmatter(..)调用渲染标题/作者/单位/日期/摘要/关键词;摘要按mpltx.cls的 11pt、400pt 宽度、首行 2em 和约 16.9pt 基线间距实现 - 彩色链接 — 交叉引用、文献引用、URL 按 LaTeX
hyperref默认值区分颜色
快速开始
前置依赖: 已安装 Typst。
通过包初始化(发布到 Typst Universe 后):
typst init @preview/unofficial-pku-mpl:0.1.0
从源码预览完整示例:
git clone https://github.com/xjsongphy/pkumpl-typst && cd pkumpl-typst
typst compile demo.typ
如需实时预览,运行 typst watch demo.typ。所有源文件请用 UTF-8 保存。
Typst 快速入门
如果刚开始使用 Typst,建议先阅读官方 Typst 教程,也可以阅读中文 Typst 教程。如果希望让 Agent 辅助处理 Typst 文档,可参考 Claude Typst skill。
包结构
两个 Typst 文件的职责如下:
mplts.typ是包入口,包含可复用的版式、字体、编号、图表、参考文献和工具函数实现。template/main.typ是初始化后得到的用户文档,导入已发布的包并提供报告正文示例。template/bibli.bib与template/american-physics-society.csl会随初始化复制到用户项目。
字体选项
font={macos|windows|noto|notofandol|fandol}(默认 macos):
| Roman | Sans Serif | Monospace | |
|---|---|---|---|
| Upright | 宋体类 | 黑体类 | 仿宋类 |
| Italic | 仿宋类 | 楷体类 | 楷体类 |
英文字体使用 New Computer Modern。根据 Typst Universe 的要求,本包不捆绑字体;请在本机安装所选预设需要的中文字库:
macos:Songti SC、PingFang SC、STFangsong、Kaiti SC(macOS)windows:SimSun/STSong、Microsoft YaHei/DengXian、FangSong、KaiTi(Windows)noto:Noto Serif CJK SC、Noto Sans CJK SCfandol:FandolSong、FandolHei、FandolFang、FandolKainotofandol:Noto Serif/Sans CJK SC 与 FandolFang/FandolKai
需要跨平台、可复现的排版时,建议选择 noto 或 fandol;默认 macos 是为了尽量保持上游 LaTeX 模板在 macOS 上的视觉效果。可运行 typst fonts 查看当前 Typst 能识别的字体名称。
反馈
使用中发现问题或有建议?请到项目主页提 issue。也欢迎提交 PR 改进本模板。
参考项目
PKUMpLtX— 原 LaTeX 模板(基于 revtex4-2),由北京大学近代物理实验课程维护pkuthss-typst— 北京大学学位论文 Typst 模板,可参考其包结构和发布实践revtex4-2— APS revtex 文档类- CSL styles — APS 参考文献样式来源
fandol— Fandol 中文字体
版权
- Copyright (C) 2013–2026. Modern Phys. Lab, School of Phys., Peking Univ.
- Copyright (C) 2013–2014. Sun Sibai niasw@pku.edu.cn
- Copyright (C) 2013. Cao Chuanwu
- Copyright (C) 2021–2026. Lin Xuchen linxc@pku.edu.cn
- Copyright (C) 2026. Song Xinjie xjsongphy@stu.pku.edu.cn
第三方材料与授权
本项目是独立的 Typst 实现,版式和示例材料源自北京大学《近代物理实验》的
LaTeX 模板 PKUMpLtX。移植和改编
的上游材料以 Creative Commons Attribution-ShareAlike 4.0 International 许可证
发布;上游版权声明已保留在上文和 [LICENSE] 中。
以下文件源自或复制自上游材料:
fig/instruments.pngfig/figsample.pdffiggen.pyfig.mplstylebibli.bib(为本 Typst 示例补充了部分条目)
APS CSL 文件及其 template/ 下的副本保留自身的版权和授权信息,使用 Creative
Commons Attribution-ShareAlike 3.0 许可证;它们仍受上游许可证约束,并不因本项目
使用 CC BY-SA 4.0 而被重新授权。
本项目不包含北京大学官方校徽、印章、字体或其他校方品牌资源。
许可证
以 Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) 许可发布。