首页 / 建站手册 / 文档页:docs.html

文档页:docs.html

开发手册自己的页面:分组目录树、上下篇翻页、目录统计。

模板文件:docs.html | 访问地址:/docs 与 /docs/<slug>

这一页就是你现在看的这个手册。它是内置的,不需要你自己建栏目 —— 文档存在 docs 表里, 随程序分发的种子文件是 docs/docs_seed.php。

这个页面拿到的变量

{doc.…}当前这篇文档整行:title summary body(HTML)slug grp
{docTree}分组目录树,配 {naicha:loop from="docTree" as="g"} → {g.label} → {g.items} → {d.title} {d.url} {d.current}
{docPrev} {docNext}上下篇(title + url),第一篇的 prev 为空
{docStat.count} {docStat.updated} {docStat.groups}总篇数 / 最后更新 / 分组数
{seo.*} {canonical}照常

侧栏目录树怎么写

<nav class="docs-nav">
  {naicha:loop from="docTree" as="g"}
    <details open>
      <summary>{g.label}</summary>
      {naicha:loop from="g.items" as="d"}
        <a class="{naicha:if var="d.current" eq="1"}on{/naicha:if}" href="{d.url}">{d.title}</a>
      {/naicha:loop}
    </details>
  {/naicha:loop}
</nav>

官方主题在这里多用了一小段脚本:默认全部展开(没 JS 也能用), 有 JS 时只展开当前所在的那一类 —— 手册几十篇,全摊开侧栏太长了。

⚠️ 改文档内容改的是 docs/docs_seed.php,不是数据库 —— 同步逻辑(core/Docs.php)会拿种子文件覆盖 docs 表。 只改数据库的话,下次在线更新就把你的改动冲回去了。

改完记得跑一次同步并清缓存:php install.php --cli --seed-docs, 然后清 storage/cache/tpl_*.php 与 storage/page/*.html。
没找到答案? 可以在 联系我们 留言说明使用场景,我们会补充进文档。