是否可以在\ mainpage中收集\ extifter?

发布于 2025-02-06 15:34:22 字数 881 浏览 1 评论 0原文

我需要使用实质性的\ mainpage介绍文档,但我想保留各种\ e节\ subsect等。实施它们。

我能做的最好的是用\ page标记各种片段,并将它们与\ Subpage一起包含。

这是次优的,因为它实际上创建了另一个页面(毫不奇怪!),而我希望将部分/小节内联。

我现在拥有的是:

  • \ mainpage带有一些文本和一堆
    • \ subpage xxx
  • 散布在来源周围的文档,包括:
    • \ file每文件文档。
    • 类/功能/任何特定文档。
    • 偶尔\ page xxx要在\ mainpage中引用。

这起作用了,我可以构建有意义的文档。

问题是\ Subpage construct生成一个新页面(以HTML)或单独的章节(在latex/pdf中);我希望能够更好地控制它,并可能将所有“子页面”放在同一“章节”中,就像我使用\ e节\ subsect和相似构造。

当前的结构在HTML中是有点OK,但是在乳胶中很快变得难以管理,尤其是当我开始使用\ subpage子页面中的链接以模拟\ subsect\ subsubsection和朋友。

有可能吗?

I need to present documentation with a substantial \mainpage, but I would like keep the various \section, \subsection, etc. near the code implementing them.

The best I could do is to mark the various fragments with \page and include them with \subpage.

This is suboptimal because it actually creates another page (unsurprisingly!) while I would like to have sections/subsections inline.

What I have now is:

  • a \mainpage with some text and a bunch of
    • \subpage xxx
  • documentation scattered around in the sources including:
    • \file per-file documentation.
    • class/function/whatever specific documentation.
    • occasional \page xxx to be referenced in \mainpage.

This works and I can construct meaningful documentation.

Problem is \subpage construct generates a new page (in HTML) or a separate chapter (in LaTeX/PDF); I would like to be able to control it better and possibly to put all "subpages" together in the same "chapter" as if I used \section, \subsection and similar constructs.

Current structure is kind-of-OK in HTML, but quickly becomes unmanageable in LaTeX, especially if I start using \subpage links in subpages to simulate \subsection, \subsubsection and friends.

Is it possible at all?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文