Releases: ZzPoLariszZ/obsidian-snowflake-method
Release list
0.10.0
Room to work your own way
- A project you are finished with can be put away. Archive project in the manager's row menu moves the whole folder into
Snowflake Archive, a folder that sits beside your projects rather than inside one, and the manager grows an Archive section at the foot of its list to hold what is in there. Nothing in the notes changes and no link is left dangling, because everything a project refers to travels inside its own folder. Restore brings it back where it came from, and gives it a free name if the one it left under has since been taken. Dragging a folder in or out with the file explorer does the same thing, so the archive is a place rather than a mechanism. - Freeform mode sets the ten steps aside, from a setting or the command Toggle freeform mode. The dashboard puts the steps and their progress away and keeps what you write into: characters and scenes join the worldbuilding list in the rail, each with its own icon and count, and their panes read as plain lists of notes rather than stages of a method. Turning it off brings everything back exactly as it was, because the mode changes only what is drawn.
- Worldbuilding and the vocabularies answer to the command palette. Add worldbuilding note and Open worldbuilding base ask which kind and then do for any of them what the character and scene commands have always done for those two, custom kinds included. Create worldbuilding kind opens the dialog that adds a kind, and Add category, Add world status and Add relationship each ask which kind the entry belongs to.
- A long member form keeps its title and its buttons in reach. The dialog no longer scrolls as a whole, so the progress status stays at the top, the Cancel and Save buttons stay at the bottom, and only the fields between them move.
Also fixed: a form dialog too tall for the window can be scrolled again, a focused field draws its full ring, changing the project root reloads the archive along with the projects, a project dragged into or out of the archive by hand is noticed, and the count above a list of rows lines up with the menus below it.
On upgrade: nothing to do. No format changed and no note is touched, so archiving a project is a folder move you could undo by hand if you ever wanted to.
Compatibility: Obsidian 1.13.0 or later.
按你自己的方式写
- 暂时写完的项目可以收起来。项目管理器行内菜单中的归档项目会把整个文件夹移入
Snowflake Archive,这个文件夹与各个项目并列,而不在任何项目之内,管理器列表底部也新增了归档分区来存放它们。笔记本身没有任何改动,也不会留下断链,因为项目引用的一切都在它自己的文件夹里。恢复会把项目送回原处,若原来的名称已被占用,会为它取一个未被使用的名称。用文件管理器手动移入或移出的效果完全相同,归档只是一个位置,而不是一套机制。 - 自由模式把十个步骤放到一边,可以从设置开启,也可以用切换自由模式命令。工作台会收起步骤与进度,只保留你真正写入的内容:角色与场景并入侧栏的世界观列表,各有自己的图标与计数,它们的面板读起来就是普通的笔记清单,而不再是方法的某个阶段。关闭后一切原样回来,因为这个模式只改变呈现方式。
- 世界观与词表也能从命令面板使用了。添加世界观笔记与打开世界观数据库会先询问种类,然后为任意一类做角色与场景那两条命令一直在做的事,自建种类同样适用。创建世界观种类会打开新增种类的对话框,添加类别、添加世界状态与添加关系则会先问清条目属于哪一类。
- 较长的成员表单,标题与按钮始终触手可及。对话框不再整体滚动,进度状态固定在顶部,取消与保存按钮固定在底部,只有中间的字段会移动。
另外修复:高度超出窗口的表单对话框重新可以滚动,获得焦点的字段能画出完整的边框光晕,更改项目根目录时归档列表会随之重新载入,手动把项目拖入或拖出归档都会被察觉,列表上方的计数也与下方各行的菜单按钮对齐。
升级提示:无需任何操作。没有任何格式发生变化,也不会改动任何笔记,归档只是移动文件夹,你随时可以手动移回去。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.9.0...0.10.0
0.9.0
The shape your story asks for
- Any member note can carry custom fields of your own. A field is a title and whatever you write under it, added and reordered as cards in the form, and kept in a section of the note's own. The plugin writes nothing into them and reads them for nothing else, so what this story needs and the built-in fields never covered now has somewhere to live.
- Worldbuilding kinds are yours to add. Time, location and item are the three every project starts with, and the rail can add up to thirty-two more: a faction, a language, a piece of technology, whatever else this story keeps track of. Each authored kind gets its own folder, rail pane, table, Bases view and three vocabularies, a Lucide icon you choose by name, and a sentence saying what it is for. Renaming one moves its folder and rewrites every link into it, and deleting one names the cost first.
- A set of custom fields can be saved as a template, kept as a note in a fourth folder beside the kind's three vocabularies. The new Custom field pane lists the templates of every kind to add, edit and delete. Any member form can export the fields you just typed as one, and the template chosen in a form is remembered as that kind's default, so the next note of that kind opens with those fields already in place.
- A relationship record now names the note it is with. The form will not save one without a target, and it marks the card it means so you can find it in a long form.
- A record's value is written in a field that wraps and can be dragged taller, the same field a custom field's content uses. A record is still one line in the note, so line breaks are read back as spaces when it is saved.
On upgrade: notes move to schema 3, and nothing happens by itself. The blue Older project format notice appears, and its Update button brings every note current in one pass, the way it has since 0.8.0. Relationships written before this release are read and shown exactly as they were, and the form asks for the missing target the next time you save the note holding one.
Compatibility: Obsidian 1.13.0 or later.
故事需要的形状
- 任何成员笔记都可以带上你自己的自定义字段。每个字段由一个标题和你写在其下的内容组成,在表单中以卡片添加与排序,存放在笔记自己的区段里。插件不会往里写任何东西,也不会拿它们做别的事,这个故事需要而内置字段从未覆盖的一切,从此有了安放之处。
- 世界观种类可以自建。时间、地点与物品是每个项目自带的三类,侧栏还可以再添加至多三十二类:门派、语言、某项技术,凡是这个故事还要记住的都可以。每个自建种类都有自己的文件夹、侧栏面板、表格、数据库视图与三份词表,图标按名称从 Lucide 中挑选,另有一句话说明它的用途。重命名会移动它的文件夹并改写指向它的所有链接,删除前会先说明代价。
- 一组自定义字段可以保存为模板,作为一篇笔记放在该种类三份词表旁边的第四个文件夹里。新增的自定义字段面板按种类列出模板,可以添加、编辑与删除。任意成员表单都可以把刚刚填好的字段导出为模板,而你在表单中选定的模板会被记为该种类的默认值,此后新建该类笔记时字段已经就位。
- 关系记录现在必须写明它指向的笔记。缺少对象时表单不会保存,并会标出它指的那张卡片,方便在长表单中找到。
- 记录的值改在可换行、可拉高的字段中书写,与自定义字段的内容用的是同一种字段。记录在笔记中依然占一行,因此换行会在保存时读作空格。
升级提示:笔记升至 schema 3,但不会有任何事情自行发生。蓝色的较旧的项目格式提示会出现,它的更新按钮一次把所有笔记带到当前版本,与 0.8.0 以来一样。此前写下的关系,读取与显示都和从前一样,只有在下次保存包含它的那篇笔记时,表单才会要求补上缺少的对象。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.8.1...0.9.0
0.8.1
Source hygiene
- The line that closes off the vocabulary browser after a search that found nothing now follows a class the plugin puts on the browser, rather than a
:has()selector that asks what the browser contains. The plugin review warns against those, because the browser re-checks them broadly as the page changes.
Nothing behaves differently. This release exists so the published stylesheet passes the review's CSS lint.
Compatibility: Obsidian 1.13.0 or later.
源码规范
- 词表搜索一无所获时收起分隔线的样式,现在依据插件为浏览区标注的类,而不再用询问其内容的
:has()选择器。插件审查对这类选择器提出警告,因为页面变化时浏览器需要大范围地重新检查它们。
行为没有任何变化。本次发布只为让公开的样式表通过审查的 CSS 检查。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.8.0...0.8.1
0.8.0
The world around your story
- Worldbuilding joins the workspace. Time, location and item notes live beside characters and scenes as members of the project, each kind with its own folder, its own table in the dashboard, its own Bases view, and the same form as everyone else. An entity carries aliases, categories, a progress status and a description, and its note reads like any other: properties above, a generated overview in the body, your prose below.
- Any member can carry world status and relationship record lines: sentences whose terms are links, edited as cards in the form and stored as ordinary Markdown callouts. Pickers create what does not exist yet, so a status like Injured when Battle of Red Valley is written in one motion.
- Every kind keeps three vocabularies, grown as folder trees: categories, world statuses and relationships. Each entry is a folder holding a note named after it, so links resolve like any other link and the graph shows entries under their own names. Three rail panes browse the trees across all five kinds, rename entries with every reference rewritten, and name the cost before a deletion.
- A character's role is one of its categories now. Major, Supporting and Minor are seeded in the project's language, deeper entries are yours to shape, and the character base groups by the role link.
- A scene's time and place are notes rather than words, picked the way its cast is picked and created from the field when missing.
- The health check follows every note a project names, and each repair mends exactly what its report counted. Unreadable record lines are kept as written and reported, never rewritten.
- One blue notice, Older project format, appears whenever any note was written by an older release, whatever its kind. Its Update button brings all of them current in one pass, the command Update notes in older format does the same from the palette, and running either again changes nothing. The plugin's own templates keep themselves current silently, including 061, the worldbuilding template that completes the set.
- Big projects feel light. While nothing has changed, repeated project loads are answered from one snapshot, so at three hundred characters and three thousand scenes the interactions that each cost a third of a second now cost about a millisecond.
On upgrade: nothing happens by itself. The plugin's generated files quietly bring themselves current, and your notes wait for the Update button. One click converts them all, and your prose is never touched.
Compatibility: Obsidian 1.13.0 or later.
故事周围的世界
- 世界观加入工作区。时间、地点与物品笔记作为项目成员与角色、场景并肩存在,每一类都有自己的文件夹、工作台中的表格、数据库视图,以及与其他成员相同的表单。条目可以有别名、类别、进度状态与描述,笔记的样子也与其他笔记一致:属性在上,生成的概览在正文中,你的文字在其后。
- 任何成员都可以书写状态与关系记录行:以链接为词项的句子,在表单中以卡片编辑,以普通 Markdown 标注块存放。选择器可以当场创建尚不存在的对象,一句「受伤,当 红谷之战」一气呵成。
- 每一类成员都有三份词表,以文件夹树生长:类别、状态与关系。每个词条都是一个文件夹,其中有一篇与它同名的笔记,因此链接与其他链接一样解析,关系图中的词条也以自己的名字出现。侧栏的三个词表面板可以跨全部五类浏览这些树,重命名时改写所有引用,删除前先说明代价。
- 角色的定位改为它的一个类别。主角、配角与次要角色按项目语言预置,更深的词条由你自定,角色数据库按定位链接分组。
- 场景的时间与地点是笔记而不再是文字,选择方式与出场角色相同,不存在的可以就地创建。
- 健康检查会追随项目提到的每一篇笔记,每一项修复只修补报告数出的那些。读不懂的记录行会原样保留并报告,绝不改写。
- 一条蓝色的提示「较旧的项目格式」会在任何笔记出自旧版本时出现,无论它是哪一类。它的「更新」按钮一次把它们全部带到当前版本,命令「更新旧格式的笔记」在命令面板中做同样的事,重复运行不会改变任何东西。插件自己的模板会静默保持最新,包括补齐整套的 061 世界观模板。
- 大项目也很轻快。项目未发生变化时,重复的加载由同一份快照直接作答,在三百个角色与三千个场景的规模下,此前每次要三分之一秒的操作如今只需约一毫秒。
升级提示:不会有任何事情自行发生。插件生成的文件会静默保持最新,你的笔记则等待「更新」按钮。一次点击就能全部转换,你写下的文字不会被触碰。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.7.0...0.8.0
0.7.0
Your fields, in the note and in your language
- Character and scene notes now show their fields in the note body, as an overview above the writing. The labels and the values are in the project's language, the point of view and the cast are links, and the whole block is generated from the note's own properties. It is ordinary Markdown, so it reads the same in reading view, live preview and source mode, and it stays readable with the plugin turned off. The Properties panel cuts long key names short and shows them in English whatever the project language, which is what this answers.
- The overview keeps itself current. Editing a field in the dashboard or in the Properties panel rewrites it, and text typed into the block is put back the way the properties have it. The editor refuses edits inside the block and says where to make them instead.
- Existing notes gain their overview when you ask for it. A line above the character and scene tables counts the notes written before this and adds the overview to all of them at once, and the command Write field overviews into character and scene notes does the same for the current project. Until then those notes keep working from their properties, and none of them is reported as damaged.
- A scene's conflict is stored as a property rather than as a section of prose, which is what lets the scene table, the search, the base views and the overview all show the same thing.
- The generated base views grow. Opening one adds a column for any property the notes carry that the base does not list yet, including a property you add yourself, and leaves the columns and views you arranged as they were. Restore base, in the menu beside Open base, rewrites one from the current template after asking.
- The scene base lists the conflict and translates the two points of view that name no character, and All Characters lists every field of the sheet.
- Repairing a note that is open in an editor works without turning boundary protection off first, and opening a step note from the dashboard brings its section to the middle of the page.
On upgrade: your notes are left exactly as they are. New characters and scenes carry the overview from the start, and the ones you already have gain it when you choose to add it.
Compatibility: Obsidian 1.13.0 or later.
你的字段,写在笔记里,也说你的语言
- 角色笔记与场景笔记现在会在正文中显示自身的字段,作为写作区上方的一份概览。标签与取值均使用项目语言,视点人物与出场角色为链接,整块内容由笔记自身的属性生成。它是普通的 Markdown,在阅读视图、实时预览与源码模式下呈现一致,停用插件后依然可读。属性面板会截断过长的键名,且无论项目语言都只显示英文,这正是此概览所要解决的。
- 概览会自动保持最新。在工作台或属性面板中修改字段都会重写它,直接在块内输入的文字则会按属性中的内容还原。编辑器会拒绝块内的编辑,并提示应该去哪里修改。
- 已有笔记可按需获得概览。角色表与场景表上方会出现一行提示,统计此前写下的笔记数量,并一次性为它们全部添加;命令「将字段概览写入角色与场景笔记」对当前项目做同样的事。在此之前,这些笔记照常依据属性工作,也不会被报告为损坏。
- 场景的冲突改为存放在属性中,而不再是一段正文区段,这样场景表、搜索、数据库视图与概览显示的才是同一份内容。
- 生成的数据库视图会自动扩充。打开数据库时,笔记中存在而数据库尚未列出的属性都会新增一列,包括你自行添加的属性,而你排布过的列与视图保持原样。「打开数据库」旁的菜单中新增「重置数据库」,询问后按当前模板重写该数据库。
- 场景数据库新增冲突列,并翻译两种不指向具体角色的视点;「全部角色」视图列出角色表的全部字段。
- 修复正在编辑器中打开的笔记时,无需先关闭边界保护;从工作台打开步骤笔记时,对应区段会被带到页面中部。
升级提示:你的笔记保持原样。新建的角色与场景从一开始就带有概览,已有的笔记则在你选择添加时获得。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.6.0...0.7.0
0.6.0
Member tables at any size
- The character and scene tables scroll the whole list, drawing only the rows in view, so three hundred characters or three thousand scenes cost the dashboard nothing. The steps that share a table share its position: move between steps 3, 5 and 7, or between 8 and 9, and the same rows stay on screen.
- A search box and a filter above each table. Characters answer to their name, type and storyline, scenes to their name, point of view, time, location, conflict and cast. Narrow the characters to one type, or the scenes to one point of view, and a count says how much of the list remains.
- Every row's menu moves it exactly: Move up, Move down, Move to position… by number, and Move after…, which finds the destination by name. Insert character after and Insert scene after put a new entry directly below the row instead of at the end of the list. All of these carry over any distance, and keep working while a filter is on.
- The character table numbers its rows, both tables stand on the same columns, they reach the bottom of the window, and storylines and conflicts are shown in full rather than cut to one line. The scrollbar runs beside the table, under its header.
- Opening a project reuses the notes already parsed while their files stand unchanged. A dashboard that took a second to open at three thousand scenes now opens in a tenth of one.
- Walking into a long chapter with the arrow keys holds the crossed rule still until the chapter has finished measuring itself, so the landing no longer drifts while the chapter settles.
On upgrade: nothing changes in your notes, frontmatter or project files.
Compatibility: Obsidian 1.13.0 or later.
任意规模的角色表与场景表
- 角色表与场景表滚动整份列表,只绘制视野内的行,三百个角色或三千个场景对工作台毫无负担。共用同一张表的步骤共享位置:在第 3、5、7 步之间或第 8、9 步之间切换,屏幕上仍是同样的那几行。
- 每张表上方新增搜索框与筛选器。角色可按姓名、类型与一句话故事概述查找,场景可按名称、视点、时间、地点、冲突与出场角色查找。筛选器可将角色限定为某一类型、场景限定为某一视点,右侧的计数显示列表还剩多少条。
- 每一行的菜单都能精确移动它:「上移」「下移」、按序号「移动到位置…」,以及按名称查找目标的「移动到某项之后…」。「在其后插入角色」与「在其后插入场景」把新条目放在这一行下方,而不是列表末尾。这些操作可跨越任意距离,筛选时也照常可用。
- 角色表也有了顺序列,两张表使用同一套列宽,占满窗口的剩余高度,一句话故事概述与冲突完整显示,不再截成一行。滚动条位于表格旁、表头之下。
- 打开项目时,文件未变的笔记沿用已解析的结果。三千个场景下原本要一秒才能打开的工作台,如今十分之一秒即可。
- 用方向键走进较长的章节时,被跨过的那条线会保持不动,直到该章完成自身的测量,落点不再随章节的调整而漂移。
升级提示:本次发布不改动任何笔记、frontmatter 与项目文件。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.5.1...0.6.0
0.5.1
Source hygiene
- The fading and hiding that focus mode lays over the app now follow classes the plugin puts on each pane, rather than
:has()selectors that ask what a pane contains. The plugin review warns against those, because the browser re-checks them broadly as the page changes.
Nothing behaves differently. This release exists so the published stylesheet passes the review's CSS lint.
Compatibility: Obsidian 1.13.0 or later.
源码规范
- 专注模式覆盖在应用上的淡化与隐藏,现在依据插件为每个窗格标注的类,而不再用询问窗格内容的
:has()选择器。插件审查对这类选择器提出警告,因为页面变化时浏览器需要大范围地重新检查它们。
行为没有任何变化。本次发布只为让公开的样式表通过审查的 CSS 检查。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.5.0...0.5.1
0.5.0
Typewriter scrolling and focus mode
- Typewriter scrolling: the line you are writing stays at the middle of the page, and the page moves under it. A mouse click still leaves the words you clicked under the pointer, and the centring takes over at your first keystroke. On by default, with a button in every chapter's header and a command to turn it off and on.
- Focus mode: while you write, everything except the paragraph you are writing fades. That covers the rest of the note, the neighbouring notes, and the rest of the app. Its four levels each reach further than the last: on keeps the dashboard bright, deep fades it with everything else, and solo shows nothing but the manuscript in full screen, with note paths and order numbers hidden and the side panes folded away. The button in every chapter's header walks the levels, four palette commands name them directly, and the slider under Manuscript stream explains each level as you choose it. Leaving the stream restores the app, and coming back restores the mode.
- The arrow keys walk from one note into the next. Up or down on a note's first or last row, or left or right at its first or last character, carries the caret over the rule into the neighbouring note, and the rule you cross stays exactly where it was on screen.
- An arrow pressed while the caret is scrolled off the page brings the page back to the caret in one measured move. The editor used to answer with its own scrolling, reckoned against a page the sliding window had already changed, and a single press could throw you across several notes.
- Scrolling far enough to slide the window no longer drops the keyboard out of the note you are writing. Only the notes that actually changed places move now, so the editor holding your caret is never lifted out of the page mid-write.
- The settings under Manuscript stream have shorter names and one-line descriptions, and the two sliders are drawn alike.
On upgrade: typewriter scrolling starts on. Turn it off from any chapter's header or under Settings → Manuscript stream if you prefer the page to stay still. No notes, frontmatter or project files change.
Compatibility: Obsidian 1.13.0 or later.
打字机滚动与专注模式
- 打字机滚动:你正在写的一行保持在页面中部,移动的是页面。鼠标点击仍会把你点的词留在指针下,从你第一次按键起开始居中。默认开启,每一章的标题栏里都有它的按钮,也可用命令开关。
- 专注模式:写作时,除你正在写的段落外,其余一切都会淡化,包括本篇的其余部分、相邻的笔记与应用的其余界面。四档逐级加深:「开」保持工作台明亮,「深度」让工作台一并淡化,「仅正文」则全屏只显示正文,并隐藏笔记路径与顺序编号、收起两侧面板。每一章标题栏中的按钮逐级切换,四条命令可直接设为某一档,正文流设置中的滑杆会在你选择时说明每一档的含义。离开正文流时应用恢复原样,回来时模式随之恢复。
- 方向键可以从一篇笔记走进下一篇。在第一行或最后一行按上下键,或在第一个或最后一个字符处按左右键,光标便越过分隔线进入相邻的笔记,而你跨过的那条线在屏幕上保持不动。
- 光标被滚出页面后按方向键,页面会以一次测量好的移动回到光标处。此前编辑器按自己的推算滚动,而滑动窗口早已改变页面,一次按键就可能把你甩过好几篇笔记。
- 滚动到让窗口滑动的程度,不再使键盘脱离你正在写的笔记。现在只有真正换了位置的笔记才会移动,承载光标的编辑器不会在写作途中被抬离页面。
- 正文流下的设置更为简洁:名称更短,描述一句一行,两个滑杆的样式一致。
升级提示:打字机滚动默认开启。若希望页面保持不动,可在任意一章的标题栏或 设置 → 正文流 中关闭。本次发布不改动任何笔记、frontmatter 与项目文件。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.4.1...0.5.0
0.4.1
The word you clicked is the word you get
- Click a word in the manuscript and the caret lands on it, even where Markdown syntax sits between the words you clicked. Prose reaches the page without its emphasis marks, heading marks, link targets or the newline of a soft break, so any passage crossing one of them could not be found in the file, and the caret was placed by the height of your click instead — landing further from the word the longer the chapter, and worst at the end of one. The words are now matched against the file with its syntax set aside.
- Clicking beside a short stretch of bold, or a link, no longer sends the page to the top of the note. The words looked for stopped at the edge of whatever you clicked, and a stretch too short to search for left nothing to go on.
- A chapter that repeats a sentence takes the copy you clicked rather than the first one in the note.
- The line between two notes offers what the manuscript allows now, rather than what it allowed when that line was drawn. A project of one note that had grown a second kept telling you there was nothing to merge until you closed the stream and opened it again, and the name a merge offered stayed the name that note had when the line was drawn.
- The line above the first note offers to insert one, the way the line below every other note does. It was the only line in a manuscript that offered nothing.
- The last seven tooltips drawn by the browser are the plugin's own: a note's path in the manuscript, the note offered on step 10, a character's name and one-sentence storyline, a scene's name and conflict, and the tags in a picker.
- The type checker now holds the source to the language version the plugin states. A Node type declaration was lending it a method newer than that version, which would have compiled and shipped without anything saying so. Nothing behaves differently.
Nothing to do on upgrade: this release changes no notes, no frontmatter and no settings.
Compatibility: Obsidian 1.13.0 or later.
点中哪个词,光标就落在哪个词
- 点击正文中的某个词,光标就落在它上面,即使所点的词之间夹着 Markdown 语法也是如此。正文显示在页面上时不带强调标记、标题标记、链接地址,也不带软换行的换行符,因此凡是跨过它们的片段都无法在文件中找到,只能改按点击的高度放置光标——章节越长,落点离那个词越远,在一章的结尾处最为明显。现在会把这些词与撇开语法后的原文比对。
- 在一小段加粗或链接旁边点击,不会再把页面甩到笔记顶端。此前用于查找的词只截取到所点内容的边界,而一小段太短,便无从查起。
- 一章中重复出现的句子,取你点中的那一处,而不是笔记中的第一处。
- 两篇笔记之间的那条线,提供的是此刻正文允许的操作,而不是这条线画出来时允许的。原本只有一篇笔记、后来新增了第二篇的项目,那条线仍说没有可合并的内容,除非关掉正文流再打开;合并所给出的名称,也停留在画线那一刻那篇笔记的名字。
- 第一篇笔记上方的那条线也可以插入笔记了,与其他每篇笔记下方的线一样。此前它是正文中唯一什么都不提供的线。
- 最后七处由浏览器绘制的悬浮提示改用插件自己的提示:正文中笔记的路径、第十步给出的那篇笔记、角色的名称与一句话故事线、场景的名称与冲突,以及选择器中的标签。
- 类型检查会让源码守住插件所声明的语言版本。此前一处 Node 类型声明让源码用上了高于该版本的方法,而这类用法本会毫无提示地通过编译并随插件发布。行为没有任何变化。
升级无需任何操作:本次发布不改动任何笔记、frontmatter 与设置。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.4.0...0.4.1
0.4.0
The whole manuscript as one page
- Read and write a whole draft as one continuous page while every chapter stays its own Markdown note. Click a chapter and it becomes an editor with the caret in the word you clicked; move to another and the first is typeset prose again. The line naming the chapter you are in stays at the top of the page until the next chapter reaches it. If you have used Scrivener, this is its Scrivenings mode, now living in Obsidian.
- A project's manuscript is the notes it has, rather than one note called Draft. Each note records its place in
snowflake-manuscript-sequence, so moving or renaming one never changes where it is read. - Insert a note before or after the one you are reading, cut the one you are writing in at the caret, or merge it into the next. Merging asks first, because it is the only one of the three that takes a note away.
- Ways in from wherever you are: Open manuscript stream on step 10, which returns you to the note you last wrote in, the command palette, and the right-click menu of any manuscript note in the file explorer.
- Ten commands: opening and closing the stream, moving to the next or previous note, returning to where the stream opened, inserting a note on either side, splitting at the cursor, and toggling what each note's line shows. They appear only while a manuscript stream is the view you are in.
- Three settings under Manuscript stream: how many notes are held on each side of the one you are reading, whether a note shows its file path, and whether it shows its stored order number.
- The health check reports manuscript positions that are missing, unreadable, or shared by two notes, and mends all three the same way: it keeps the order the manuscript reads in now and writes it down properly. Nothing below the frontmatter is touched.
- Tooltips are Obsidian's own throughout. Seventeen controls used to carry an accessible label and a browser title at once, so two tooltips were drawn over one another.
- All of it stays quick on a long book. Measured on a vault holding two projects of 1500 chapters, each chapter more than 2000 English words or Chinese characters, these actions run under 20ms on average.
An existing project needs nothing done to it: a single draft note is a manuscript of one, and becomes a manuscript of many the first time you add a chapter.
Compatibility: Obsidian 1.13.0 or later.
把整部正文当作一页
- 把整部初稿当作一页连续读写,而每一章仍是各自独立的 Markdown 笔记。点击某一章,它便就地变成编辑器,光标落在你点的那个词上;转到另一章时,前一章又变回排版后的正文。写着当前章名的那一行会一直停在页首,直到下一章把它顶走。如果你用过 Scrivener,这就是它的 Scrivenings 模式,如今就在 Obsidian 里。
- 项目的正文由它实际拥有的笔记组成,而不再是一篇名为「初稿」的笔记。每篇笔记以
snowflake-manuscript-sequence记录自己的位置,因此移动或重命名都不会改变它被阅读的顺序。 - 可以在正在读的这一章前后插入新的一章、在光标处把正在写的一章拆成两章,或把它并入下一章。合并会先询问,因为三者之中只有它会让一篇笔记消失。
- 随处可进:第十步的打开正文流(会回到你上次写作的那篇笔记)、命令面板,以及在文件列表中右键任意一篇正文笔记。
- 十条命令:打开与关闭正文流、前往下一篇或上一篇、回到正文流打开时所在的笔记、在前后插入笔记、在光标处拆分,以及切换每篇笔记那一行显示的内容。它们仅在当前视图是正文流时出现。
- 正文流下的三项设置:正在读的那一篇每侧各保留多少篇笔记、是否显示笔记的文件路径,以及是否显示它所存的顺序编号。
- 健康检查会报告缺失、无法读取或被两篇笔记共用的正文位置,并以同一种方式修复:保留正文当前的阅读顺序,把它妥善写下。frontmatter 以下的内容不会被改动。
- 全插件的悬浮提示改用 Obsidian 自己的提示。此前有十七处控件同时设置了无障碍标签与浏览器 title,导致两个提示彼此重叠。
- 书再长也依然利落。在一个同时放着两个各 1500 章项目的库中实测,每章都在 2000 个英文单词或中文字以上,上述操作平均不到 20 毫秒。
已有项目无需任何改动:只有一篇初稿时,它本身就是一篇笔记构成的正文;当你添加第一章时,它便成为多篇构成的正文。
兼容性:Obsidian 1.13.0 或更高版本。
Full Changelog: 0.3.2...0.4.0