如何让 doxygen 在 html 中使用章节编号

Question

当你在 doxygen 中声明时，在 markdown 文件中：

#Section1 {#sec1}
##subsection 1.1 {#s_sec1}

它只是变成 html:

第 1 节

第 1 小节

虽然我愿意：

1。第一节

1.1 第 1 小节

在 pdflatex 中它会自动编号。有没有办法在 html 中也有数字？我发现字体大小更改不够。

谢谢

Answer 1

我认为无法为 HTML 页自动编号。原因是与书籍 HTML 相比，文档的组织和阅读方式不同。虽然书籍中的章节按时间顺序排列，但 HTML 文档以无序的单页形式组织，其中一页不一定与书中的章节相当。主要问题是这些页面没有按时间顺序排列，访问此类页面的唯一方法是该页面链接到任何（有序或无序）索引或从另一个页面链接。书籍只有一个（一维）序列，而网站更像是一个网格，每个页面都可以引用其他页面。这是网站的一大优势（有时也是一大劣势），读者可以自行决定阅读信息的顺序。

Answer 2

这可以通过 doxygen 使用样式 sheet 来完成。

创建包含以下内容的文件：

body {counter-reset:section;}
h1 {counter-reset:subsection;}
h2 {counter-reset:subsubsection;}
h1:before
{
counter-increment:section;
content:counter(section) ". ";
}
h2:before 
{
counter-increment:subsection;
content:counter(section) "." counter(subsection) " ";
}
h3:before 
{
counter-increment:subsubsection;
content:counter(section) "." counter(subsection) "." counter(subsubsection) " ";
}

然后设置HTML_EXTRA_STYLESHEET指向您刚刚创建的文件。