Hope to be able to fold the content of the article(This is machine translation)

This is a topic that comes up now and then, and so there are several existing discussions on the topic that you could read at your leisure.

Online discussions

  • A crash course on outlining, using the User Manual project as example material.

  • Basics of Outlining in Scrivener: this older but shorter post goes over some of the concepts explored in much greater depth in the following links, so I’d start here.

  • Differences Between MS Word Outliner and Scrivener: of course Word is quite different from the example software spoken of thus far, I would say it is in a simplistic design sense quite similar to org-mode and other structural parsers, in that the underlying structure of the document is what generates the outline interface. In Word that is stylesheets, and in org-mode, textual markings (similar to a Markdown-based editor that supports folding would work, such as the late FoldingText, or Typora or Obsidian with plug-ins). So while the technical mechanism is wildly different, the end result is still quite similar, and thus many of the arguments made in that thread are applicable.

  • Scrivener is a Real Outliner: here we more directly discuss how Scrivener compares to traditional outliners, like the classic MORE, Acta, ThinkTank, and in more modern terms, NeO, OmniOutliner and even most mind-mapping tools.

    A way that I like to describe Scrivener in comparison to these is that it is essentially just like them, only its “notes” field is far more powerful and capable of acting more like a word processor (including a simplistic bullet/enumeration feature, which doesn’t help to clarify anything, but we certainly couldn’t do without it)—not to mention the fact that Scrivener has not one, but three different note fields: the main editor, the document notes sidebar and the universal synopsis, the latter of which acts much more like the sort of inline notes you find in outliners.

    When you think of it that way, you wouldn’t generally wish for there to be folding within the notes field attached to each node—but this desire commonly is expressed in Scrivener perhaps because its primary notes field is so much more capable. The inclination becomes to treat Scrivener more like a .docx style document manager, rather than an outliner, despite having nearly all of the tools traditional outliners provide, one level “up” from the text.

  • While these two posts are aimed at the discussion of how “folders” and “files” fit into the outlining model, they also address some fundamental concepts on outlining in general, that may be useful:

  • Originating as a feature request, this exploration on using Section Types as an outlining tool, or a writing tool, illustrates by nature what advantages there are in thinking of the binder as a detailed outline of one’s work.

    It also shows how Scrivener is not only an outliner, but one that is capable of assigning meaning to outline items directly: of saying this item right here, this is an equation, and this one over here is a glossary entry, while this one is a chapter heading. The discussion is a bit more advanced, but once the above has been consumed it can be a valuable way of looking at how the software is designed to be used.

Documentation

I believe that some of the initial friction toward recognising Scrivener’s design as an outliner can be understood as a gap in knowledge about how keyboard-friendly the outlining interface is. The first reaction may be to think of how laborious it would be to stop typing, reach for the mouse, and click on a tiny little button in the footer bar to add a new row, when one can just press return and keep typing in a text editor. Indeed! That would be terrible.

The thing is, the Enter key is just what you would use in the outliner (and binder and corkboard), too. By default it naturally cascades from title to description (synopsis) and back to title for the next item, but if you turn synopses off then one can focus strictly on headings. With a few shortcuts for promoting and demoting items, moving them around and making new ones, one can become as proficient at outlining as they would in a text editor.

So to that end here are some sections of the manual worth skimming:

  • §6.1, What is Outlining?. Perhaps a bit remedial if you are already familiar with the concepts, but in application to the design of Scrivener, it may be of help.
  • §6.3, Using the Binder. This covers almost everything you would need to know about outlining in the software. Of particular interest to the process of outlining itself, the subsections Adding New Items, Selecting Items, Moving and Copying Things Around and Expanding and Collapsing the Tree will be of particular interest.
  • §7.3, Folders are Files are Folders. Getting over the hurdle of thinking in file system terms about the binder, as well as explore whether folders are a tool you want to use while outlining.

Hopefully that gives you a better idea of where we are coming from on this topic. It has less to do with whether or not, in isolation, the concept of folding structural elements in the main editor is useful (it surely would be), but rather that it as a concept is at odds with the overall design of the software—again in the same way folding inside of OmniOutliner or FreePlane note fields would be a bit odd.

5 Likes