| commit | d5d7020533019c834497a47378b2987cfa1b595c | [log] [tgz] |
|---|---|---|
| author | Akron <nils@diewald-online.de> | Mon Aug 01 19:56:30 2016 +0200 |
| committer | Akron <nils@diewald-online.de> | Mon Aug 01 19:56:30 2016 +0200 |
| tree | 1a4e68bbada224aba9e291847e827e95e3ab9565 | |
| parent | 0c87a5ed5696ca8241acfdecc410ca4a182762f6 [diff] |
Improve installation instruction
- dev/
- lib/
- script/
- t/
- templates/
- .gitignore
- Changes
- Gruntfile.js
- kalamar.conf
- kalamar.dict
- LICENSE
- Makefile.PL
- package.json
- README.md
Kalamar is a Mojolicious-based user interface frontend for the KorAP Corpus Analysis Platform.
! This software is in its early stages and not stable yet! Use it on your own risk!
INSTALLATION
Setup
To fetch the latest version of Kalamar ...
$ git clone https://github.com/KorAP/Kalamar $ cd Kalamar
Generate Static Asset Files
To generate the static asset files (scripts, styles, images ...), you need NodeJS > 0.8 and npm. For processing Sass, you will need Ruby with the sass gem in addition. This will probably need administration rights.
$ npm install $ grunt
Start Server
Kalamar uses the Mojolicious framework, that expects a Perl version of at least 5.10.1. The recommended environment is based on Perlbrew with App::cpanminus.
Some perl modules are not on CPAN yet, so you need to install them from GitHub. The easiest way to do this is using App::cpanminus. This will probably need administration rights.
$ cpanm git://github.com/Akron/Mojolicious-Plugin-Search.git $ cpanm git://github.com/Akron/Mojolicious-Plugin-Localize.git
Then install the dependencies as always and run the test suite. There is no need to install Kalamar on your system.
$ cpanm --installdeps . $ perl Makefile.PL $ make test
or
$ cpanm .
Kalamar can be deployed like all Mojolicious apps. The easiest way is to start the built-in server:
$ perl script/kalamar daemon
Kalamar will then be available at localhost:3000 in your browser.
! By default, Kalamar tries to connect to the KorAP API at the IDS. You may not have access to this server!
COPYRIGHT AND LICENSE
Bundled Software
ALERTIFY.js is released under the terms of the MIT License. Almond is released under the terms of the BSD License. dagre is released under the terms of the MIT License. Highlight.js is released under the terms of the BSD License. Jasmine is released under the terms of the MIT License. RequireJS is released under the terms of the BSD License. Font Awesome by Dave Gandy is released under the terms of the SIL OFL 1.1.
Original Software
Copyright (C) 2015-2016, IDS Mannheim
Author: Nils Diewald
Kalamar is developed as part of the KorAP Corpus Analysis Platform at the Institute for the German Language (IDS), member of the Leibniz-Gemeinschaft and supported by the KobRA project, funded by the Federal Ministry of Education and Research (BMBF).
Kalamar is free software published under the BSD-2 License.