分享一个 LaTeX 与 BibTeX 格式化工具:tift [复制链接]

一级用户组

写论文或维护宏包时,源码缩进、公式空格和表格对齐常常要花时间手工整理。多人协作中,统一源码风格也能让 diff 更容易阅读。我最近在做一个命令行工具 tift,用于整理 LaTeX 和 BibTeX 源码,欢迎大家试用和反馈。

tift 使用 Rust 编写,可在 Windows、Linux 和 macOS 上运行。它能整理环境与列表缩进、数学公式空格、表格和公式列对齐,也支持 BibTeX / BibLaTeX、常见宏包语法、CJK 文档及 TikZ、expl3 等源码。默认保留段落原有换行,BibTeX 条目及字段顺序也按源码保留;需要重排长段落、排序或清理文献数据时,可以按项目配置启用相应选项。

例如,下面的输入会补齐数学空格,并按列对齐表格:

\begin{itemize}
\item Measurement: $E=mc^2$.
Its explanation continues here.
\item Reference value.
\end{itemize}

\begin{tabular}{ll}
Label&Value\\Longer label&42\\
\end{tabular}
\begin{itemize}
    \item Measurement: $E = mc^2$.
        Its explanation continues here.
    \item Reference value.
\end{itemize}

\begin{tabular}{ll}
    Label        & Value \\
    Longer label & 42 \\
\end{tabular}

日常使用可以先预览差异,再决定是否写回文件:

tift --diff main.tex
tift main.tex
tift .

在 CI 中可用 tift --check . 检查项目格式。通过 tift --dump-config > tift.toml 生成配置起点,可以设置缩进宽度、换行规则、对齐方式及 BibTeX 选项。VS Code、Neovim、pre-commit 等集成方式见项目指南。

最新版本为 0.1.6。可以从 GitHub Releases 下载 Windows、Linux 或 macOS 的预编译程序,也可以使用 Cargo 安装(需要 Rust 1.99.1 或更新版本):

cargo install tift --version 0.1.6 --locked --registry crates-io

项目采用 MIT 许可证。欢迎试用、提 issue,也欢迎分享不同模板和宏包下的格式化结果。

最新回复

请先登录后再回复 登录

uid:22 一级用户组
关注
发帖 1
评论 0
粉丝 0
关注 0
发新帖
目录
分享一个 LaTeX 与 BibTeX 格式化工具:tift