File | Date | Author | Commit |
---|---|---|---|
screenshots | 2017-03-16 |
![]() |
[63201d] screenshots |
server | 2017-03-23 |
![]() |
[6b51c4] websockets ok if you are surfing localhost; not... |
.gitignore | 2017-02-05 |
![]() |
[01ac2a] publish .gitignore |
LICENSE | 2016-09-22 |
![]() |
[798b19] first (re)commit |
NEEDS_DEBUGGING.txt | 2017-03-15 |
![]() |
[c88776] activepoll.sessionstate set on initialization: ... |
README.md | 2017-03-08 |
![]() |
[fe791a] calculatewordweights is its own file; dbHeadwor... |
hipparchiaserver_function_and_class_list.txt | 2017-03-04 |
![]() |
[27eed8] update functionlist |
run.py | 2017-03-10 |
![]() |
[7a90d6] SUPPRESSCOPYRIGHTNOTICE config option added; co... |
sample_config.py | 2017-03-22 |
![]() |
[563c24] max/min |
a front end to the database generated by HipparchiaBuilder
key features:
searching
search multiple corpora simultaneously
build search lists with according to a variety of criteria
search by date range
add/exclude individual authors
add/exclude individual author genres
add/exclude individual works
add/exclude individual work genres
add/exclude individual passages
add/exclude individual author locations
add/exclude individual work provenances
include/exclude spuria
include/exclude undateable works
remove items from the list by "dragging to trash"
store and load search lists between sessions
reset sessions to configurable defaults
search syntax
search with or without polytonic accents
wildcard searching via regular expressions
phrase searching: "κατὰ τὸ ψήφιϲμα", etc.
proximity searching:
within N lines or words
not within N lines or words
results
results can be limited to a maximum number of hits
results can be limited to one hit per author/work
results can be sorted by name, date, etc
can set amount of context to accompany results
tools
browser
browse to any passage of your choice
browse to any passage that occurs as a search result
skim forwards or backwards in the browser
click on words to acquire parsing and dictionary info for them
dictionaries
look up individual words in Greek or Latin
get a morphological analysis of a Greek or Latin word
get per corpus counts of the use of the word and its derivatives
get a weighted chronological distribution of the word's use: mostly 'early', etc.
get a weighted distribution by top 5 genres: show if a word predominantly 'epic', etc.
get a summary of uses, senses, and quotes
reverse lookup: 'unexpected' returns ἀδευκήϲ, ἀδόκητοϲ, ἀδόξαϲτοϲ, ἀελπτία, ...
click to browse to passages cited in the lexical entries ('often' works)
text maker
build a text of a whole work or subsection of a work
for example see Xenophon, Hellenica as a whole or just book 3 or just book 3, chapter 4
index maker
build an index for a whole author, work or subsection of a work
for example see an index to all of Vergil or just the Aeneid or just Book 1 of the Aeneid
local/contextual information
searches give progress updates in percentage complete and time elapsed
concordance builds give progress updates in percentage complete and time elapsed
search lists can be inspected/hidden before execution
local info on current author can be shown/hidden
local info on genre lists can be shown/hidden
show/hide the settings pane
show/hide the complex criteria setter
show/hide the complex search dialog boxes
hover over interface items to get tooltips
misc
search will attempt to choose the most efficient strategy for any given situation
text layout in results/browser/text maker sensitive to shifts in font face and size
text layout via CSS: possible to modify the style sheet to suit your own tastes
configurable defaults for most options
unicode support of technical, rare, and exotic characters (that you can also search for: 𐆂,𐄒, 🜚)
forward-compatible unicode: attempt to properly code characters which are not yet available in most fonts
known unknowns: unhandled characters preserve their betacode messages in the metadata for future fixes
HipparchiaServer typically runs from the command line within a python virtual environment
% python ./run.py
then you point your browser at http://localhost:5000
alternately you can hook HipparchiaServer to something like nginx via uwsgi. that would create a different url
it would be rather unwise to expose this server to the whole internet. there are many elements to this unwisdom.
let us only mention one: there are security checks inside Hipparchia, but many queries can be generated that would
consume vast computational resources. what would happen if 1000 people tried to do that to your machine at once?
your inability to execute these queries on the tlg web site is partially a function of their choice to
adopt a one server and many clients model.
of course, most queries take <2s to execute. but servers live in the worst of all possible worlds.
instructions on how to use Hipparchia can be found by clicking on the '?' button if you can make it to the front page.
minimum software requirements:
to launch HipparchiaServer
python 3.6
pip
flask
psycopg2
bs4
postgresql9.5
to properly interact with HipparchiaServer via a browser
jquery
jquery-ui
js-cookie
dejavu fonts [strongly recommended, not a hard requirement]
please see HipparchiaBSD about setting up python and postgresql9.
the project pages for the other dependencies:
jquery:
http://jquery.com/download/
jquery-ui:
http://jqueryui.com/download/
js-cookie:
https://github.com/js-cookie/js-cookie/releases
dejavu fonts:
https://github.com/dejavu-fonts/dejavu-fonts/releases
see HipparchiaBSD for details on how to acquire and to install these items.
[details in 00_FreeBSD_initial_setup.txt or 01_macOS_hipparchia_installation.txt]