Prosefly
输入关键词搜索文档。

内容空间

Public 文件

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

Public 用于管理内容空间已配置的公共目录,里面的文件属于你的仓库。它与组织的媒体库是两个入口:媒体库提供的是托管媒体链接。

找到文件

在内容空间侧边栏的内容集合下方打开 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 后,可以通过发布记录跟进结果。文件何时出现在网站上,由网站原有的构建流程决定。

最后更新于 2026年10月19日