Metadata-Version: 1.1
Name: django-sitemaps
Version: 1.0.1
Summary: UNKNOWN
Home-page: https://github.com/matthiask/django-sitemaps/
Author: Matthias Kestenholz
Author-email: mk@feinheit.ch
License: BSD License
Description: ===============
        django-sitemaps
        ===============
        
        ``sitemap.xml`` generation using lxml_ with support for alternates_. It
        uses Python 3's keyword-only arguments for self-documenting code.
        
        
        Installation
        ============
        
        Simply ``pip install django-sitemaps``. The package consists of a single
        python module, ``django_sitemaps``, containing the single class; there's no
        additional configuration necessary.
        
        
        Usage
        =====
        
        View::
        
            from app.pages.sitemaps import PagesSitemap
        
            def sitemap(request):
                sitemap = Sitemap(
                    # All URLs are passed through build_absolute_uri.
                    build_absolute_uri=request.build_absolute_uri,
                )
        
                # URLs can be added one-by-one. The only required argument
                # is the URL. All other arguments are keyword-only arguments.
                for p in Page.objects.active():
                    url = p.get_absolute_url()
                    sitemap.add(
                        url,
                        changefreq='weekly',
                        priority=0.5,
                        lastmod=p.modification_date,
                        alternates={
                            code: urljoin(domain, url)
                            for code, domain in PAGE_DOMAINS[p.language].items()
                        },
                    )
        
                # Adding conventional Django sitemaps is supported. The
                # request argument is necessary because Django's sitemaps
                # depend on django.contrib.sites, resp. RequestSite.
                sitemap.add_django_sitemap(PagesSitemap, request=request)
        
                # You could get the serialized XML...
                # ... = sitemap.serialize([pretty_print=False])
                # ... or use the ``response`` helper to return a
                # ready-made ``HttpResponse``:
                return sitemap.response(
                    # pretty_print is False by default
                    pretty_print=settings.DEBUG,
                )
        
        URLconf::
        
            from app.views import sitemap
        
            urlpatterns = [
                url(r'^sitemap\.xml', sitemap),
                ...
            ]
        
        
        .. _alternates: https://support.google.com/webmasters/answer/2620865?hl=en
        .. _lxml: http://lxml.de/
        
Platform: OS Independent
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
