GitLocker: The Coding Marketplace

Description:

djangocmslabpublications 0.1.5

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
Configuration
Migrations
Usage
Revision History

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