Skip to main content

A reusable Django app that displays an image gallery as a flipbook.

Project description

A reusable Django app that displays an image gallery as a flipbook.

Installation

To get the latest stable release from PyPi

$ pip install django-flipbook

To get the latest commit from GitHub

$ pip install -e git+git://github.com/bitmazk/django-flipbook.git#egg=flipbook

TODO: Describe further installation steps (edit / remove the examples below):

Add flipbook to your INSTALLED_APPS

INSTALLED_APPS = (
    ...,
    'flipbook',
)

Add the flipbook URLs to your urls.py

urlpatterns = patterns('',
    ...
    url(r'^flipbook/', include('flipbook.urls')),
)

Don’t forget to migrate your database

./manage.py migrate flipbook

Usage

Basically, there is a Flipbook and its (html) pages. You can edit them inline.

Make sure to install django-summernote, which provides the great summernote WYSIWYG editor. Django-App: https://github.com/lqez/django-summernote Editor: http://hackerwins.github.io/summernote/

All flipbooks are viewed in a general list view. You can also gather flipbooks in different categories and view them in seperated lists.

You will definitely want to overwrite the templates and add your favourite flipbook jquery plugin, so I only added simple templates and an example plugin. Get the plugin here: http://tympanus.net/codrops/2012/09/03/bookblock-a-content-flip-plugin/ Thx to Tympanus so far.

Please take a look at the models.py to check the models for their fields. There are a lot of possibilities to improve your templates. If you need any other fields or functions feel free to send a pull request =)

Settings

FLIPBOOK_PAGE_TYPE

Default: (‘default’, _(‘default’)), )

Tuple to define different page types. This can be helpful, if you want to distinguish pages in your template or if you want to add special css classes etc.

Contribute

If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
$ mkvirtualenv -p python2.7 django-flipbook
$ python setup.py install
$ pip install -r dev_requirements.txt

$ git co -b feature_branch master
# Implement your feature and tests
$ git add . && git commit
$ git push -u origin feature_branch
# Send us a pull request for your feature branch

Project details


Release history Release notifications

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

This version
History Node

0.3.2

History Node

0.3.1

History Node

0.3

History Node

0.2.1

History Node

0.2

History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-flipbook-0.3.2.tar.gz (37.5 kB) Copy SHA256 hash SHA256 Source None Feb 25, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page