Repository navigation
Releases
Releases · Gowntn/obsidian-folder-forge
2.13.1
Folder Forge 2.13.1
从 2.8.6 到 2.13.1 的更新。这个版本主要加了结构预设和按文件夹模板。
新增
- 结构预设:预设就是普通 Markdown 笔记,正文写目录树,frontmatter 保存设置。设置页可以直接选择、读取、保存、另存为。
- 预设位置:默认放在仓库根目录的
folder-forge;也可以指定任意父目录,插件会用「父目录/folder-forge」,首次保存时自动创建。 - 预设保存完整设置:目标目录、创建模式、内容来源、自定义文本、模板路径、占位符开关、文件夹索引、索引内容、日期与时间都会写进 frontmatter,多行文本用 YAML 块保存。
- 按文件夹模板:设置页可视化编辑,每个文件夹可以指定不同模板。文件夹可以写完整路径,也可以只写名字;完整路径优先,
""是默认模板。 - 内容来源「多个模板」:只用按文件夹模板生成,匹配不到就是空白文件。
- 切换预设/当前设置:读取预设后,可以在预设设置和读取前的设置之间来回切换,方便对比。
- 预设下拉:选中即读取,不再需要单独的读取按钮;「不使用预设」替代原来的清除。
- 读取外部预设:可以加载仓库里任意笔记作为预设。
改进
- 设置页重新分区:生成位置、结构预设、创建内容、新建文件内容、文件夹索引、日期与时间、同名与目录、操作。
- 预设位置、实际预设文件夹、预设按钮改为整行布局,横线通栏,按钮靠右。
- 预设信息只显示两行:预设路径、文件夹模板数量。
- README 改为中英双语,补充安装、使用和预设字段说明。
修复
manifest.json带 UTF-8 BOM,导致 Obsidian 已安装插件里看不到、也加载不了。- Windows/macOS 下路径大小写不同时,同名冲突会漏判。
- 索引文件名本身是
x.md时会生成x.md.md。 - 预设保存后残留旧字段(
template、嵌套index、失效的contentText/indexContentText/templates),读取时旧值覆盖新值。 - 旧版嵌套
index:会覆盖新的扁平字段。 - 只写文件夹名(如「属性」)时匹配不到嵌套目录(如「输入/属性」),错误回落到默认模板。
兼容
- 旧预设里的
template字段仍然能读,保存时会自动合并为templates[""]。 - 旧版
index:嵌套写法仍然兼容,扁平字段优先。
安装 / 更新
下载 Release 里的 main.js、manifest.json、styles.css,覆盖到 .obsidian/plugins/folder-forge/,重启 Obsidian。也可以用 BRAT 更新。
Folder Forge 2.13.1
Changes from 2.8.6 to 2.13.1. This release is mainly about structure presets and per-folder templates.
Added
- Structure presets: a preset is a normal Markdown note. The body holds the folder tree, the frontmatter holds the settings. You can select, load, save, and save-as from the settings tab.
- Preset location: presets live in
folder-forgeat the vault root by default. You can point it at any parent folder and the plugin uses<parent>/folder-forge, created on the first save. - Presets store the full settings: target folder, creation mode, content source, custom text, template path, placeholder toggle, folder index, index content, and date/time. Multi-line text is stored as a YAML block.
- Templates by folder: a visual editor in the settings tab. Each folder can use a different template. A rule can be a full path or just a folder name; full paths win,
""is the default. - Content source "Multiple templates": uses only the per-folder rules; folders without a match get an empty note.
- Toggle preset / current settings: after loading a preset you can switch back and forth between the preset settings and the settings you had before loading it, to compare.
- Preset dropdown: selecting a preset loads it immediately; "Don't use a preset" replaces the old clear button.
- Read external preset: load any note in the vault as a preset.
Improved
- Settings tab regrouped: location, structure presets, creation, new note content, folder index, date and time, name conflicts, actions.
- The preset location, actual preset folder, and preset buttons use a full-width layout with full-width dividers and right-aligned buttons.
- Preset info now shows only two lines: the preset path and the number of folder templates.
- README is now bilingual and covers installation, usage, and the preset fields.
Fixed
manifest.jsonhad a UTF-8 BOM, which made the plugin missing from Installed plugins and unable to load.- Case-insensitive path collisions were missed on Windows/macOS.
- Index files named
x.mdproducedx.md.md. - Saving a preset left stale fields (
template, nestedindex, obsoletecontentText/indexContentText/templates), and old values overrode new ones on load. - The old nested
index:block overrode the new flat fields. - Folder names only (for example
属性) did not match nested folders (for example输入/属性) and fell back to the default template.
Compatibility
- The old
templatefield is still read and is merged intotemplates[""]on save. - The old nested
index:form is still supported; flat fields take precedence.
Install / update
Download main.js, manifest.json, and styles.css from the release, overwrite .obsidian/plugins/folder-forge/, and restart Obsidian. BRAT also works.
Full Changelog: 2.9.0...2.13.1
2.8.6
2.8.5
2.8.4
Initial release.
- Four input modes: Auto, Tree, Folders, Notes
- Folder index notes with separate content settings
- Placeholder support with Chinese/English date formats
- Bilingual UI following Obsidian's language
首次发布。
- 四种输入模式:自动、树状、文件夹、笔记
- 文件夹索引笔记,具有独立的内容设置
- 支持中文/英文日期格式的占位符
- 双语用户界面,遵循Obsidian的语言设置