docs: add KTOOLBOX_JOB__FILENAME_FORMAT example

Closes #116

Author: Ljzd-PRO

docs/en/configuration/guide.md

@@ -18,6 +18,13 @@ KTOOLBOX_JOB__POST_STRUCTURE__ATTACHMENTS=./
 # Rename attachments in numerical order, e.g. `1.png`, `2.png`, ...
 KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True
 
+# Customize the filename format by inserting an empty `{}` to represent the basic filename.
+# Similar to `post_dirname_format`, you can use some of the properties in `Post`.
+# For example: `{title}_{}` > `HelloWorld_b4b41de2-8736-480d-b5c3-ebf0d917561b`, etc.
+# You can also use it with `sequential_filename`. For instance,
+# `[{published}]_{}` > `[2024-1-1]_1.png`, `[2024-1-1]_2.png`, etc.
+KTOOLBOX_JOB__FILENAME_FORMAT=[{published}]_{}
+
 # Prefix the post directory name with its release/publish date, e.g. `[2024-1-1]HelloWorld`
 KTOOLBOX_JOB__POST_DIRNAME_FORMAT=[{published}]{title}
 

docs/zh/configuration/guide.md

@@ -18,6 +18,13 @@ KTOOLBOX_JOB__POST_STRUCTURE__ATTACHMENTS=./
 # 按照数字顺序重命名附件, 例如 `1.png`, `2.png`, ...
 KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True
 
+# 通过插入一个代表了基本文件名的空白的 `{}` 以自定义文件名格式 
+# 与 `post_dirname_format` 类似，你可以使用一些 `Post` 类里的属性
+# 例如 `{title}_{}` > `HelloWorld_b4b41de2-8736-480d-b5c3-ebf0d917561b`
+# 你也可以和 `sequential_filename` 搭配使用
+# 例如 `[{published}]_{}` > `[2024-1-1]_1.png`, `[2024-1-1]_2.png`
+KTOOLBOX_JOB__FILENAME_FORMAT=[{published}]_{}
+
 # 将发布日期作为作品目录名的开头，例如 `[2024-1-1]HelloWorld`
 KTOOLBOX_JOB__POST_DIRNAME_FORMAT=[{published}]{title}
 

example.env

@@ -8,6 +8,13 @@ KTOOLBOX_JOB__POST_STRUCTURE__ATTACHMENTS=./
 # Rename attachments in numerical order, e.g. `1.png`, `2.png`, ...
 KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True
 
+# Customize the filename format by inserting an empty `{}` to represent the basic filename.
+# Similar to `post_dirname_format`, you can use some of the properties in `Post`.
+# For example: `{title}_{}` > `HelloWorld_b4b41de2-8736-480d-b5c3-ebf0d917561b`, etc.
+# You can also use it with `sequential_filename`. For instance,
+# `[{published}]_{}` > `[2024-1-1]_1.png`, `[2024-1-1]_2.png`, etc.
+KTOOLBOX_JOB__FILENAME_FORMAT=[{published}]_{}
+
 # Prefix the post directory name with its release/publish date, e.g. `[2024-1-1]HelloWorld`
 KTOOLBOX_JOB__POST_DIRNAME_FORMAT=[{published}]{title}