【问题标题】：how to make doxygen use section numbering in html如何使 doxygen 在 html 中使用节编号
【发布时间】：2015-09-02 11:39:27
【问题描述】：

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

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

它只是变成了 html：

第 1 节

第 1 小节

虽然我愿意：

1。第 1 节

1.1 小节 1

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

谢谢

【问题讨论】：

你找到解决这个问题的方法了吗？亲切的问候。
很遗憾，我没有。

标签： doxygen

【解决方案1】：

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

【讨论】：

嗨！我的意思是在一页内，而不是整个文档。

【解决方案2】：

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

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

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 指向你刚刚创建的文件。

【讨论】：