#! /usr/bin/python3

import sys, re
import html_gen as h
from process_funcs import bash
import html_report_funcs as hr

last_edit = "Last edited on 2026-01-12 17:22:02 by stolfi"

def main():

  global last_edit
  
  title = "Glossary of general terms"
  st = h.new_doc(title, "#eeffdd")

  h.section(st, 2, "Glossary of general terms")

  h.begin_enum(st, "ul")

  h.enum_item_parags(st, """<b>panel</b>: one of the sections of a folio
    delimited by physical edges of the parch, folds, or the binding.""")

  h.enum_item_parags(st, """<b>page</b>: One or more adjacent panels
    that function as a single page, with text and/or drawings running
    across the panel boundaries. In the SPS, each page spans a single
    panel, so the two terms are basically synonymous.""")

  h.enum_item_parags(st, """<b>parag</b>: short for paragraph;""")
    
  h.enum_item_parags(st, """<b>locus</b>: a unit of Voynichese text, such as a line in a parag, a 
    text ring, a label, a title, etc.""")

  h.enum_item_parags(st, """<b>locator</b> or <b>locus ID</b>: a pair
    <b><</b><i>page f-number</i><b>.</b><i>line number</i><b>></b>, like
    <b><f108r.07></b>, that identifies a locus in a transcription file.
    Note that Rene uses "locator" with a different meaning (an
    indication of the relative position of the locus in a group of
    loci).""")

  h.enum_item_parags(st, """<b>head</b> of a parag: its first line.""")

  h.enum_item_parags(st, """<b>tail</b> of a parag: its last line""")

  h.enum_item_parags(st, """<b>puff</b>: a one-legged gallows, either
    {p} or {f}, with or without the platform slash. (In the ';U' subset
    of the transcription file, the hooked variants of {p} and {f} are
    denoted {w} and {z}, respectively.)""")

  h.enum_item_parags(st, """<b>puffed</b> line: a line containing one 
    or more puffs.""")

  h.enum_item_parags(st, """<b>pufftial</b>: an occurrence of any of the
    glyphs {p}, {f}, or {t} at the start of a text line.""")

  h.enum_item_parags(st, """<b>margin</b>: the mostly text-free space
    between an edge of the page and the text.""")

  h.enum_item_parags(st, """<b>left rail</b>: the ideal line, mostly
    vertical and straight, that runs just to the left of the majority of
    lines of a page, separating the left margin from the text.""")

  h.enum_item_parags(st, """<b>right rail</b>: the ideal line, mostly
    vertical and possibly wavy but reasonably smooth, that runs just to the
    right of the ends of most lines of a page, separating the text from
    the right margin.""")

  h.enum_item_parags(st, """<b>long line</b>: a text line that starts at
    the left rail ends at or beyond the right rail.""")

  h.enum_item_parags(st, """<b>short line</b>: a text line that starts
    at the left rail but ends well before the right rail.""")

  h.enum_item_parags(st, """<b>baseline</b>: the ideal line., usually
    smooth and somewhat curved, that runs just below the glyphs of a
    text line, cutting off the tails of {y}, {m}, {l}. etc..""")

  h.enum_item_parags(st, """<b>linegap</b>: the vertical distance
    between baselines of successive lines; which often varies over the
    width of the text.""")

  h.enum_item_parags(st, """<b>wide linegap</b>: a line gap that is
    wider than normal, at least in some part of the lines (e.g. left
    side, right side, or middle).""")

  h.enum_item_parags(st, """<b>o-height</b>, <b>oht</b>: the height
    of an EVA {o} in the local handwriting.""")

  h.enum_item_parags(st, """<b>topline</b>: an ideal line parallet to
    the baseline, such that the distance between the two is the o-height.""")

  h.enum_item_parags(st, """<b>midline</b>: an ideal line parallel to
    the baseline and the topline, equidistant from the two.""")

  h.end_enum(st, "ul")

  h.parags(st, """
  While the left and right rails are generally smooth curves, they
  occasionally have abrupt discontinuities. For example, on page f112r,
  the right rail is indented by ~3 cm in the span from line 2 to line
  22, with abrupt transitions at both ends. In that range, it wanders
  more than usual and it may be uncertain whether a line ends on it or
  before it. Likewise, on page f112v, the left rail is generally tilted ~4° 
  clockwise from vertical, and has two abrupt discontinuities at lines 11 and 
  23.""")

  # hr.links_section(st)

  h.output_doc(st, sys.stdout, 0, last_edit)
  return 0
  # ----------------------------------------------------------------------

main()