README.mediawiki

Table of Contents Ebooksforlib Overview MySQL config MySQL setup Running tests License Repository Sponsors Authors Icons

Ebooksforlib

Ebooksforlib is an ebook portal for libraries.

Overview

• Let patrons log in with their ordinary library credentials
• Discover ebooks through browsing or searching
• Borrow ebooks

Preparation of ebooks for reading as well as a browser-based web-app for reading the books will be provided by related projects.

MySQL config

Search is based on MySQL FULLTEXT indexing, and this probably works better if you turn off stopwords. You might also want to consider allowing search terms as short as 3 chars.

On Debian, add the following to /etc/mysql/my.cnf:

 # Disable stopwords
 ft_stopword_file=""
 # Make it possible to search for 3 letter words
 ft_min_word_len=3

Then restart MySQL.

MySQL setup

Login to MySQL as the root user:

  $ mysql -u root -p

Then create the database and grant access to it:

  mysql> create database <databasename>;
  mysql> grant all on <databasename>.* to '<databaseuser>'@'localhost' identified by '<password>';
  mysql> flush privileges;

Running tests

The code uses Modern::Perl, so in order for Test::Perl::Critic tests to pass, you should include this in your ~/.perlcriticrc file:

 [TestingAndDebugging::RequireUseWarnings]
 equivalent_modules = Modern::Perl

License

See the LICENSE file.

Repository

• https://github.com/MagnusEnger/Ebooksforlib

Sponsors

• Buskerud county library
• Oslo public library

The sponsors have received grants from the National library of Norway.

Authors

• Magnus Enger (Libriotech)

Icons

"Silk Icons" courtesy of famfamfam.com