SuperAPI AI 工具集

tcolorbox

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:tcolorbox 是一个 LaTeX 宏包,用于创建彩色、带边框的盒子,常见于定理框、注释/提示框(callout)、代码清单框、定义框等排版场景。官方手册约 500 页,可在 CTAN(https://ctan.org/pkg/tcolorbox)获取,文档命令为 texdoc tcolorbox。

主要能力:提供大量选项控制外观,如 colback(背景色)、colframe(边框色)、coltitle/colbacktitle(标题文字与背景色)、title、fonttitle、arc(圆角半径)、boxrule(边框粗细)、boxsep、width、halign、valign 等。加载不同库可扩展功能:skins(增强外观,borderline、watermark、阴影等)、breakable(跨页断框)、theorems(定理集成)、listings/listingsutf8(代码清单与 UTF-8)、minted(用 minted 引擎高亮)。还可用 \newtcolorbox 定义自定义盒子,用 \newtcbtheorem 定义带编号的定理类盒子,用 \tcblower 分隔上下部分。

使用方式:加载时可用 \usepackage[most]{tcolorbox} 一次性引入常用库,或按需 \tcbuselibrary{...}。基本用法为 \begin{tcolorbox}...\end{tcolorbox},可传选项。定理盒子需先用 \newtcbtheorem 定义,使用时提供标题与标签两个参数。\newtcbtheorem 与 \newtcolorbox 可混用:前者用于带编号,后者用于无编号盒子;\tcbset 可设全局默认。

适用场景:讲义笔记、教材、技术文档中的定理/定义/例题、警告与提示、代码展示等。

限制与常见问题:盒子默认不跨页,需加 breakable;跨页出现视觉瑕疵时可用 enhanced jigsaw + breakable;使用 enhanced 相关特性前需加载 skins 库;定理编号异常时检查 number within;代码含 UTF-8 时应使用 listingsutf8;盒子超出页边距时显式设置 width=\linewidth;与 hyperref 有冲突时应将 tcolorbox 放在 hyperref 之后加载。颜色建议与黑色混合以更专业,如 blue!50!black。

资料未提供的细节(如具体版本、价格、平台等)暂未提供。