This post is part of an evolving series that can somewhat usefully be read in order.
- Outlining with Notenik (this post)
- Automatically Incrementing Sequence Numbers
- Incrementing an Existing Sequence Number
- Indentation to Show Outline Levels
As I’ve mentioned previously, Notenik supports metadata. And different sorts of fields can be used for different purposes.
In many cases, you will want to sort the Notes in a Collection by some field that contains data about the Note — something like Title or Author or Date, let’s say.
In other cases, though, you will want to impose some organizational sequence on a Collection of Notes based on the relationship between the Notes, or on some logical sequence that is not apparent from any of the metadata about the Note.
This is when you would want to use the Seq field.
A Seq field contains artificial values — values that you assign simply to get your Notes into whatever sequence is meaningful to you.
As you’re assigning such values, you will want to change the Sort sequences for your Collection to Seq + Title
, or some other sort sequence making use of the Seq field, so you can see your Notes in the sequence you have assigned to them.
And then, to refine this approach a bit more, you can use the Level field to organize some Notes as being subordinate to others.
By combining these two fields — Seq and Level — you can structure your Notes into a hierarchy usually referred to as an outline.
When fashioning an outline, you will generally want your Seq values to reflect your outline structure. That is, you will want your top level Notes to be numbered consecutively and then, within each parent item, you will want your children numbered consecutively, with a period (aka dot or full stop) separating each parent number from the numbering of its children. This numbering can be done recursively, to as many levels as you would like.
You’ll note that the Notenik Knowledge Base is structured in this fashion, using an outline. The Knowledge Base is one of several Notenik Collections stored within the NotenikDocs
repo on GitHub. You can always download the repo from GitHub if you’d like to inspect a working example of such an outline.
As it happens, Notenik seems to support Seq numbering in conformance with ISO 2145.
Oh and by the way, feel free to use upper- or lower-case letters [a..z] instead of numbers, if you would like.
I’ll share more Notenik outlining tips in future Adventures, but this should be enough to whet your appetite.