I, Librarian - collaborative PDF manager, which enables researchers, scholars, or students to create an annotated collection of PDF articles.
Clone or download
Pull request Compare This branch is 112 commits behind mkucej:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
css
fonts
img
js
library
m
.gitignore
.htaccess
README.md
about.php
addarticle.php
advancedsearch.php
ajaxclipboard.php
ajaxdesk.php
ajaxdiscussion.php
ajaxdisplay.php
ajaxemail.php
ajaxfilter.php
ajaxjournals.php
ajaxleftindex.php
ajaxlog.php
ajaxrating.php
ajaxshelf.php
ajaxstyles.php
ajaxsupplement.php
attachment.php
authenticate.php
backup.php
batchimport.php
batchreindex.php
browsedirs.php
categories.php
checkbinaries.php
citationstyles.php
cleartrash.php
convertstyles.php
data.php
desktop.php
details.php
discussion.php
display.php
download_arxiv.php
download_highwire.php
download_ieee.php
download_nasa.php
download_pmc.php
download_pubmed.php
download_springer.php
downloadnewversion.php
duplicates.php
edit.php
expertsearch.php
export.php
fatalerror.php
favicon.ico
fetch.php
fetch_crossref.php
fetch_pmc.php
file_discussion.php
file_top.php
files.php
flagged.php
fonts.php
functions.php
history.php
icon.php
ilibrarian-default.ini
imagelist.php
importmetadata.php
index.html
index.inc.php
index2.php
install.php
integrity.php
items.php
journals.sq3
jqueryFileTree.php
keyboard.php
leftindex.php
migrate.php
migrate2.php
migrate3.php
migrate4.php
migrate5.php
notes.php
ocr.php
omnitool.php
pdfclass.php
pdfcontroller.php
pdfviewer.php
projectnotes.php
quicksearch.php
reindexpdf.php
remoteuploader.php
rename_category.php
rename_journal.php
resetpassword.php
robots.txt
rss.php
rtfscan.php
search.php
selectduplicate.php
selectimport.php
settings.php
stable.php
style.php
styles.sq3
synchronize.php
temp.php
test.bmp
test.odt
test.pdf
test.ris
tools.php
topindex.php
upload.php
users.php
vacuum.php
viewindex.php
wpad.php
xpdfrc

README.md

I, Librarian Instructions

Contents

  • Automated installation using installers
  • Windows manual installation
  • Linux manual installation
  • Mac OS X manual installation
  • First use
  • Un-installation

Automated installation using installers

You can download and execute installers for Windows Vista, 7, 8, and 10 plus a DEB package and a console installer for Ubuntu, Debian, and its derivatives. An installer for Mac OS X is not available. These installers will install and/or configure Apache and PHP for you. If you don't want that, follow the instructions below to install manually.

Windows manual installation

Before you start, disable Microsoft IIS, close Skype or any other software using port 80.

  • Install Apache 2.4+ and PHP 5.5+ using a Windows installer like WAMPServer.
  • Edit Apache configuration file (httpd.conf). Append this at the end using Notepad:
Alias /librarian "C:\I, Librarian"
<Directory "C:\I, Librarian">
    AllowOverride None
    # Allow access from this computer
    Require local
    # Allow access from intranet computers
    Require ip 10
    Require ip 172.16 172.17 172.18 172.19 172.20
    Require ip 172.21 172.22 172.23 172.24 172.25
    Require ip 172.26 172.27 172.28 172.29 172.30 172.31
    Require ip 192.168
    # Insert Allow from directives here to allow access from the internet
    # "Require all granted" opens access to everybody
    <IfModule mod_php5.c>
        php_value upload_max_filesize 400M
        php_value post_max_size 800M
    </IfModule>
    <FilesMatch "\.(ini|conf)$">
        Require all denied
    </FilesMatch>
</Directory>
<Directory "C:\I, Librarian\library">
    Require all denied
</Directory>
  • You may change C:\I, Librarian to any directory where you want to have I, Librarian, including an external drive. For a groupware use, you need to allow access to more IP numbers or domain names.
  • Restart the server.
  • Unzip I, Librarian files into the directory defined by Alias in httpd.conf.

