1. 程式人生 > 其它 >LaTeX之tcolorbox巨集包應用示例

LaTeX之tcolorbox巨集包應用示例

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”。