c 开发网站开发,百度渠道开户哪里找,cn.wordpress,携程网站开发LaTeX教程(014)- LaTeX \LaTeX LATEX文档结构(14)
2.3.3 multitoc - 将目录设置为多栏
multitoc包的使用方法相当简单#xff0c;只需要调用这个包#xff0c;并将要设置为多栏(默认是双栏)的目录指定到包选项中即可。如\usepackage[toc]{multitoc}#xff0c;设置的就是…LaTeX教程(014)- LaTeX \LaTeX LATEX文档结构(14)
2.3.3 multitoc - 将目录设置为多栏
multitoc包的使用方法相当简单只需要调用这个包并将要设置为多栏(默认是双栏)的目录指定到包选项中即可。如\usepackage[toc]{multitoc}设置的就是目录列表除此之外还可以指定lof和lot(图形列表和表格列表)。我们用一个例子演示一下:
\documentclass{article}
\usepackage{geometry}
\usepackage[toc]{multitoc} %将目录设置为双栏
\begin{document}
\tableofcontents
\section{section one}
\subsection{subsection one}
\section{section two}
\subsection{subsection two}
\subsection{subsection three}
\subsection{subsection four}
\end{document}编译(只截取目录): 很用有使用超过双栏的时候但是在必要的时候你可以重定义\multicolumntoc、\multicolumnlof或者\multicolumnlot将它们重定义为你想要的数字(栏数)。如上面的例子中放置一行\renewcommand{\multicolumntoc}{3}可将目录设置为3栏: 2.3.4 LaTeX \LaTeX LATEX的底层接口
我们前面讲了如何通过一些包定制目录在这一节的最后一个小节中我们介绍一下 LaTeX \LaTeX LATEX为目录提供的底层接口其中有一些命令是我们之前用过的。实际上titletoc包也在底层调用了这些接口。
将信息写入目录文件
有两个命令用来将数据写入目录文件: \addcontentsline和\addtocontents。它们自动被标题命令和图表的标签命令调用当然如果有必要的话我们是可以直接手动调用它们的。
\addcontentsline{ext}{type}{text}\addcontentsline命令将text参数中的内容连同一些附带的信息比如当前的页码等一起放入后缀为ext的文件中(这里是指ext参数中填的内容通常是loftoc或者lot分别对应我们已经熟悉的三种列表文件)。最好用\protect将text内容保护起来。type参数中填写当前条目的类型对于.toc文件来说通常就是标题的类型如chaptersection等(不带反斜线)对于.lof和.lot文件来说通常分别是figure或者table。
\allcontentsline命令会在使用章节划分命令(如\chapter\section等)或者浮动体环境中的\caption命令时自动调用。然而该命令没有为条目的编号单独分配一个参数而是关于标题的一切文本内容只留了一个text参数那么我们如何通过该命令让 LaTeX \LaTeX LATEX知道当前条目有没有编号以及编号是什么呢我们可以在text参数中使用\numberline命令:
\protect\numberline{number}headingheading就是我们的标题文本number是我们要填的标题编号。例如在一个插图环境(figure)中使用\caption命令 LaTeX \LaTeX LATEX就会调用命令:
\addcontentsline{lof}{figure}{\protect\numberline{\thefigure}caption text}\numberline会直接被写入文件中而\thefigure会被替换成一个编号(当前图片的编号)被写入lof文件中。
在排版目录列表期间一个合适的\numberline的定义会被用来以一种特定的方式排版条目的编号如插入一段额外的距离或者变一种不同的字体等。不足之处是这种方式不具有更好的通用性它没有为编号单独划分一个参数你不能轻易地对编号进行任意的改变并且它需要一个好的\numberline定义这并不是那么容易提供的。
\addtocontents{ext}{test}\addtocontents命令没有type参数它被用来插入特殊格式的条目和任何其他的目录行都不直接相关。例如标准类的\chapter命令会调用以下命令:
\addtocontents{lof}{\protect\addvspace{10pt}}
\addtocontents{lot}{\protect\addvspace{10pt}}在.lof和.lot文件中额外放置一段空白来将不同章的图表条目分开。使用\addvspace(只能在垂直模式下使用)在不同的章之间至多插入10pt的距离如果一章中没有图表也不会产生奇怪的缺口。这是\addvspace的特殊之处如果某处插入多个\addvspace命令那么只有参数最大的会生效。例如
abc...\addvspace{10pt} %\addvspace{20pt}\addvspace{10pt}def...只会在abc…和def…之间插入一段20pt的垂直距离。然而\addcontentsline、\addtocontents和\addvspace在作为用户层命令使用时很容易出现奇怪的错误尤其是\addvspace它只能在垂直模式下使用这就意味着\addcontentsline设置的条目必须以垂直模式结束。因此你需要了解这样的条目是如何被处理的以至于能够在其中进行任意的格式化操作。而这正是下一节的任务。
如果文档使用了\include声明那么\addcontentsline和\addtocontents命令的使用就有一个局限它们都不能和\include命令在同一层级下使用。例如:
\addtocontents{toc}{\protect\setcounter{tocdepth}{1}}
\include{sect1}其中sect1.tex文件中含有\section命令这样就会得到一个意料之外的结果.toc文件中会有以下内容:
\contentsline {section}{\numberline {1}Section from sect1}{2}{}%
\setcounter{tocdepth}{1}可以看到这两行命令的顺序颠倒了\section条目本应在\setcounter{tocdepth}{1}命令的后面现在跑到前面去了。解决方法就是避免使用\include或者把\addtocontents或\addcontentsline命令放在\include所包含的文件里面。
排版一个目录列表
在上一篇中我们做了一个演示我们手动创建了一个.toc文件并且还手动修改过里面的内容然后使用\input命令将.toc文件插入到了文档中。我们知道对于文档中的条目真正起作用的是.toc、.lof或.lof文件中的那些内容。
而从上面的内容中我们又知道了目录条目的产生都缘于\addcontentsline和\addtocontents命令或隐示或显示的调用那么在这两个命令被执行之后接下来发生了什么它们是如何对.toc、.lof或.lof文件产生影响的
实际上 LaTeX \LaTeX LATEX执行命令
\addcontentsline{ext}{type}{text}时就会在后缀名为ext(这取决于我们在这个参数里填的是什么)的文件中放置一行(连同注释符%一起):
\contentsline{type}{text}{page}{anchor-name}%其中page是当前\addcontentsline放置的位置在文档中的页码。anchor-name默认是空的除非加载了hyperref包。这种情况下该参数内会被填入一个超链接的锚点名(anchor name)。
\addtocontents{ext}{text}则更简单它仅仅是将text参数的内容复制到后缀名为ext的文件中不会写入其他更多的信息。因此一个典型的目录列表文件包含一些\contentsline命令可能还包含一些由\addtocontents命令写入的特殊格式的文本。我们做个演示:
\documentclass{article}
\usepackage[a5paper,margin1in]{geometry}
\begin{document}
\tableofcontents
\section{section one}
\subsection{subsection one}
\stepcounter{subsection}
\addcontentsline{toc}{subsection}%
{\protect{\numberline{\thesubsection}}this is a test of add contentsline}
\section{section two}
\addtocontents{toc}{the is a test of addtocontents}
\end{document}编译: 我们使用\addcontentsline添加了一个subsection的条目并且将编号\thesubsection也放置了进去由于我们没有使用\subsection命令所以subsection的计数器不会自动递增我们要使用命令\stepcounter使subsection加1。
\addtocontents命令没有type参数但是我们从格式上可以看出添加的文本的默认层级等同于subsection。
打开.toc文件可以看到以下内容:
\contentsline {section}{\numberline {1}section one}{1}{}%
\contentsline {subsection}{\numberline {1.1}subsection one}{1}{}%
\contentsline {subsection}{{\hbox to\tempdima {1.2\hfil }}this is a test of add contentsline}{1}{}%
\contentsline {section}{\numberline {2}section two}{1}{}%
the is a test of addtocontents当然既然最终起作用的命令是\contentsline那么我们也可以在文档中直接使用\contentsline命令来创建一个目录。
下面展示一个典型的例子。注意大多数(并非全部)标题编号都是作为\numberline的参数输入的以便能有统一的、合适的缩进。出于历史的原因 LaTeX \LaTeX LATEX在这一点上并不一致标准类的\part命令的编号并没有使用\nunmberline命令而是直接为其指定了一种特殊的格式。
\documentclass{book}
\usepackage[a5paper,margin1in]{geometry}
\setcounter{tocdepth}{3}
\begin{document}
\tableofcontents
\contentsline {part}{I\hspace{1em}Part}{2}{}%
\contentsline{chapter}{\numberline{1}A-Head}{2}{}%
\contentsline{section}{\numberline{1.1}B-Head}{3}{}%
\contentsline{subsection}%
{\numberline{1.1.1}C-Head}{4}{}%
\contentsline{subsection}%
{\numberline{}With Empty Number}{5}{}%
\contentsline{subsection}{Unnumbered C-Head}{6}{}%
\contentsline{subsection}%
{\numberline{1.1.2}Another C-Head}{8}{}%
\contentsline{section}%
{\numberline{1.2}Another B-Head}{10}{}%
\end{document}编译: \contentsline命令执行后又会根据type参数的不同调用\ltype命令。每一种\ltype命令都有一个定义例如在report类中你可以看到以下定义:
\newcommand\lsection {\dottedtocline{1}{1.5em}{2.3em}}
\newcommand\lsubsection {\dottedtocline{2}{3.8em}{3.2em}}
\newcommand\lsubsubsection{\dottedtocline{3}{7.0em}{4.1em}}
\newcommand\lparagraph {\dottedtocline{4}{10em}{5em}}
\newcommand\lsubparagraph {\dottedtocline{5}{12em}{6em}}
\newcommand\lfigure {\dottedtocline{1}{1.5em}{2.3em}}
\newcommand\ltable {\lfigure}根据定义\ltype实际上是被指定了3个参数的命令\dottedtocline(它实际上有5个参数)被指定了的参数分别是level-条目层级、indent-缩进和numwidth-编号宽度剩下两个保留参数分别是text和page它会自动从\contentsline命令中接收到。我们知道其实还有一个anchor-name参数这个参数大多数时候是空的而如果指定了hyperref包这些定义就会改变同时最后一个参数也会被接收到。
注意有一些标题以一种更复杂的方式建立它们的目录条目这就使得标准类中的\lpart和\lchapter(包括article类中的\lsection)并不是使用\dottedtocline定义的。通常它们用一些特殊的格式命令可能会省略引导线或者用更大的字体排版等。
所以要定义这些条目列表的布局就必须声明合适的\ltype命令(这些正是titletoc包的\dottedcontents和\titlecontents所做的事)。下面我们展示一种不通过宏包来使用\dottedtocline的简单方法。这个命令的形式如下:
\dottedtocline{level}{indent}{numwidth}{text}{page}最后两个命令和\contentsline的第二和第三个命令保持一致\dottedtocline通常会被\contentsline所调用。其他的命令如下:
level: 条目的层级。indent: 从左边距开始的缩进。numwidth: 用来放置条目编号的盒子的宽度(如果使用了\numberline的话)对于多行的标题文本这些缩进对所有行都有效。
另外还使用了以下这些全局格式参数它们对所有出现的条目生效。这些参数都是长度数值。要改变它们必须使用\renewcommand重定义。
\pnumwidth: 放置页码的盒子的宽度\tocrmarg: 条目文本的右侧缩进对于多行文本来说它是除最后一行的所有行的缩进。可以是一个弹性长度。\dotsep: (引导线中)两个点之间的间隔单位是mu(18mu-1em)这里填入一个数字(如1.7或2)单位不用写。你可以通过将数字设置的足够大来让这些点显示不出来。
我们用一张图表示这些参数的作用位置: numwidth参数中的编号靠左对齐(如果有编号的话)。我们可以通过改变indent和numwidth的设置来为嵌套的条目实现合适的缩进。
有时候对它们进行调整是必须的如果你使用的是标谁类比如article而文档的篇幅又很长那么就可能会出现11.12这样的编号(第11节第12小节)此时原本的放置编号的空间可能就不太够用了编号和文本会离得很近甚至重叠。我们作个演示:
\documentclass{article}
\usepackage[a5paper,margin1in]{geometry}
\setcounter{tocdepth}{3}
\begin{document}
\contentsline{section}{\numberline{11}A-Head}{3}{}%
\contentsline{subsection}{\numberline{11.1}B-Head}{3}{}%
\ldots %
\contentsline{subsection}{\numberline{11.12}B-Head}{7}{}%
\end{document}编译: 这种情况下可以重定义\subsection为编号保留更多的空间(调整\dottedtocline的第三个参数)我们作个演示:
\documentclass{article}
\usepackage[a5paper,margin1in]{geometry}
\setcounter{tocdepth}{3}
\makeatletter
\renewcommand\lsubsection{\dottedtocline{2}{1.5em}{3em}}
\makeatother
\begin{document}
\contentsline{section}{\numberline{11}A-Head}{3}{}%
\contentsline{subsection}{\numberline{11.1}B-Head}{3}{}%
\ldots %
\contentsline{subsection}{\numberline{11.12}B-Head}{7}{}%
\end{document}编译: 这里要注意 LaTeX \LaTeX LATEX的内部命令(就是带符号的命令)在文档中使用时要用\makeatletter和\makeatother将其包含其中。其他类似的命令的重定义方式也和\subsection一样我们不再一一演示。
少数时候我们可能需要扩展放置页码的盒子的宽度例如如果页码是根据part设置的如A-78、B-328等那么默认的空间可能就不够了然后弹出一个Overfull hbox的警告(盒子溢出)。一种解决方法就是重定义\pnumwidth的值使其至少能够放置最宽的页码:
\makeatletter
\renewcommand\pnumwidth{2cm}
\makeatother\pnumwidth一经调整通常\tocrmarg也要跟着调整以保证其布局的一致性。
这些例子能让我们看出titletoc提供的高级接口的优势使用像\contentspush这样的命令显然是一种更简单的解决方法。
添加其他的目录文件
有些时候你可能会想要标记一些其他的数据并将其做成列表。这样你就需要创建一个新的目录文件。
例如假设你想要在一个article中收集所有对艺术家的注释那么你需要定义两个命令。第一个是\artist用来排版艺术家的姓名并且将这两个参数联结起来同时将当前命令在文档中所处的位置写为当前的页码记录到文件中。第二个是\listofartistnotes用来读取文件中的内容并且将这些内容布局在文档中插入该文件的地方。
要实现这一点\listofartistnotes命令要调用\starttoc{ext}它会读取后缀为ext的文件(这里指我们在ext处填的参数)这个命令也会被\tableofcontents\listoffigures和\listoftables调用。这个文件的后缀是自定义的可以是任意没有用过的字符串如.rec。我们可以单独创建一章如\chapter*{Notes on artists}用来放置这个列表(只需要将命令\listofartistnotes放置在这一章中)如果想要的话也可以使用\addcontentsline将这一章的标题放置在目录文件中(.toc)。
而真正控制.rec文件中的条目排版的命令是\lnote这是一个需要我们定义的命令。在下面的例子中这些注释都分别作为一个段落排版并且后面紧跟着一个斜体的页码。如果不想直接定义页码的样式命令也可以使用titletocs接口如\titlecontents{note}...。
\documentclass{article}
\usepackage[a5paper,margin1in]{geometry}
\newcommand\artist[2]{#1\addcontentsline{rec}{note}{#1: #2}}\makeatletter
\newcommand\listofartistnotes%
{\section*{Notes on artists}\starttoc{rec}}%
\newcommand\lnote[2]{\par\noindent#1,~\textit{#2}\par}
\makeatother
\begin{document}
The version of Ravels Boléro by \artist{Jacques Loussier Trio}{A strange experience} is rather unusual. Quite interesting is Davis Blue in Green
by \artist{Cassandra Wilson}{A wonderful version}.
\listofartistnotes
\end{document}编译: 关注【年轻人 你渴望力量么】
