How to Index Keywords
Table of Contents
1 Introduction
2 Let's collect keywords which are:
- links,
- emphasized words, such as emphasis, and
- strong words, such as strong.
A common use of emphasis might be to quote blocks of text.
The challenge arises where the syntax gets messy, with escape characters.
3 The problem
The simplest statement is on the Home or introductory page. An index is not a dictionary. An index allows a reader to go to one place in a document, book, or collection of papers, and find the place or places where a word or phrase is used.
Main pages in the commonplace book may include references the to keywordindex ??
4 data table
Here are the thougnts on data tables to record the keywords.
5 sources
6 keyword
A keyword table holds:
- text – the short phrase to be indexed
- location – URI or link to page, and optionally a name reference
This latter suggests each section generates a name reference, peculiar to the section. I believe I've included this in the table of contents processor.
This table is keyed by the record. (A text item will most often occur in multiple locations).
7 data
The data is found in the source files of the commonplace book pages, and is recorded in the data tables (above). These are distilled into the keywordindex.
These functions are found in the local function library – cblib, and are the basis for a re-imagined index system.
accumWords logWords txtDups cb_init mkd_files txtFollow cb_starter pltnew uniqTxt fnewest textWords foldest to_wlog
The list is produced from txtFollow from the common root $(home), which happens to be my Dropbox folder, and filtered through OrgMode, to produce the candidate list of data files.
8 references
None yet.