Skip to content

0.4.0

Choose a tag to compare

@github-actions github-actions released this 09 Aug 13:45
· 72 commits to main since this release

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