{ "info": { "author": "('Chris Clarke', 'Lendl Smith')", "author_email": "cclarke@chrisdev.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7" ], "description": "======================\nDjango Flatpage Filer\n======================\n\n.. image:: https://secure.travis-ci.org/chrisdev/django-flatpages-filer.png?branch=master\n :target: http://travis-ci.org/chrisdev/django-flatpages-filer\n.. image:: https://coveralls.io/repos/chrisdev/django-flatpages-filer/badge.png?branch=master\n :target: https://coveralls.io/r/chrisdev/django-flatpages-filer\n\nAn extension to provide easy integration between ``django.contrib.flatpages`` \nand `Django-filer`_ \n\n \"A file management application for django that makes handling of files \n and images a breeze\".\n\nThw ``django-flapages-filer`` app aims to provide a seamless experience \nto users of the\nstandard flatpages app. It enhances the standard flatpages Admin \nwith inline forms that allow you to include references to your filer based \nimages and files (attachments). It also allows you to easily maintain content \nusing a markup format such as ``Markdown``.\n\nHowever, the ``contrib.Flatpage`` model (content, titles) \nis not be affected by installing or removing this app.\nYour templates do not have to be modified as they will\nstill utilize the ``{{ flatpage.content }}`` and ``{{ flatpage.title }}``\ncontext variables. Once it is installed, content changes are actually \nstored in a related model ``flatpages_filer.models.Revisions`` usually \nin a markup format. The Revision model which also keeps track of\ncontent changes making it easy to revert to an earlier versions.\nThe modified ``Admin ChangeForm`` ensures you can view the latest \nversion of your content in the appropriate markup format and when \nyou save a ``flatpage`` this markup content will be rendered to\nto html via a specified parser. \n\nAdditionally, ``django-flatpages-filer``:\n\n- Comes with a default ``Markdown`` parser. By default the\n ``codehilite`` and ``extra`` extensions are supported but you can specify \n your own list of extensions in your Django settings\n\n- You can easily write your own parser to support to support markup \n formats such as rst or creole.\n\n- Provides optional support for the excellent **markItUp** widget. \n This requires the installation ``django-markitup``.\n\n- Provides templatetags to support *HTML metatags* such as keywords and\n descriptions in flatpages.\n\n.. _Django-filer: https://pypi.python.org/pypi/django-filer/\n\nContributors\n============\n* `Christopher Clarke `_\n* `Lendl R Smith `_\n* `Mikhail Andreev `_\n* `Raumkraut `_\n\nQuickstart\n===========\nCreate a virtual environment for your project and activate it::\n\n $ virtualenv mysite-env\n $ source mysite-env/bin/activate\n (mysite-env)$\n\nNext install ``flatpages_filer`` ::\n\n (mysite-env)$ pip install django-flatpages-filer\n\nAdd ``flatpages_filer`` to your INSTALLED_APPS setting.\n\nInside your project run::\n\n (mysite-env)$ python manage.py syncdb \n\nDjango-flatpages-filer comes with support for\n`Markdown `_\n\nTo include filer images in your content use a standard markdown image\nreference ::\n\n ![Atl text][filer_image.pk]\n\nFor a link to a file ::\n\n [Atl text][filer_file.pk]\n \nWhere ``pk`` refers to the primary key of the filer file or image.\nTo facilitate easy inclusion of the images and file attachments in your markdown\ncontent the ``Flatpages Admin`` now contains Inline image and file attachment\nforms which allow you to to associate the filer images or files with \nthe ``flatpage`` once you save the ``flatpage`` the correct markdown \nimage/file reference should is visible in Inline image form.\n\nmarkItUp support\n------------------\nIf you want to use the excellent markItUp! editor widget. Install django-markItUp::\n\n (mysite-env)$ pip install django-markitup\n\nYou need a few configuration steps\n\n1. Add 'markitup' to your INSTALLED_APPS setting.\n\n2. Add the following to settings::\n\n MARKITUP_SET = 'markitup/sets/markdown'\n MARKITUP_SKIN = 'markitup/skins/markitup'\n MARKITUP_FILTER = ('markdown.markdown', {'safe_mode': True})\n\n3. You need to use the AJAX-based preview for the admin widget::\n\n url(r'^markitup/', include('markitup.urls'))\n\nin your root URLconf.\n\nMarkup Parsers\n--------------\nDjango-flatpages-filer includes a Markdown parser that\nsupports ``codehilite`` and ``extra`` extensions. You can \nsupport additional extensions by first installing the extension\nan adding the following to you Django settings ::\n\n FLATPAGES_FILER_PARSER= [\"flatpages_filer.markdown_parser.parse\",\n {'extensions': ['codehilite','extra', 'abbr']}]\n\n\nYou can also supply your own parser by setting the value for \n``FLATPAGES_FILER_PARSER`` to point to your parser ::\n\n FLATPAGES_FILER_PARSER= [\"myproject.myapp.creole_parser.parse\",\n {'emitter': FilerEmmiter}]\n\nNote we expect that your ``parse`` would have the following signature ::\n \n parse(text, [list of `extensions, emitters etc.])\n\nMigrating From Flatpages-x\n---------------------------\nBefore installing to ``django-flatpage-filer`` dump the data in the Revison\nmodel ::\n\n python manage.py dumpdata flatpages_x.Revision > revision.json\n\nRemove ``flatpage_x`` from you settings and install django-flatpages-filer and \nadd ``flatpages_filer`` to the settings. To import your revision data edit\n``revision.json`` and change all occurences of ``flatpages_x.revision`` \nto ``flatpages_filer.revision``. Finally, run :: \n\n python manage.py loaddata ~/usr/folder/revision.json\n\n\n.. end-here\n\nDocumentation\n--------------\n\nSee the `full documentation`_ for more details.\n\n.. _full documentation: http://django-flatpages-filer.readthedocs.org/", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/chrisdev/django-flatpages-filer", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "django-flatpages-filer", "package_url": "https://pypi.org/project/django-flatpages-filer/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/django-flatpages-filer/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/chrisdev/django-flatpages-filer" }, "release_url": "https://pypi.org/project/django-flatpages-filer/0.1.0/", "requires_dist": null, "requires_python": null, "summary": "Some Basic extensions for django-contrib-flatpages", "version": "0.1.0" }, "last_serial": 833627, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "d102e2e97db5ed6e710db17058e15859", "sha256": "72ff47349d9db78903536c83670e14f488aab542c69073d6d9fb05787426f90d" }, "downloads": -1, "filename": "django-flatpages-filer-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d102e2e97db5ed6e710db17058e15859", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 90747, "upload_time": "2013-08-06T16:09:36", "url": "https://files.pythonhosted.org/packages/1a/8f/ef3ec58f29ac3b797cc4015a6be4a85fc0bea144a3b6c99ea841e19288f7/django-flatpages-filer-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d102e2e97db5ed6e710db17058e15859", "sha256": "72ff47349d9db78903536c83670e14f488aab542c69073d6d9fb05787426f90d" }, "downloads": -1, "filename": "django-flatpages-filer-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d102e2e97db5ed6e710db17058e15859", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 90747, "upload_time": "2013-08-06T16:09:36", "url": "https://files.pythonhosted.org/packages/1a/8f/ef3ec58f29ac3b797cc4015a6be4a85fc0bea144a3b6c99ea841e19288f7/django-flatpages-filer-0.1.0.tar.gz" } ] }