为单个Doxygen文件设置CSS章节计数器及为独立页面添加CSS代码的实现方法咨询

嘿，我正好做过类似的需求，给你分享几个可行的方案，完美匹配你想要的章节编号效果：

方案一：给每个Doxygen文件添加自定义页面标识，全局CSS匹配设置计数器 #

你可以在每个章节对应的.dox文件开头，用Doxygen的\htmlonly命令给页面的容器（比如body或者主内容区）添加专属类名：

\htmlonly
<body class="chapter-1">
\endhtmlonly

/*! \page chapter1 第一章：入门指南
 *  这里是章节内容...
 */

然后在你全局的HTML_EXTRA_STYLESHEET对应的CSS文件里，针对不同的类设置计数器初始值：

/* 全局计数器重置基础规则 */
body {counter-reset:section;}
h1 {counter-reset:subsection;}
h2 {counter-reset:subsubsection;}

/* 每个章节的专属计数器设置 */
.chapter-1 {
  counter-set: chapter 1;
}
.chapter-2 {
  counter-set: chapter 2;
}
.chapter-3 {
  counter-set: chapter 3;
}

/* 你的编号样式规则保持不变 */
h1::before {
counter-increment:section;
content:counter(chapter) "-" counter(section) " ";
}
h2::before {
counter-increment:subsection;
content:counter(chapter) "-" counter(section) "." counter(subsection) " ";
}
h3::before {
counter-increment:subsubsection;
content:counter(chapter) "-" counter(section) "." counter(subsection) "." counter(subsubsection) " ";
}
.toc h3::before {
content: "";
}

这样每个页面加载时，CSS会根据body的类自动设置对应的chapter计数器值，你的编号逻辑就能正常工作了。

方案二：利用Doxygen自动生成的页面ID，无需修改源文件 #

如果不想改动每个.dox文件的内容，你可以先生成一次HTML文档，然后查看每个章节页面的主容器ID（一般是page_加你设置的页面名称，比如\page chapter1对应的页面ID是page_chapter1），然后直接在全局CSS里针对这些ID设置计数器：

#page_chapter1 {
  counter-set: chapter 1;
}
#page_chapter2 {
  counter-set: chapter 2;
}

这个方法更省心，不需要修改源文件，适合已经写好大量章节的场景。

给单个Doxygen页面添加专属CSS的方法 #

如果你想给某个页面单独加CSS（比如除了计数器，还要改其他样式），直接在对应.dox文件里用\htmlonly嵌入<style>标签就行：

\htmlonly
<style>
/* 仅当前页面生效的CSS */
body {
  counter-set: chapter 1;
  background-color: #f5f5f5;
}
</style>
\endhtmlonly

这段样式只会作用在当前页面，不会影响其他章节。

小提示 #

• 每次修改CSS或者源文件后，记得清理Doxygen的输出目录，重新生成文档，避免缓存导致的样式不生效；
• 如果你的Doxygen配置了自定义HTML_HEADER，要确保header里的body标签允许添加类名（或者把自定义类加到主内容容器上，比如div.contents）。

备注：内容来源于stack exchange，提问作者Martin Merkel