timeline is a simple, single-purpose filter: it sorts a list of found documents output by grazer by date. It's for collections (in my case, e-mail messages) whose "natural" document order may be more interesting than their relevance for the current search.

timeline places some restrictions on grazer output: it should not have prolog nor epilog (move your definitions from grazer options to timeline options to keep them) and it must have markers between document descriptions.

timeline uses options from section locus to get to the appropriate database and its own section timeline.

section timeline
nametypeimplicit value
doc_dividerstring"<!--found-->\n"
Document description delimiter; timeline input is divided into pieces between matches of this regular expression. Note that the delimiter itself is eaten by timeline - make it something which won't be missed in the final output.

date_rxstring
"[SMTWF][a-z][a-z], [0-9][0-9]?
[FMJASOND][a-z][a-z] (19|20)"
Extracts a date from the document description. If there's more than one match, the first is used. Non-matching descriptions are dropped.

date_formatstring"%a, %d %b %Y"
Format passed to strptime() to convert a date from string representation to number.

prologstring"<html>\n<ul>\n"
String printed before sorted document descriptions.

epilogstring"</ul>\n</html>\n"
String printed after sorted document descriptions.

Example

[timeline]
prolog = "<table>\n"
epilog = "</table>\n"

[grazer]
title_parts = "subject" "date"
parse_parameter = yes

starting_search_template = ""
search_progress_template = ""
prolog_template = ""
epilog_template = ""
#<!--found-->\n is (the default) document delimiter
doc_title_template = "<!--found-->\n<tr><td>%4<td>
    <a href=/cgi-bin/cut.cgi?mail+%0+%1>%3&nbsp;</a>\n"
clot_head_template = ""
clot_break_template = ""
clot_tail_template = ""
passage_template = ""
highlighted_passage_template = ""

Top: locus homepage