Other Language: german
HermeneutiX offers a graphical user interface for developing syntactical and semantical analyses of complex (not neccessarily foreign language) texts. You need a Java Runtime Environment (JRE) to run it.
For a list of the latest/upcoming changes and features click here. It is in a separate article, so you can subscribe for this list only instead of the whole wiki page, in case you are interested.
HermeneutiX by default starts up with a new project which comes in the text input view. Basically a couple of projects can be open simultaneously. You can switch between them via the tab bar or the Window menu item. Single projects can be saved to a hmx file and respectively loaded from one.
There is currently no immediate print option available but rather the possibility to export one of the analyses to an image file (recommended: SVG). The image can be viewed and printed by a variety of third party programs (e.g. a modern Web-Browser).
For a more detailed overview of the possible actions take a look at the HmX-Features.pdf
A new HermeneutiX project always starts with the arrangement of the origin text to analyze. Furthermore its language needs to be defined. Because of the analyse´s integrity the latter cannot be changed after beginning the analysis. The selected language determines if the text is aligned from left-to-right or from right-to-left as well as the selectable clause item functions in the syntactical analysis. Thus it is not mandatory to select the actual language. Just choose a language with the same alignment and at least the same syntactical variety.
The font type and size can be adjusted at any time later on. But by pushing the associated button you start the analysis itself and won´t be able to change the selected language again.
In order to avoid the more time-consuming alternative in the syntactical analysis it is recommended to structurize the origin text while in the text input view. Inserting line separators allows you to mark single propositions while tabstops indicate the contained clause items. You can as well just paste a preformatted text and get going.
But beware that you cannot save nor export before you get into the analysis view.
By finishing the text input you begin the analysis and are asked for some project meta information which are all optional. From this moment on you can save and export your project at any time.
Initially you reach the syntactical analysis view.
The first task at hand is to structure your text according to the contained clause items (not necessarily every single word) and propositions. In the analysis view you can accomplish this by means of the clause item context menus (reachable by secondary/right mouse button). Ideally you have already structured you origin text while in the text input view using line separators and tabstops.
The aim of the syntactical analysis is a literal interpretation of the given text. Therefore you determine the functions of the single clause items and check for their counterpart in your translation. Additionally you can assign and verify the clause item functions of the whole propositions by subordinating them to one another.
The button on the left allows you to switch to the semantical analysis at any time, but it is recommended to finish at least the structuring of the propositions first, because later changes in the proposition assignment might drop some branches in your semantical analysis.
The aim of the semantical analysis is a translation that communicates the pristine intended statement of the original author.
It is based on the proposition structure defined in the syntactical analysis. The semantical relations between single or multiple propositions can be represented in a tree structure with their respective roles at each node. Similar to the approach in the syntactical analysis you can subsequently check your translations if they preserve the uncovered semantical relations.
In principle it is a refining of the translation produced in the syntactical analysis in which you can always switch back via the button on the right. Beware that changes in the proposition structure might affect their assigned semantical relations.
The appearance and behavior of HermeneutiX can be customized to a certain extent via the main menu item File > Preferences (if you are using Mac OS X you will find the preferences option in the usual application menu).
If you have any problem or question not covered in the FAQ section please write us a mail (see contact section). That applies for suggestions and change requests as well.
We appreciate all feedback.
In both cases are explicitly no programming skills required! If you are interested please contact us and we will be happy to include your contribution for the benefit of all other users in the next HermeneutiX release as soon as possible.
Question: I just extracted the HermeneutiX.app from its .dmg, but when I open it I get the error message "HermeneutiX.app is damaged and can't be opened".
Solution: Wait for a future release of HermeneutiX or use the workaround: deactivate your Gatekeeper, start HermeneutiX.app and reactivate Gatekeeper (it should remember your decision to start HermeneutiX).
Reason: The Gatekeeper is a anti-malware feature introduced in the latest Mac OS X versions. It only allows the usage of Apps signed with a Apple Developer ID. I am currently investigating this issue. Future releases of HermeneutiX will certainly be signed properly and possibly available via AppStore as well.
Question: Why does the export of my HmX project to JPEG or PNG fail?
Solution: Try a smaller target size or the recommended SVG export. If you need a big rasterized graphic (such as JPEG or PNG) try exporting your project to SVG and convert it with the aid of a more eligible program like an image viewer, image manipulation program (such as GIMP) or your web browser.
Reason: For generating a rasterized image each pixel needs to be calculated separately before potential compressing methods reduce the necessary amount of memory to hold it. If you choose a target size that causes too many pixels to be calculated, the memory assigned to your Java Runtime Environment (JRE/JVM) won´t suffice and causing it to cancel the export job.
Question: Why does the export of my HmX project to SVG (still) fail?
Solution: Get the newest version of HermeneutiX and try again.
Reason: Version 1.12 fixed a bug that aborted the export process without an error message when translation fields (in the exported analysis) were left blank.
Question: Why are my user settings/preferences from the last time I used HermeneutiX reset to their previous values?
Solution: Make sure HermeneutiX is in a directory where it has the permission to write files.
Reason: HermeneutiX stores the user preferences in a file (in the directory where it is located) when the application is closed. If HermeneutiX does not get the required permission from your operating system it simply falls back on the default values on its next start.
Question: I relocated HermeneutiX to another directory. Why are all my settings/preferences gone?
Solution: Copy the file ".options.properties" from the previous directory to the new one.
Reason: HermeneutiX stores the user preferences in this file when the application is closed. Because of the prefixed dot in the file name it is invisible on some operating systems or you just missed to relocate it along with the other files. You can also avoid this problem by copying/relocating the whole directory containing HermeneutiX.