Installation Instructions
- Mac
- Double-click the zip archive to open it and then move the Diogenes application to your Applications folder.
- Windows
- Just double-click on the installer and answer the questions as prompted.
- Linux
- Follow your distribution's usual practice for installing third-party packages.
An Untrusted Application?
Mac and Windows computers will probably complain that Diogenes is an unknown or unidentified application which has been downloaded from the Internet. This simply means that I have not paid an annual fee to Apple and Microsoft to be deemed trustworthy.
On Windows: When starting the installer you may be asked to confirm that you want to run an application from an unknown publisher.
On a Mac: The first time you run Diogenes, you may have to open it in a special way. Look for the Diogenes application in the Finder, and then right-click or control-click on the icon, and choose "Open" from the menu. You will then have to confirm that you want to trust Diogenes. Thereafter, you should be able to run Diogenes as normal, for example from the Launchpad or Dock.
If that does not work, it's probably because you have a setting on that prevents it. To change that, go to System Preferences → Security & Privacy → General. Make sure that under “Allow apps downloaded from”, you have the option “App store and identified developers” ticked. You may need to click on the padlock icon to change this. Then try the steps in the previous paragraph again.
Manual instructions (for experts only)
If your computer is too old to meet the minimum system requirements to install and run the current version of Diogenes, you can still use it if you are willing to enter some commands manually.
The integrated Diogenes application consists of a client, which is like a web browser, and a server that works with the texts. The minimum requirements pertain to the client. Even a very old computer ought to be able to run the server and connect to it with an ordinary web browser. Here are step-by-step instructions, which do presume a small amount of technical knowledge.
-
Download and install Diogenes for your platform.
Alternatively, just download the Diogenes package for Arch Linux, which is just a plain zip file and unzip it wherever you like. Perl is the only prerequisite.
-
Open a Terminal or command-line application. For Macs, this is Terminal.app; for Windows this is cmd/Command Prompt; for Linux it is any terminal.
-
Diogenes needs to know the location of the databases, and if you are running the server manually you will have to put this in a configuration file. Its location depends on your platform:
- Mac
- /Users/USERNAME/Library/Application Support/Diogenes/diogenes.prefs
- Windows
- C:\Users\USERNAME\AppData\Diogenes\diogenes.prefs or C:\Users\USERNAME\AppData\Roaming\Diogenes\diogenes.prefs
- Linux
- ~/.config/Diogenes/diogenes.prefs
-
Edit this file with a plain text editor to indicate the locations of the databases, like so:
tlg_dir "/Path/to/tlg/folder/" phi_dir "/Path/to/phi/folder/" ddp_dir "/Path/to/phi/folder/"
You can put other settings in this file as well, such as:
old_pdf_dir "/Path/to/Oxford Latin Dictionary.pdf" tll_pdf_dir "/Path/to/TLL/open/access/pdfs"
-
Now you are ready to start Diogenes. In the terminal, type the command to run the Diogenes server. You may have to adapt the command if Diogenes was installed or unzipped in a non-standard place:
- Mac
- /Applications/Diogenes.app/Contents/server/diogenes-server.pl
- Windows
- C:\Program Files (x86)\Diogenes\server\diogenes-server.pl
- Linux
- /usr/local/diogenes/server/diogenes-server.pl
-
If the command was successful it should say something like this:
Startup complete. You may now point your browser at this address:
http://127.0.0.1:8888 -
Paste that URL into the address bar of your web browser and you should see the front page of Diogenes.