Metadata-Version: 1.1
Name: djangocms-blog
Version: 0.2
Summary: A djangoCMS 3 blog application
Home-page: https://github.com/nephila/djangocms-blog
Author: Iacopo Spalletti
Author-email: i.spalletti@nephila.it
License: BSD
Description: ==============
        djangocms-blog
        ==============
        
        
        .. image:: https://pypip.in/v/djangocms-blog/badge.png
                :target: https://pypi.python.org/pypi/djangocms-blog
                :alt: Latest PyPI version
            
        .. image:: https://travis-ci.org/nephila/djangocms-blog.png?branch=master
                :target: https://travis-ci.org/nephila/djangocms-blog
                :alt: Latest Travis CI build status
        
        .. image:: https://pypip.in/d/djangocms-blog/badge.png
                :target: https://pypi.python.org/pypi/djangocms-blog
                :alt: Monthly downloads
        
        .. image:: https://coveralls.io/repos/nephila/djangocms-blog/badge.png?branch=master
                :target: https://coveralls.io/r/nephila/djangocms-blog?branch=master
                :alt: Test coverage
        
        
        
        A djangoCMS 3 blog application.
        
        Still experimental and untested. You are welcome if you want to try it; if
        you encounter any issue, please open an issue.
        
        Supported Django versions:
        
        * Django 1.5
        * Django 1.6
        
        Supported django CMS versions:
        
        * django CMS 3.0
        
        Documentation
        -------------
        
        No doc at the moment, sorry
        
        Quickstart
        ----------
        
        Install djangocms-blog::
        
            pip install djangocms-blog==0.2c1
        
        Add ``djangocms_blog`` and its dependencies to INSTALLED_APPS::
        
            INSTALLED_APPS = [
                ...
                'filer',
                'easy_thumbnails',
                'cmsplugin_filer_image',
                'parler',
                'taggit',
                'taggit_autosuggest',
                'django_select2',
                'meta',
                'meta_mixin',
                'admin_enhancer',
                'djangocms_blog',
                ...
            ]
        
        Then sync and migrate::
        
            $ python manage.py syncdb
            $ python manage.py migrate
        
        External applications configuration
        +++++++++++++++++++++++++++++++++++
        
        Dependency applications may need configuration to work properly.
        
        Please, refer to each application documentation on details.
        
        * django-filer: http://django-filer.readthedocs.org
        * django-meta: https://github.com/nephila/django-meta#installation
        * django-parler: http://django-parler.readthedocs.org/en/latest/quickstart.html#configuration
        * django-taggit-autosuggest: https://bitbucket.org/fabian/django-taggit-autosuggest
        
        Quick hint
        ++++++++++
        
        The following are minimal defaults to get the blog running; they may not be
        suited for your deployment.
        
        * Add the following settings to your project::    
        
            SOUTH_MIGRATION_MODULES = {
                'easy_thumbnails': 'easy_thumbnails.south_migrations',
                'taggit': 'taggit.south_migrations',
            }
            THUMBNAIL_PROCESSORS = (
                'easy_thumbnails.processors.colorspace',
                'easy_thumbnails.processors.autocrop',
                'filer.thumbnail_processors.scale_and_crop_with_subject_location',
                'easy_thumbnails.processors.filters',
            )
            META_SITE_PROTOCOL = 'http'
            META_USE_SITES = True
        
        * Configure parler according to your languages::
        
            PARLER_LANGUAGES = {
                1: (
                    {'code': 'en',},
                    {'code': 'it',},
                    {'code': 'fr',},
                ),
            }
        
        * Add the following to your ``urls.py``::
        
            url(r'^taggit_autosuggest/', include('taggit_autosuggest.urls')),
        
        * To start your blog create a new page from the CMS and hook it to the blog application:
         
          * Create a new django CMS page
          * Go to Advanced settings and sele select Blog from the Application selector;
          * Eventually customise the Application instance name;
          * Restart the project instance to properly load blog urls.
        
        
        Templates
        +++++++++
        
        To ease the template customisations a ``djangocms_blog/base.html`` template is used by all the blog templates;
        the templates itself extends a ``base.html`` template; content is pulled in the ``content`` block.
        If you need to define a different base template, or if your base template does not defines a ``content`` block,
        copy in your template directory ``djangocms_blog/base.html`` and customise it according to your
        needs; the other application templates will use the newly created template and will ignore the bundled one.
        
        Features
        --------
        
        * Placeholder content editing
        * Frontend editing using django CMS 3.0 frontend editor
        * Multilingual support using django-parler
        * Support for Twitter cards, Open Graph and Google+ snippets meta tags
        * Optional support for simpler TextField-based content editing
        
        Import from Wordpress
        +++++++++++++++++++++
        
        If you want to import content from existing wordpress blog, check
        https://pypi.python.org/pypi/the-real-django-wordpress and
        this gist https://gist.github.com/yakky/11336204 as a base.
        
        
        Settings
        --------
        * BLOG_ENABLE_COMMENTS: Whether to enable comments by default on posts;
          while `djangocms_blog` does not ship any comment system, this flag can be used
          to control the chosen comments framework; (default: True)
        * BLOG_USE_PLACEHOLDER: Post content is managed via placeholder; if `False` a
          simple HTMLField is used; (default: True)
        * BLOG_IMAGE_THUMBNAIL_SIZE: Size of the main image when shown on the post lists;
          it's a dictionary with `size`, `crop` and `upscale` keys;
          (default: `{'size': '120x120', 'crop': True,'upscale': False}`)
        * BLOG_IMAGE_FULL_SIZE: Size of the main image when shown on the post detail;
          it's a dictionary with `size`, `crop` and `upscale` keys;
          (default: `{'size': '640x120', 'crop': True,'upscale': False}`)
        * BLOG_PAGINATION: Number of post per page; (defaul: 10)
        * BLOG_LATEST_POSTS: Default number of post in the **Latest post** plugin; (defaul: 5)
        * BLOG_POSTS_LIST_TRUNCWORDS_COUNT: Default number of words shown for abstract in the post list; (default: 100)
        
        Social media tags settings
        ++++++++++++++++++++++++++
        * BLOG_TYPE: Generic type for the post object; (default: Article)
        * BLOG_FB_TYPE: Open Graph type for the post object; (default: Article)
        * BLOG_FB_APPID: Facebook Application ID
        * BLOG_FB_PROFILE_ID: Facebook profile ID of the post author
        * BLOG_FB_PUBLISHER: Facebook URL of the blog publisher
        * BLOG_FB_AUTHOR_URL: Facebook profile URL of the post author
        * BLOG_FB_AUTHOR: Facebook profile URL of the post author
        * BLOG_TWITTER_TYPE: Twitter Card type for the post object; (default: Summary)
        * BLOG_TWITTER_SITE: Twitter account of the site
        * BLOG_TWITTER_AUTHOR: Twitter account of the post author
        * BLOG_GPLUS_TYPE: Google+ Snippet type for the post object; (default: Blog)
        * BLOG_GPLUS_AUTHOR: Google+ account of the post author
        
        .. image:: https://d2weczhvl823v0.cloudfront.net/nephila/djangocms-blog/trend.png
           :alt: Bitdeli badge
           :target: https://bitdeli.com/free
        
        
        
        
        
        History
        -------
        
        0.2.0 (2014-09-24)
        ++++++++++++++++++
        
        * **INCOMPATIBLE CHANGE**: view names changed!
        * Based on django parler 1.0
        * Toolbar items contextual to the current page
        * Add support for canonical URLs
        * Add transifex support
        * Add social tags via django-meta-mixin
        * Per-post or site-wide comments enabling
        * Simpler TextField-based content editing for simpler blogs
        * Add support for custom user models
        
        
        0.1.0 (2014-03-06)
        ++++++++++++++++++
        
        * First experimental release
        
Keywords: djangocms-blog,blog,django,wordpress,multilingual
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
