在 Doxygen 中调整导航树面板的大小答案

【问题标题】：Resizing the nav-tree panel in Doxygen在 Doxygen 中调整导航树面板的大小
【发布时间】：2014-03-05 16:58:12
【问题描述】：

我尝试个性化 doxygen 生成的 html 输出。

我想让文档的读者有机会调整导航树面板（左侧面板）的大小，正如我所观察到的，这不是 Doxygen 的默认设置。

我在想我可以通过添加自定义 CSS 文件 (customdoxygen.css) 来激活该功能，但我也没有找到任何解决方案。

有没有办法让 doxygen 生成代码，以便文档的读者可以调整导航树面板的大小？

【问题讨论】：

默认情况下，面板是可调整大小的，默认宽度甚至可以通过 TREEVIEW_WIDTH 配置，所以你一定忽略了一些东西。您是否使用了可能行为不端的自定义标头？
嗯，这可能是个问题。我明天去检查，让你知道。我正在使用自定义的页眉/页脚。我已经尝试配置TREEVIEW_WIDTH 参数但没有成功。左框架不可调整大小，并且每次生成文档时都有固定尺寸（无论TREEVIEW_WIDTH 具有哪个值）。我现在看不到代码，但我仍然记得，导航树在生成的 HTML 文档中具有参数selectable = "off"，该参数未在 Internet 上的其他 doxygen 文档中设置，其中可调整大小的功能有效.
首先尝试在没有自定义标题的情况下是否可以正常工作，然后将您的标题与默认标题进行比较。例如，您可能缺少包含 resize.js。
我使用的 Doxygen 版本（1.7.6.1）可能有问题。我生成了一个没有标题的新文档。没有不同。我还使用 Doxygen-GUI 生成了一个新文档，没有标题，仅启用了 GENERATE_TREEVIEW。也没什么区别。我再次使用doxygen -w html header.html footer.html customdoxygen .css 生成了默认页眉/页脚。标头默认不包含resize.js脚本，但该脚本包含在html输出中：<script src="resize.js" type="text/javascript"></script>。
我认为问题应该出在某个地方：<div class="ui-resizable side-nav-resizable" id="side-nav" style="top: 101px; width: 300px; height: 908px;" unselectable="on"> "on" 上设置了不可选择的参数。这是我观察到的具有可调整大小功能的 Internet 文档与我的文档之间的主要区别。生成文档可能是一些问题？

标签： html css internet-explorer-9 doxygen

【解决方案1】：

与此同时，我设法解决了问题。该问题是由 Internet Explorer 9 的错误引起的：

我已经在我的个人计算机（本地）上生成了文档。默认情况下，Internet Explorer 设置为不打开浏览器中的本地脚本文件。所指的选项是：Tools → Internet Options → Advanced → "Allow active content to run on files on My Computer"。

现在，当我打开文档的 index.html 文件时，Internet Explorer 会阻止 resize.js 脚本。 Internet Explorer 还为您提供了仍然允许被阻止的内容（脚本）的选项。这运行良好，有一个例外：导航树面板的unselectable 参数（由 Internet Explorer 设置）在您允许被阻止的内容后不会被禁用/删除：<div class="ui-resizable side-nav-resizable" id="side-nav" style="top: 101px; width: 300px; height: 908px;" unselectable="on">。因此，尽管脚本已加载，但导航树面板无法调整大小。

所以解决方案可能是：

禁用此选项：Tools → Internet Options → Advanced → "Allow active content to run on files on My Computer"
如果您在计算机上本地访问生成的文档，请不要使用 IE9。

【讨论】：