djangocms-genome-browser

djangocms-genome-browser is a Django app for incorporating a Dalliance genome browser into a Django site with django CMS-specific features.

Source code is available on GitHub at mfcovington/djangocms-genome-browser. Information about and source code for the Dalliance genome browser are available on Biodalliance and GitHub, respectively.

• Installation
• Configuration
• Migrations
• Usage

Installation

GitHub (development branch)

pip install git+http://github.com/mfcovington/djangocms-genome-browser.git@develop

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_genome_browser and its dependencies to INSTALLED_APPS:

    INSTALLED_APPS = (
        # ...
        'cms_genome_browser',
        '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'

Migrations

Create and perform cms_genome_browser migrations:

python manage.py makemigrations cms_genome_browser
python manage.py migrate

Usage

• Start the development server:

python manage.py runserver

• Visit: http://127.0.0.1:8000/
• Create a CMS page.
• Attach the Genome Browser App under Advanced Settings for the page.

Version 0.1.1