文件名自定义
默认情况下,TinaCMS 不对文件名施加严格的限制,因为操作系统支持多种格式。然而,如果需要,您可以在集合级别施加自定义限制。
文件名规则
- 文件名只能包含
a-z、A-Z、0-9、-、_、.或/。 - 文件名不能包含空格
- 生成的文件名在集合中必须是唯一的
- 如果文件名以
/开头,它将被视为相对于集合根目录的绝对路径- 示例:
/foo/bar/blog-post将被保存为<MyCollectionPath>/post/blog-post.md
- 如果文件名不以
/开头,它将被视为相对于当前文件夹- 示例:
bar/blog-post将被保存为<MyCollectionPath>/<CurrentDirectory>/bar/blog-post.md
配置
属性 | 描述 |
|---|---|
| 阻止用户编辑文件名 |
| 一个基于表单值生成文件名的函数 |
| 一个在用户输入时清理文件名输入的函数 |
选项A:使用 parse 清理输入
parse 函数允许您在编辑器中施加文件名限制。提供的回调函数实时清理用户输入。
使用 parse 强制执行蛇形命名法的示例
选项B:使用 slugify 生成文件名
使用 slugify 函数根据集合中的其他字段自动生成文件名。
slugify函数仅在用户创建新文件时施加限制。用户在创建后仍然可以自由重命名文件。
使用 slugify 和只读的示例
使用默认 slugify 的示例
如果没有提供 slugify 函数并且某个字段具有 isTitle: true,TinaCMS 将使用默认的 slugify 函数。这将移除非字母数字字符并将空格替换为短划线。