AutomaticForwardIndex

A ForwardIndex can be maintained automatically, given the right software, and the right metadata. The problem is choosing the right trade-off between features and metadata maintenance efforts.

On the rest of this page, we're going to talk about a hierarchy of nodes. Every node except for the top node has exactly one parent, if this is a tree. If a node can have several parents, this is a semi-lattice, and cannot be trivially linearized. Orphans are nodes without a parent. A parent node has zero to n child nodes. These child nodes are siblings. If the child nodes are ordered, then every node has a next and a previous sibling.

Linearization is the process of arranging all the nodes in a linear fashion. The most obvious example would be printing a wiki as a book, or assembling all the wiki pages into one monolithic web page.

Child has a Pointer to the Parent

The simplest kind of metadata to maintain is to have each node point to its parent.

Parent has Pointers to the Children

An alternative is the reverse situation: Every parent node has a "menu" -- an ordered list of child nodes.

Discussion

I'd be interesting in trying this one day. -- AlexSchroeder

Specify Linearization Separately

The GNU texinfo [1] documentation system produces various output formats; one of them is the Info file that can be browsed using an Info-browser, another one is the TeX file which can be used to print a book. This involves linearization of the nodes. For the Info file, parents have both menus and parent, next, and previous pointers (there is software support to generate the parent menu using the three pointers). For the TeX file, every node specifies its structure level (chapter, section, subsection), and all the nodes are printed in the order they appear in the file.

Here is what the manual has to say about it, however:

You can use node pointers and menus to structure an Info file any way you want; and you can write a Texinfo file so that its Info output has a different structure than its printed output. However, virtually all Texinfo files are written such that the structure for the Info output corresponds to the structure for the printed output. It is neither convenient nor understandable to the reader to do otherwise.

Clearly, this approach involves maintaining a lot of metadata, and the benefits are not very clear.


CategoryLinking

EditNearLinks: CommunityExpectation

Languages: