This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

djangocms-lab-publications is a Django app for adding sets of scientific publications with PubMed metadata to a Django site with django CMS-specific features. It uses pubmed-lookup to query PubMed using PubMed IDs or PubMed URLs.

Source code is available on GitHub at mfcovington/djangocms-lab-publications. Information about and source code for pubmed-lookup is available on GitHub at mfcovington/pubmed-lookup.

Installation

PyPI

pip install djangocms-lab-publications

GitHub

pip install https://github.com/mfcovington/djangocms-lab-publications/releases/download/0.1.5/djangocms-lab-publications-0.1.5.tar.gz

Configuration

  • Install django CMS and start a project, if one doesn’t already exist.

    • Unless you use this app as part of djangocms-lab-site or plan to style the app from scratch, you will want to choose the Use Twitter Bootstrap Theme option (when running djangocms) and then edit the resulting templates/base.html. This will add style that looks like Bootstrap 2. To use Bootstrap 3 styling, remove the following line for the bootstrap-theme.min.css stylesheet from templates/base.html:

      <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.x.x/css/bootstrap-theme.min.css">
      
  • Do the following in settings.py:

    • Add cms_lab_publications and its dependencies to INSTALLED_APPS:

      INSTALLED_APPS = (
          # ...
          'taggit',
          'taggit_helpers',
          'cms_lab_publications',
          'easy_thumbnails',
          'filer',
          'mptt',
      )
      
    • Add easy_thumbnail settings:

      # For easy_thumbnails to support retina displays (recent MacBooks, iOS)
      THUMBNAIL_HIGH_RESOLUTION = True
      THUMBNAIL_QUALITY = 95
      THUMBNAIL_PROCESSORS = (
          'easy_thumbnails.processors.colorspace',
          'easy_thumbnails.processors.autocrop',
          'filer.thumbnail_processors.scale_and_crop_with_subject_location',
          'easy_thumbnails.processors.filters',
      )
      THUMBNAIL_PRESERVE_EXTENSIONS = ('png', 'gif')
      THUMBNAIL_SUBDIR = 'versions'
      
  • If cms_lab_publications is used in a project served by Apache, a config directory must be created within the Apache user’s home directory. This config directory is used by code within biopython’s Bio.Entrez.Parser.DataHandler which is used by pubmed_lookup, a dependency of cms_lab_publications.

    # In this snippet, the Apache user is 'www-data' and
    # the Apache user's home directory is '/var/www/'
    sudo su - root
    cd /var/www/
    chown :www-data
    chmod g+s
    mkdir -p /var/www/.config/biopython/Bio/Entrez/DTDs
    

Migrations

Create and perform cms_lab_publications migrations:

python manage.py makemigrations cms_lab_publications
python manage.py migrate

Usage

  • Start the development server:
python manage.py runserver
  • Visit: http://127.0.0.1:8000/
  • Create a CMS page.
  • Insert the Publication Set Plugin into a placeholder field.

Version 0.1.5

Revision History

0.1.5 2015-11-09

  • Fix styling of vertical filter selector buttons and boxes in response to changes in djangocms-admin-style
  • Add bottom margin to non-paginated publication lists
  • Remove ‘Abstract’ button from modal
  • Resolve Django 1.8 warnings
  • Update README with more complete and accurate instructions

0.1.4 2015-06-24

  • Allow manual entry of Publications that don’t have a PubMed ID
  • Use django-taggit-helpers in admin
  • Rename deprecated queryset method
  • Configure bumpversion & wheel for easier distribution
  • Convert README and changelog to reStructuredText for distribution via PyPI
  • Minor changes to admin interface
    • Change pagination description to ‘pubs per page’
    • Add/update help text for ‘tags’ and ‘pagination’

0.1.3 2015-06-03

  • Allow bulk PubMed queries for a Publication Set
  • Allow a Publication Set to be created without publications
  • Default to no pagination (hides page ‘1’ button for short publication sets)
  • Set default Publication Set label to ‘Publications’
  • Admin improvements
    • Publication Admin
      • Reorder Publication Admin’s inlines
      • Add year and PubMed ID to Publication Admin search field
      • Display (and sort by) # of Publication Sets in Publication Admin
    • Publication Set Admin
      • In Publication Set Admin, move publications from a tabular inline to a vertical filter
      • Reorder Publication Set Admin’s list display items
      • Filter Publication Set records by whether its Bulk PubMed Query failed
      • Display whether a Publication Set’s Bulk PubMed Query status is OK
    • Other
      • Update and improve layout of help text
      • Add short descriptions for custom list display items
      • Add docstring for MissingAttachmentListFilter

0.1.2 2015-05-27

  • Expand documentation for installation and configuration
  • Add mini_citation field to Publication
    • Helps identify publication when in edit mode (without expanding PubMed Metadata fieldset)
    • Helps naming associated files (PDF, Supplemental, and Image) by providing a base name
    • Bumps pubmed-lookup dependency to version 0.1.1
  • Many improvements to Publication and Publication Set Admins
    • Rearrange Publication Admin fieldsets
    • Add PublicationSetInline to PublicationAdmin
    • Add save button across tops of Publication and Publication Set Admins
    • Now Powered by Blackina
    • Display whether a record has PDF/Supp/Image attachments in Publication Admin
    • Filter PublicationAdmin by missing/existing attachments
    • Filter Publication and Publication Set Admins by tags for the current model only
    • Show (and sort by) ‘number of publications’ for records in Publication Set Admin

0.1.1 2015-05-23

  • Allow multiple Publication Set plugins per page
  • Use Publication Set’s name, not label, for __str__ and ordering

0.1.0 2015-05-22

  • A Django app for adding sets of scientific publications with PubMed metadata to a Django site with django CMS-specific features
Release History

Release History

0.1.5

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
djangocms_lab_publications-0.1.5-py32-none-any.whl (27.5 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Nov 10, 2015
djangocms-lab-publications-0.1.5.tar.gz (20.6 kB) Copy SHA256 Checksum SHA256 Source Nov 10, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting