Metadata-Version: 1.0
Name: django-revcanonical
Version: 1.0
Summary: An implementation of rev=canonical url shortening for Django.
Home-page: http://hg.piranha.org.ua/django-revcanonical/
Author: Alexander Solovyov
Author-email: piranha@piranha.org.ua
License: BSD
Description: .. -*- mode: rst -*-
        
        =================================
        RevCanonical Django application
        =================================
        
        This is an implementation of rev=canonical `url shortening`_ in the form of
        Django application. Basically rev=canonical is nice idea about that site should
        give you two links to actual page: one is human-readable, and another is short
        version, intented to use in limited conditions.
        
        This implementation is modelled after Simon Willison's `post`_ and returns 301
        permanent redirect for your short urls.
        
        .. _url shortening: http://revcanonical.appspot.com/
        .. _post: http://simonwillison.net/2009/Apr/11/revcanonical/
        
        
        Configuration
        -------------
        
        Installation is simple - use it like any another Django application, basically:
        put it where other application of your project are residing and add
        ``'revcanonical'`` to ``INSTALLED_APPS`` in ``settings.py``. Then edit your
        ``urls.py`` and add inclusion of revcanonical's urls to urlpatterns::
        
        url(r'', include('revcanonical.urls')),
        
        Use ``r'^someprefix/'`` instead of first argument if you'd like to see prefixed
        urls.
        
        By default revcanonical uses internal Django's Site model to determine your site
        domain, but you can set it manually in ``settings.py`` as ``REVCANONICAL_SITE``
        variable.
        
        
        Usage
        -----
        
        Include such code in your template between ``<head>`` and ``</head>`` tags::
        
        {% load revcanontags %}
        {% revcanonical object %}
        
        Of course, you should replace ``object`` with your own object variable. And,
        naturally, it should have ``get_absolute_url()`` method.
        
        Additionally you can set your `<a href>` links to short urls::
        
        {% load revcanontags %}
        <a href="{% shorturl object %}">...</a>
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
