Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
 
 
db
 
 
doc
 
 
lib
 
 
log
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Papernaut Frontend

This is the web front end for http://www.papernautapp.com.

Overview

The frontend works in two distinct phases: first, it helps you import papers from a library. Second, it shows you discussions for those papers.

You can import your papers from Zotero or Mendeley by giving Papernaut API access to your libraries via OAuth. Or, you can import papers from most reference management software by uploading a .bibtex file.

Once your papers are loaded into the frontend, it issues requests to the papernaut-engine HTTP API to request discussions that match papers in your library.

The interface between the frontend and the engine are Identifier strings, which take a prefix/value form:

DOI:10.1038/nphys2376
ISSN:1542-4065
PMID:10659856
URL:http://nar.oxfordjournals.org/content/40/D1/D742.full

Many papers will have multiple identifiers, and the frontend attempts to clean, validate, canonicalize, and cross-reference your papers' identifiers as best it can in an attempt to find the most matches.

Getting Started

  1. Set up and run the papernaut-engine.

  2. Register for Mendeley at https://www.mendeley.com/join/. Register for a Mendeley OAuth key at http://dev.mendeley.com.

  3. Register for Zotero at https://www.zotero.org/user/register/. Register for a Zotero OAuth key at http://www.zotero.org/oauth/apps.

  4. Install Redis, used by Sidekiq.

  5. Install gems:

    bundle install
    
  6. Create and migrate the databases. PostgreSQL is used by default.

    rake db:create db:migrate db:test:prepare
    
  7. Create and edit the Foreman .env file to specify the web port and your API keys:

    PORT=3000
    MENDELEY_OAUTH_CONSUMER_KEY=api_key
    MENDELEY_OAUTH_CONSUMER_SECRET=api_secret
    ZOTERO_OAUTH_CONSUMER_KEY=api_key
    ZOTERO_OAUTH_CONSUMER_SECRET=api_secret
    
  8. For the automated tests to connect to Zotero via OAuth, provide your Zotero credentials in .env:

    ZOTERO_USERNAME=zotero.user@example.com
    ZOTERO_PASSWORD=i.love.my.library
    

    These are loaded in the test environment by the dotenv gem.

  9. If you chose a non-default URL for the papernaut-engine, also add a line to .env to specify its location. The default is http://localhost:3001.

    PAPERNAUT_ENGINE_URL=http://localhost:3001
    
  10. Run the test suite to ensure things work on your system:

    rake

  11. Run the application:

    foreman start
    

Deploying to production

See DEPLOY.md for information about deploying.

License

See LICENSE file for the license applying to the code base.

The "Space Boy" graphic used in the homepage logo is by Russell Tate and is licensed from iStockPhoto.com:

http://www.istockphoto.com/stock-illustration-1087779-space-boy.php

The graphic is licensed for a single-seat install and is in use at http://www.papernautapp.com. It is not licensed for multi-seat use, so any other installations should purchase a separate license or use a different image.

http://www.istockphoto.com/help/licenses

You can’t perform that action at this time.