如何自定义LaTeX文档类别（documentclass）

LaTeX自定义文档类创建步骤

原创已于 2024-05-18 17:52:23 修改 · 3.2k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#LaTeX

于 2024-01-04 21:13:16 首次发布

学术研究方法专栏收录该内容

27 篇文章

订阅专栏

博客介绍了在LaTeX中创建自定义文档类的方法。首先要创建.cls文件，接着在文件中创建文档类别，包括指定LaTeX版本、提供类信息等步骤，然后将文件放在合适位置使用自定义文档类，最后编译和测试。同时提醒创建时要注意避免命名冲突，调试需细心。

诸神缄默不语-个人优快云博文目录

在LaTeX中，documentclass是指定文档类别的命令，常用的文档类别有article、report、book等。如果这些标准文档类别不能满足你的特定需求，你可以通过创建一个自定义文档类来解决这个问题。以下是创建自定义类的基本步骤：

1. 创建.cls文件

创建一个以.cls为扩展名的文件，例如myclass.cls。
在文件的开始，通常需要指定这个类是基于哪个现有的类。例如，如果你想基于article类创建自定义类，文件的开始可以是这样的：
```
\ProvidesClass{myclass}[2024/01/04 My Custom Class v1.0]
\LoadClass{article}
```

2. 创建文档类别

在此文件中，你可以定义新命令、重定义现有命令、更改排版设置等。

一个功能比较完整的myclass.cls文件示例：https://github.com/PolarisRisingWar/learn-latex/blob/main/my_cls/myclass.cls

指定LaTeX版本`\NeedsTeXFormat`

\NeedsTeXFormat{LaTeX2e} 是 LaTeX 类文件（.cls 文件）中的一个命令，用于指定所需的 LaTeX 格式版本。在这个例子中，它表示该类文件需要 LaTeX2e 格式。

详细解释：

LaTeX2e:
- LaTeX2e 是 LaTeX 的一个主要版本，于 1994 年发布，是 LaTeX 的标准版本。大多数现代 LaTeX 文档和包都基于 LaTeX2e。
- 指定 LaTeX2e 确保使用这个类文件的用户具有兼容的 LaTeX 格式版本。它还允许类文件使用 LaTeX2e 特有的功能和命令。
使用 \NeedsTeXFormat 的原因:
- 通过在类文件开头使用 \NeedsTeXFormat{LaTeX2e}，类文件的作者可以确保该类文件不会在较旧或不兼容的 LaTeX 版本上使用。
- 如果用户的 LaTeX 版本不符合要求，会产生错误信息，提示用户更新 LaTeX 系统。

通过这种方式，LaTeX 类文件可以确保在兼容的环境中运行，并且利用最新的 LaTeX2e 功能和改进。

提供类信息`\ProvidesClass`

\ProvidesClass{myclass}[2024/05/17 v1.0 My Custom LaTeX Class]

\ProvidesClass 命令定义了类的名称（myclass）、发布日期（2024/05/17）和版本信息（v1.0），并添加了一段描述（My Custom LaTeX Class）。

加载基础类`\LoadClass`

\LoadClass{article}

\LoadClass 命令用于加载一个现有的标准文档类，这里是 article 类。自定义类将基于这个基础类进行扩展。

定义类选项和变量

\newif\if@showdate
\@showdatetrue
\DeclareOption{nodate}{\@showdatefalse}

% Redefine \maketitle to conditionally show date
\renewcommand{\maketitle}{
    \begin{center}
        \LARGE \@title \\
        \large \@author \\
        \if@showdate
            \@date
        \fi
    \end{center}
}

\newif\if@showdate：定义一个新的条件命令 \if@showdate。
\@showdatetrue：设置默认情况下 \if@showdate 为真。
\DeclareOption{nodate}{\@showdatefalse}：声明一个选项 nodate，如果使用这个选项，则将 \if@showdate 设置为假。

\renewcommand{\maketitle}：重新定义了 \maketitle 命令。
\if@showdate：条件判断是否显示日期。如果 \if@showdate 为真，则显示 @date；否则不显示。

\DeclareOption*{\PassOptionsToClass{\CurrentOption}{ctexbook}} 将未在文档类中显式声明的选项传递给指定的基础类或包。在这个例子中，未声明的选项将被传递给 ctexbook 类。使用ctexbook类的openany选项（可以让章首在任意一页开始，而不是只能在奇数页开始）的MRE：https://github.com/PolarisRisingWar/learn-latex/blob/main/my_cls/conveyoptions.cls