# Public 文件

管理内容空间公共目录中的仓库图片及其他文件。

**Public** 用于管理内容空间已配置的公共目录，里面的文件属于你的仓库。它与组织的[媒体库](/docs/zh-cn/media/)是两个入口：媒体库提供的是托管媒体链接。

## 找到文件

在内容空间侧边栏的内容集合下方打开 **Public**。可以按图片、文本和其他文件查看，也可以在更改列表中集中查看待发布草稿。列表包含子目录中的文件，搜索会匹配完整的相对路径。

目录标签显示当前的 Public 根目录。Astro 通常使用 `public`，Hugo 通常使用 `static`。添加文件前，请确认这个目录；Public 不会编辑配置范围以外的文件。

## 添加或更新图片

将图片拖到列表中，或点击上传图片。支持上传和替换 PNG、JPEG、WebP、GIF，每个文件最大 25 MiB。图片会先保存为首选图片目录中的草稿，不会立即写入 Git。

上传位置链接到 Source 设置，首选图片目录相对于 Public 配置。遇到已有文件名时，新上传会自动加上后缀，不会直接覆盖。需要更新已有图片时，请使用该文件的替换操作。

在文章的图片选择器中，选择 Public 图片可以保留 `/images/cover.png` 这样的仓库引用；选择媒体库图片则会使用托管链接。插入后，再检查文章中的替代文本和图注。

## 编辑文本文件

打开支持的文本文件，编辑源码后保存草稿，也可以新建文本文件。文件需要使用 UTF-8 编码，大小不超过 250 KB。JSON 和 Markdown 有语法高亮，其他支持的文本格式可作为纯文本编辑。

Public 用于维护网站资源、辅助配置等仓库文件。已经由内容集合管理的 Markdown 和 MDX 条目，仍通过对应的内容集合编辑器维护。

## 重命名、移动或删除

重命名和移动只能在 Public 范围内进行，文件扩展名保持不变。移动已发布文件时，会产生关联的删除和新增草稿，发布前需要一起审阅。文章中的已有引用不会自动修改，请在发布移动操作前自行更新。

删除已发布文件会生成删除草稿；删除尚未发布的文件则会丢弃其草稿。保存、替换、移动和删除都不会立即改变 Git，只有发布后才会写入仓库。

## 审阅并发布

在更改列表中选择待发布文件，打开审阅，检查新增、文本差异、图片预览、删除及目标分支。文件会按内容空间的发布设置，提交为 Commit 或 Pull Request。

文章引用了新上传、尚未发布的 Public 图片时，审阅会自动包含这张图片作为必要文件，文章和图片会一起发布。你还可以将其他 Public 草稿加入同一批次；所有文件都必须属于同一个内容空间。

这项依赖检查识别受支持的静态图片引用，不执行动态 MDX 表达式，JSON/YAML 资源中的字符串也不会自动带入图片草稿。请先通过 Public 发布这些图片，再发布使用它们的内容。

创建 Pull Request 后，可以通过发布记录跟进结果。文件何时出现在网站上，由网站原有的构建流程决定。