Browser lookup and offline use

This guide describes the 0.3.1 beta browser interface on the frozen 0.3.0 engine.

The default Latin lookup accepts a word, phrase or sentence. Press Enter or Return to look it up; Shift+Enter inserts a newline. A Look up button supports touch input. Composition events do not submit unfinished input. On a narrow touch screen, a completed lookup dismisses the input keyboard and moves to the results. The New lookup button clears the input and lookup results, then focuses the empty input. It retains the selected lookup mode and display options without reloading the dictionary. Desktop keyboard focus stays in the input for repeated queries. The completion status shows each lookup's Worker processing time in milliseconds; it excludes dictionary loading, message transfer and page rendering.

Macron adaptation

The browser Worker applies latin-macrons-v1 before calling the unchanged legacy engine. It removes combining macrons (U+0304) after canonical decomposition and spacing macrons U+00AF/U+02C9. This handles both precomposed amāre and decomposed ama + combining macron + re, including uppercase vowels and y. Other marks, ligatures, spelling and letter case are not folded. Punctuation and whitespace remain available to the legacy tokenizer; sentences need no manual cleaning.

The input box is never rewritten. The reading view maps lookup spans back to original character clusters, so result headings retain supplied macrons. The structured browser result includes the named adapter, original input, lookup input and UTF-16 span mapping alongside the unchanged engine result. Engine spans and legacy output refer to the lookup input, not the original marked text.

Latin (original input rules), the analysis library and CLI keep the original ASCII-byte behavior, including macron splitting. This lets callers reproduce the reference program. English lookup and the explicitly empty corrected layer do not activate the browser adapter. This input convenience is not a linguistic correction.

Reading meanings

A single analyzed word opens with its full reading view. A Latin passage with multiple analyzed tokens starts with every word collapsed. Each summary retains the supplied spelling, all returned dictionary headings or principal parts, and part-of-speech and inflection labels. Selecting one word reveals its meanings, forms and explanatory rows and closes the previously open word. Repeated words remain separate occurrences in source order. Enter or Space operates a focused summary. English lookup keeps its dictionary entries expanded.

Principal parts are bold. Grammatical labels and form lines are indented to separate them from dictionary headings. Back to top, below the reading results and above additional information, returns to the page title.

Display options contains the unchecked Original WORDS order switch and unchecked-by-default controls for Original text, Structured data, Lookup notes and Validation tools. These controls also update the current results. Checking an information option reveals a closed panel; select its heading to expand it. Unchecking hides and closes the panel. Lookup notes appear in their own panel. Lookup failures remain visible even when their technical diagnostics are hidden. The checkboxes reset when the page is reloaded. Numbered reading labels use 1st decl, 1st and 2nd decl, 3rd conj, and the corresponding other ordinals. Expanded meanings remain available as hints. This browser notation does not modify the frozen structured results or engine.

The original dictionary uses slashes between alternatives within its meanings. The reading view puts those alternatives on separate lines. It preserves their order and words; raw meanings and legacy output retain the original punctuation. This display does not assign new sense numbers or claim editorial correction.

Dictionary frequency order

Latin lookup defaults to Dictionary frequency. Entries use the frequency code of their dictionary record, not the frequency of an inflection rule: A (very frequent), B (frequent), C (common), D (less frequent), E (uncommon), then F (very rare). These are the original dictionary's relative labels, not measured probabilities or a prediction about the sentence. For example, cornu puts the A-rated cornu (horn) before the C-rated cornus (cornel tree). The label beside each entry makes this ordering visible.

Ties preserve original WORDS order. Unspecified frequency (X) and special evidence categories (I, inscriptions; M, graffiti; N, chiefly Pliny) follow ranked entries in their existing order; they are not treated as lower frequency bands. Explanatory rows delimit interpretation groups, so sorting never moves an entry across an affix, compound or heuristic explanation. Form rows stay attached to their entry. Sentence tokens and repeated occurrences keep their input order; English lookup keeps its native ranking.

Check Original WORDS order inside Display options to restore source order in the reading view. Uncheck it to return to dictionary-frequency ordering. Original text and structured data always retain source order regardless of this control. The display does not restore candidates already trimmed by WORDS or discard any returned alternative. See the pinned original frequency definitions.

Offline and mobile

Save offline, beside Night mode, downloads the complete application and dictionary, checks every file and starts a fresh saved analyzer before declaring success. Only then does the progress panel disappear and the same button become Update. The initial page needs no download panel; Offline help in the footer opens the installation guidance and saved status. A newly verified version offers Reload with update. Errors or progress remain visible when attention is needed. A missing or incomplete cache restores the save/repair invitation.

On iPhone or iPad, Safari's Share menu provides Add to Home Screen. Open the saved Home Screen app and save its dictionary there as well; an installed icon alone is not evidence that all resources are cached. Clearing site data removes the saved dictionary and theme preference. The interface supports safe-area insets, keyboard input and touch controls without page-wide horizontal scrolling.

All lookups run on the device. Hosting serves application/data files; the offline bundle reduces repeated transfers. Entered text is not sent to the host.

Appearance and documentation

The default is light mode, independently of the operating system. Night mode switches the theme manually; IndexedDB saves the choice on this browser/device. The same setting applies to the dictionary and its documentation, survives a restart, and works offline. If browser storage is unavailable, the switch still works for the open page and explains that the choice could not be saved.

Footer links open formatted HTML pages with return navigation. These documents, including the original WORDS notice and full AGPL license, are included in the saved offline bundle. The source introduction page offers the complete source archive as an explicit download; that archive requires a connection.

Stable pages and offline updates

Bookmark the dictionary or any help page directly. Page addresses remain the same across releases; older versioned page links redirect to the corresponding permanent page. Each loaded page uses its own immutable application and dictionary resources.

After Save offline, the header offers Update. When a newer release is found on opening, refocusing or reconnecting, the saved app shows a notice. Choose Update to download it. Every file is checked and a sample analysis is run before Reload becomes available. Your current input and results remain until you choose to reload. A failed or cancelled download preserves the complete saved version; already open tabs continue using their own resources.

The app installs only when you choose to use your browser's installation feature. Clearing site data removes the offline installation. The browser may reclaim storage when space is low; reconnect and save again if the app reports missing files.