Skip to content

    页面元信息条(DocPageMeta) ​

    最后更新于

    每个文档页的标题下方会自动渲染一条页面元信息条:description 引用与右对齐的操作区。它由 markdown-it 在构建期注入(首个 H1 之后),组件源码位于 docs/.vitepress/theme/components/DocPageMeta.vue。

    主页(layout: page)与 404 页不渲染。

    结构 ​

    • description:取自 frontmatter description,与正文同样式、仅灰字显示。未声明时跳过。
    • 操作区:「最后更新于」左对齐(只显示到年月,如 2026年7月;时间来自 Git 提交历史,页脚默认日期已隐藏并上移至此),操作按钮组右对齐。

    复制 Markdown 与下载 ​

    可复制页(默认)的操作区:

    • 复制 Markdown:拉取本页对应的 .md 端点并写入剪贴板。
    • 更多操作 下拉菜单:
      • 查看 .md:新标签页打开本页 Markdown;
      • 下载 .md:下载本页 Markdown 文件;
      • 问问 AI:预填提示词「阅读 <本页 .md 地址> 回答相关问题」,在 ChatGPT / Claude / Grok / DeepSeek 中打开;
      • 在 Agent 中阅读:同一提示词唤起本地 Codex / Claude Code / Claude Desktop。

    .md 端点由 vitepress-plugin-llms 随构建产出(如 /sre/git-basics 对应 /sre/git-basics.md)。开发服务器不产出 .md 文件,此时「复制 Markdown」会提示失败;生产构建与 docs:preview 正常。

    copyable:页面级复制许可 ​

    frontmatter 新增 copyable 字段,控制访问者能否复制本页内容:

    值行为
    缺省 / true一切照常:可选取、可复制、有「复制 Markdown」与「下载 .md」
    false全页禁止选取与剪贴板复制;操作区只剩「问问 AI」下拉
    Markdown
    ---
    title: 受保护的页面
    description: 该页禁止复制。
    copyable: false
    ---

    设为 false 时:

    • 无法选取页面任何文字,Ctrl+C、右键「复制」与剪切均被拦截(copy / cut 事件兜底);
    • 没有「复制 Markdown」「查看 .md」「下载 .md」入口,「更多操作」按钮替换为单独的问问 AI下拉——点击仅展开菜单(问问 AI / 在 Agent 中阅读两组),不会直接执行某一项;
    • 例外:行内代码、代码块、Mermaid 图表仍可选取与复制;
    • 这只是访问侧的软限制:.md 端点与 llms-full.txt 仍公开,AI 依赖它们阅读全文。

    组件级 copyable ​

    自研代码块与图表组件也有独立的 copyable 参数(默认 true;false 隐藏复制按钮并禁止选中块内文本),可与页面级 copyable: false 组合:

    • Code / CodeBlock::copyable="false",见 Code 组件;
    • 原生 mermaid fence:围栏 meta ```mermaid copyable=false;
    • MermaidBlock::copyable="false"。

    页面锁与块级参数叠加时,块级 copyable="false" 始终生效;页面锁不例外放行被锁定的块。

    最后更新于: