ontopia-tldr - Tolog Document Retrieval with Ontopia
This documentation refers to ontopia-tldr version 0.1.2
Ontopia::TLDR is an attempt at bridging the gap between the worlds of formal knowledge representation (ontologies, topic maps, etc.) and bibliographic document retrieval (bibliographic databases). It allows for retrieving documents from bibliographic databases (currently, only Midos databases are supported) by means of tolog, Ontopia’s topic map query language.
Ontopia::TLDR comes as a Sinatra application, so all the standard deployment options apply (rackup, Passenger, etc.). However, in order to allow for maximum flexibility, you need to supply your own config.ru file; e.g. (see Ontopia::TLDR for available options):
require 'ontopia/tldr' run ::.set( dbm_file: File.expand_path('../tldr.dbm', __FILE__), xtm_file: File.expand_path('../tldr.xtm', __FILE__), document_keys: %w[YOUR DOCUMENT KEYS], topic_keys: %w[YOUR TOPIC KEYS], title: 'YOUR TITLE' )
Assuming the following directory layout:
/srv/tldr | +-- config.ru | +-- tldr.dbm | +-- tldr.xtm | `-- tmp/
Place your database and topic map files there and adjust their paths in the config.ru file. The tmp/ directory is used by Passenger for the restart.txt file.
To deploy Ontopia::TLDR with Passenger on Apache, create a symlink in the DocumentRoot pointing to the app's public/ directory (this example makes use of current_gem; adjust the paths according to your environment):
/var/www | `-- tldr -> /usr/local/jruby/lib/ruby/gems/shared/current/ontopia-tldr/lib/ontopia/tldr/public
Then put the following snippet in Apache's VirtualHost configuration:
<VirtualHost *:80> ... RackBaseURI /tldr <Directory /var/www/tldr> Options -MultiViews PassengerAppRoot /srv/tldr # <-- This (non-standard) line is important PassengerRuby /usr/local/jruby/bin/jruby # <-- And this one sets the Ruby interpreter to JRuby </Directory> </VirtualHost>
Ontopia::TLDR requires JRuby. It has been tested with jruby 1.7.4 (1.9.3p392) on OpenJDK 64-Bit Server VM 1.6.0_27-b27 [linux-amd64] and jruby 18.104.22.168 (2.2.2) on OpenJDK 64-Bit Server VM 24.79-b02 1.7.0_79-b14 [linux-amd64].
Jens Wille <firstname.lastname@example.org>
LICENSE AND COPYRIGHT
Copyright (C) 2013-2015 Jens Wille
ontopia-tldr is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
ontopia-tldr is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with ontopia-tldr. If not, see <www.gnu.org/licenses/>.