v.Latest
Documentation
引用文件
在此页面上
有些网页只有一个内容来源，但其他网页则更为复杂。例如，主页可能会显示博客文章标题、团队成员简介或客户推荐，这些内容各自存在于它们自己的集合中。当你有一个包含大量内容的页面时，有些部分可能看起来不可编辑——但使用 TinaCMS，它们是可编辑的。我们称这些附加文档为你的引用文件。
什么是引用文件？
当一个页面从多个文档中提取内容时，每个文档都是一个引用文件。例如，一个主页可能包含：
- 一个主文档 (
home.json)，包含英雄部分、功能列表和其他页面内容 - 若干博客文章文档 (
.mdx文件)，其标题、作者和日期显示在博客文章部分
你的页面实际上是一个文档树，TinaCMS 允许你直接从页面本身编辑该树中的任何节点。
在编辑器中查看引用文件
在可视化编辑器中，点击引用文件横幅以查看为当前页面提供内容的每个文档的树视图。
该树向你展示：
- 每个文档的文件路径（例如
content/main/home.json） - 它所属的集合
- 引用的完整层次结构
这对于定位很有用——你可以立即看到每个内容在项目中的位置，而无需离开页面。
仅直接引用
“仅直接引用”复选框过滤树，仅显示由你所在页面直接引用的文档——即，通过 TinaCMS 的 API 从你的代码中提取的文档。
另一种是通过引用字段提取的文档——你可以在集合中添加的一种字段类型，当你获取数据时会提取附加文档。通过引用字段访问的文档将在树中显示为灰色和斜体。
内联编辑引用内容
引用文档在可视化编辑器中是完全可编辑的。你无需导航离开或找到原始文件——只需点击内容并在原地编辑。
例如，如果你的主页显示博客文章标题，你可以点击一个标题，进行更改并保存。更新会写回到原始博客文章文档，并且更改会在使用该文档的所有地方反映出来。
要求
升级到TinaCMS v3.6 或更高版本以获得最佳的引用文件工作流程。