上传

上传是 LumeCMS 的基本元素，用于配置文件夹，以便上传、编辑或删除文件。 它允许在界面中浏览这些文件，甚至可以预览内容。

要在 LumeCMS 中定义一个上传元素，你需要两件事：

• 上传名称。例如： "Images"。
• 用于读取和写入内容的存储。

使用 cms.upload() 函数来设置一个上传文件夹：

cms.upload("images", "src:images");

在上面的例子中，我们定义了 images 上传文件夹，它指向 src 存储中的 images 文件夹。

额外选项

对于额外的选项，可以使用像这样的对象：

cms.upload({
  name: "images",
  description: "在这里你可以管理你文章的所有图片",
  store: "src:images",
});

除了 name、description 和 store 之外，上传还具有以下选项：

label

在菜单中此上传选项的可视名称。如果未定义，则使用 name 值。

cms.upload({
  name: "images",
  label: "Posts' images",
  description: "在这里你可以管理你文章的所有图片",
  store: "src:images",
});

publicPath

如果图像的公共路径（站点构建完成后）与源文件夹中的图像不同，则使用此选项。 例如，如果文件保存在 /assets 中，但它们被移动到根文件夹：

cms.upload({
  name: "images",
  store: "src:images",
  publicPath: "/",
});

通过此配置，文件 /assets/favicon.ico 将具有公共路径 /favicon.ico。

listed

设置为 false 以不在 CMS 首页中列出此上传条目。

cms.upload({
  name: "images",
  store: "src:images",
  listed: false, // 从主菜单中隐藏。
});