{ "info": { "author": "Diederik van der Boor", "author_email": "opensource@edoburu.nl", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Framework :: Django :: 1.10", "Framework :: Django :: 1.11", "Framework :: Django :: 2.0", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content", "Topic :: Software Development :: Libraries :: Application Frameworks", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": ".. image:: https://img.shields.io/travis/django-fluent/django-fluent-blogs/master.svg?branch=master\n :target: http://travis-ci.org/django-fluent/django-fluent-blogs\n.. image:: https://img.shields.io/pypi/v/django-fluent-blogs.svg\n :target: https://pypi.python.org/pypi/django-fluent-blogs/\n.. image:: https://img.shields.io/pypi/l/django-fluent-blogs.svg\n :target: https://pypi.python.org/pypi/django-fluent-blogs/\n.. image:: https://img.shields.io/codecov/c/github/django-fluent/django-fluent-blogs/master.svg\n :target: https://codecov.io/github/django-fluent/django-fluent-blogs?branch=master\n\ndjango-fluent-blogs\n===================\n\nThis is a basic blogging engine, with the following features:\n\n* Archive views by date, author, category and tags.\n* Contents filled by django-fluent-contents_\n* RSS and Atom feeds\n* Granularity in templates to override layouts.\n* Abstract base model for custom blog models.\n\nUsed applications:\n\n* Categories based on django-categories-i18n_ (or django-categories_).\n* *Optional* comments based on django-contrib-comments_\n* *Optional* multilingual support based on django-parler_.\n* *Optional* integration with django-taggit_ and django-taggit-autocomplete-modified_ for tag support\n* *Optional* integration with django-fluent-comments_ for Ajax-based comments\n* *Optional* integration with django-fluent-pages_\n* *Optional* integration with django.contrib.sitemaps_\n\nTODO:\n\n* Have integration with blog publication protocols (like django-blog-zinnia_ provides), built in a similar way like django.contrib.syndication_ works.\n\n\nInstallation\n============\n\nFirst install the module, preferably in a virtual environment:\n\n.. code-block:: bash\n\n pip install django-fluent-blogs\n\n # Install the plugins of fluent-contents that you use:\n pip install django-fluent-contents[text]\n\n # Optional: to add tagging support + autocomplete use:\n pip install django-taggit django-taggit-autocomplete-modified\n\n\nConfiguration\n-------------\n\nAdd the applications to ``settings.py``:\n\n.. code-block:: python\n\n INSTALLED_APPS += (\n # Blog engine\n 'fluent_blogs',\n\n # The content plugins\n 'fluent_contents',\n 'fluent_contents.plugins.text',\n\n # Support libs\n 'categories_i18n',\n 'django_wysiwyg',\n 'slug_preview',\n\n # Optional commenting support\n 'django_comments',\n\n # Optional tagging\n 'taggit',\n 'taggit_autocomplete_modified',\n )\n\n DJANGO_WYSIWYG_FLAVOR = \"yui_advanced\"\n\nNote that not all applications are required;\ntagging is optional, and so are the various ``fluent_contents.plugin.*`` packages.\n\nInclude the apps in ``urls.py``:\n\n.. code-block:: python\n\n urlpatterns += patterns('',\n url(r'^admin/util/taggit_autocomplete_modified/', include('taggit_autocomplete_modified.urls')),\n url(r'^blog/comments/', include('django_comments.urls')),\n url(r'^blog/', include('fluent_blogs.urls')),\n )\n\nThe database can be created afterwards::\n\n ./manage.py migrate\n\nIn case additional plugins of django-fluent-contents_ are used, follow their\n`installation instructions `_ as well.\nTypically this includes:\n\n* adding the package name to ``INSTALLED_APPS``.\n* running ``pip install django-fluent-contents[pluginname]``\n* running ``./manage.py syncdb``\n\n\nConfiguring the templates\n-------------------------\n\nTo display the blog contents, a ``fluent_blogs/base.html`` file needs to be created.\nThis will be used to map the output of the module to your site templates.\n\nThe base template needs to have the blocks:\n\n* ``content`` - displays the main content\n* ``title`` - the ```` title fragment.\n* ``link`` - displays ```` tags for RSS feeds.\n* ``script`` - includes additional ``