Query: Unlinked Directive

00001007721200 · Ref · Info · (manual) · #manual #zettelstore (all) · Context

The value of a personal Zettelstore is determined in part by explicit connections between related zettel. If the number of zettel grows, some of these connections are missing. There are various reasons for this. Maybe, you forgot that a zettel exists. Or you add a zettel later, but forgot that previous zettel already mention its title.

Unlinked references are phrases in a zettel that mention the title of another, currently unlinked zettel.

To retrieve unlinked references to an existing zettel, use the query {ID} UNLINKED.

# curl 'http://127.0.0.1:23123/z?q=00001012000000+UNLINKED'
00001012921200 API: Encoding of Zettel Access Rights
00001012921000 API: Structure of an access token
00001007721200 Query: Unlinked Directive
00001007770000 Query: Action List
00001008000000 Other Markup Languages

This returns all zettel that references the title of the given Zettel, but does not reference it directly. Please note that the result is typically not sorted by zettel identifier.

In addition you may add phrases if you do not want to scan for the title of the given zettel.

# curl 'http://localhost:23123/z?q=00001012054200+UNLINKED+PHRASE+API'
00001012050600 API: Provide an access token
00001012921200 API: Encoding of Zettel Access Rights
00001012080200 API: Check for authentication
00001012080500 API: Refresh internal data
00001012050200 API: Authenticate a client
00001010040700 Access token
...

This finds all zettel that contain the phrase “API” but do not directly reference the given zettel.

The directive searches within all zettel whether the title of the specified zettel occurs there. The other zettel must not link to the specified zettel. The title must not occur within a link (e.g. to another zettel), in a heading, in a citation, and must have a uniform formatting. The match must be exact, but is case-insensitive. For example “API” does not match “API:”.