文档页: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。