Linux manual installation

  • If you did not use the DEB package, make sure you have installed these packages from repositories:
    • apache2 (may be named httpd): a web server (you may run I, Librarian with a different web server).
    • php5 (may be named php): I, Librarian requires PHP5.4.
    • php5-sqlite (may be named php-pdo): SQLite database for PHP5.
    • php5-gd (may be named php-gd): GD library for PHP5.
    • poppler-utils: required for PDF indexing and for the built-in PDF viewer.
    • ghostscript: required for the built-in PDF viewer.
    • tesseract-ocr: required for OCR.
    • libreoffice: required for conversion of office files to PDF.
  • If you are installing from the tar.gz, login as root or use sudo, and extract files into 'librarian' directory in your web sever's root directory. Example:
  tar zxf I,-Librarian-*.tar.gz -C /var/www/html/librarian
  • Change the owner of the library sub-folder to Apache. Example:
  chown -R apache:apache /var/www/html/librarian/library
  chown root:root /var/www/html/librarian/library/.htaccess
  • Insert a safe setting like this example into your Apache configuration file:
<Directory "/var/www/html/librarian">
    AllowOverride None
    # Allow access from this computer
    Require local
    # Allow access from intranet computers
    Require ip 10
    Require ip 172.16 172.17 172.18 172.19 172.20
    Require ip 172.21 172.22 172.23 172.24 172.25
    Require ip 172.26 172.27 172.28 172.29 172.30 172.31
    Require ip 192.168
    # Insert Allow from directives here to allow access from the internet
    # "Require all granted" opens access to everybody
    <IfModule mod_php5.c>
        php_value upload_max_filesize 400M
        php_value post_max_size 800M
    </IfModule>
    <FilesMatch "\.(ini|conf)$">
        Require all denied
    </FilesMatch>
</Directory>
<Directory "/var/www/html/librarian/library">
    Require all denied
</Directory>
  • To enable access from the Network, you need to allow access to more IP numbers or domain names.
  • Restart the server.

Mac OS X manual installation

  • Download and install an Apache + PHP stack. These instructions are generic. Details may vary depending on which PHP stack you are using.
  • Edit httpd.conf using TextEdit:
Alias /librarian /Users/yourusername/Sites/librarian
<Directory /Users/Yourusername/Sites/librarian>
    AllowOverride None
    # Allow access from this computer
    Require local
    # Allow access from intranet computers
    Require ip 10
    Require ip 172.16 172.17 172.18 172.19 172.20
    Require ip 172.21 172.22 172.23 172.24 172.25
    Require ip 172.26 172.27 172.28 172.29 172.30 172.31
    Require ip 192.168
    # Insert Allow from directives here to allow access from the internet
    # "Require all granted" opens access to everybody
    <IfModule mod_php5.c>
        php_value upload_max_filesize 400M
        php_value post_max_size 800M
    </IfModule>
    <FilesMatch "\.(ini|conf)$">
        Require all denied
    </FilesMatch>
</Directory>
<Directory /Users/Yourusername/Sites/librarian/library>
    Require all denied
</Directory>

Don't forget to change "yourusername" to your actual user name. You can find out your user name by typing whoami in Terminal.

  • Restart Apache.
  • Install LibreOffice, Tesseract OCR, Ghostscript, and Poppler.
  • Download I, Librarian for Mac OSX and double-click the file to extract its contents.
  • Rename the extracted directory to 'librarian' and move it to your Sites folder.
  • Make sure that your Sites directory is accessible to Others. Use the Get Info dialog of the Sites directory to change permissions for Everyone to access and read. You also need to make sure Everyone has Execute permissions for your home directory.
  • Change the owner of the 'library' sub-folder to Apache.
  • Open your web browser and go to http://127.0.0.1/librarian.

First use

  • In order to start I, Librarian, open your web browser, and visit: http://127.0.0.1/librarian
  • Replace 127.0.0.1 with your static IP, or qualified server domain name, if you have either one.
  • Create an account and head to Tools->Installation Details to check if everything checks fine.
  • You should also check Tools->Settings to run I, Librarian the way you want.

Thank you for installing I, Librarian!

Un-installation

  • If you used the DEB package, execute the uninstall.sh un-installer.
  • Otherwise un-install all programs that you installed solely to use I, Librarian.
  • These may include Apache and PHP. Note: You might have other programs using these. Only remove if sure.
  • Delete I, Librarian ('librarian') directory.