LaTeX之tcolorbox宏包應用示例

tcolorbox宏包可以為我們提供更好看的文本框，這里列出一些應用例子方便以后查詢使用。

環境

• Ubuntu 20.04
• Visual Studio Code 1.62.3
• LuaLaTeX

完整示例代碼

\documentclass[oneside]{article}
% 博客園，繁星間漫步，陸巍的博客

% 注意宏包順序，有可能會報錯
\usepackage{ctex}% 中文支持
\usepackage{geometry}% 用於頁面設置
\usepackage[dvipsnames, svgnames, x11names]{xcolor} % 顏色支持
\usepackage[
  colorlinks=true,
  linkcolor=Navy,
  urlcolor=Navy,
  citecolor=Navy,
  anchorcolor=Navy
]{hyperref}
\usepackage{tcolorbox}% 支持更好的文本框
\tcbuselibrary{skins, breakable}% 支持文本框跨頁
\usepackage[english]{babel}% 載入美式英語斷字模板

% 設置為A4紙，邊距適中模式（永中office）
\geometry{%
  width = 210mm,%
  height = 297mm,
  left = 19.1mm,%
  right = 19.1mm,%
  top = 25.4mm,%
  bottom = 25.4mm%
}

\hyphenpenalty = 1000% 斷字設置，值越大，斷字越少。
\setlength{\parindent}{2em}% 縮進
\setlength{\parskip}{2ex} % 段間距


\begin{document}

\section{示例一：跨頁的文本框}
默認的tcolorbox文本框是不會跨頁顯示的，在本例中演示如何實現。

\vspace{120mm}

\begin{tcolorbox}[enhanced, colback=GhostWhite, colframe=LightGray, coltitle=black, title=測試列表, fonttitle=\bfseries\Large, bottomrule=3ex, breakable=true]
  \qquad 在TDD過程中，你編寫並通過的第一個測試，都代表新加入到系統中的一種行為。除了完成整個功能外，通過的測試數目是衡量進度的最佳指標，每個測試都代表系統中的一個小的行為。

  \qquad 雖然不能事先知曉所有需要編寫的測試，但需要對將要處理的事務有一些初步的認識。許多使用TDD方法的開發者將他們想到的測試記錄到\textbf{測試列表}中（測試列表在\textit{Test Driven Development: By Example}[Bec02]中首次提出）。這個列表包含測試的名稱，或在需要做代碼清理時提示。

  \qquad 可以把測試列表寫在工作台邊上的寫字板上（也可以把它作為注釋寫入測試文件，只要在提交代碼前刪掉就行）。這個列表僅屬於你自己，所以如果喜歡的話，大可以使用簡要或隱晦的表達方式。

  \qquad 在做測試驅動開發並思考新的測試用例時，記得把它們加到測試列表里。當添加一些你認為將來需要清理的代碼時，也在這個列表中加一個提醒項。在完成一個測試或任務時，把它從列表中刪除即可，就這么簡單。如果在編碼結束后，發現仍有沒完成的任務項，可以把它們加入到下一個編碼階段的列表。

  \qquad 可以把測試列表作為初始設計的一部分。它能幫助說明你認為自己需要構建什么，它也可以啟發你去思考其他需要做的事情。

  \qquad 不要被這個列表束縛，它決定不了你要做什么，也決定不了你做事的順序。但是，TDD是一個自然的流程，通常要順着測試指引的方向去做下一件事。

  \qquad 在學習TDD時，管理測試列表非常管用。試一試吧！
\end{tcolorbox}


\section{示例二}
\begin{tcolorbox}[
  colback=MistyRose,
  coltext=red,
  colframe=LightGray,
  boxrule=0.5mm
  ]
  \begin{verbatim}
  <!-- Not recommended: omits the protocol -->
  <script src="//ajax.googleapis.com/ajax/libs/jquery/3.4.0/jquery.min.js"></script>

  <!-- Not recommended: uses HTTP -->
  <script src="http://ajax.googleapis.com/ajax/libs/jquery/3.4.0/..."></script>\end{verbatim}
\end{tcolorbox}

\begin{tcolorbox}[
  colback=white,
  coltext=ForestGreen,
  colframe=LightGray,
  boxrule=0.5mm
  ]
  \begin{verbatim}
  <!-- Recommended -->
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.0/..."></script>\end{verbatim}
\end{tcolorbox}

\begin{tcolorbox}[
  colback=MistyRose,
  coltext=red,
  colframe=LightGray,
  boxrule=0.5mm
  ]
  \begin{verbatim}
  /* Not recommended: omits the protocol */
  @import '//fonts.googleapis.com/css?family=Open+Sans';

  /* Not recommended: uses HTTP */
  @import 'http://fonts.googleapis.com/css?family=Open+Sans';\end{verbatim}
\end{tcolorbox}

\begin{tcolorbox}[
  colback=white,
  coltext=ForestGreen,
  colframe=LightGray,
  boxrule=0.5mm
  ]
  \begin{verbatim}
  /* Recommended */
  @import 'https://fonts.googleapis.com/css?family=Open+Sans';\end{verbatim}
\end{tcolorbox}

\end{document}

效果

說明

1. 跨頁的參數設置是“breakable=true”。