Metadata-Version: 2.1
Name: django-lang-switch
Version: 0.2
Summary: Language switch for Django
Home-page: https://github.com/stinovlas/django-lang-switch
Author: Jan Musílek
Author-email: jan.musilek@nic.cz
License: UNKNOWN
Description: ==================
        django-lang-switch
        ==================
        
        .. image:: https://travis-ci.org/stinovlas/django-lang-switch.svg?branch=devel
            :target: https://travis-ci.org/stinovlas/django-lang-switch/branches
        .. image:: https://codecov.io/gh/stinovlas/django-lang-switch/branch/devel/graph/badge.svg
            :target: https://codecov.io/gh/stinovlas/django-lang-switch/branch/devel
        .. image:: https://img.shields.io/pypi/v/django-lang-switch.svg
            :target: https://pypi.org/project/django-lang-switch
        .. image:: https://img.shields.io/pypi/pyversions/django-lang-switch.svg
            :target: https://pypi.org/project/django-lang-switch
        .. image:: https://img.shields.io/pypi/djversions/django-lang-switch.svg
            :target: https://pypi.org/project/django-lang-switch
        
        Language switch for Django.
        
        
        --------------
         Installation
        --------------
        
        You can install ``django-lang-switch`` from PyPi:
        
        .. code-block:: bash
        
            $ pip install django-lang-switch
        
        
        ---------------
         Configuration
        ---------------
        
        You need to add ``django_lang_switch.apps.DjangoLangSwitchConfig`` into your ``INSTALLED_APPS`` setting.
        If you want to add enable language switch in django admin site, you have to add it before ``django.contrib.admin``.
        Otherwise, you need to put ``django.contrib.admin`` first.
        If you don't use django admin site, the order does not matter.
        
        If you tweaked the ``admin/base_site.html`` template yourself,
        put this application after yours and use the template tag as described below.
        
        You also need to include ``django-lang-switch`` urls to your ``ROOT_URLCONF``. Example:
        
        .. code-block:: python
        
            from django.urls import include, path
        
            urlpatterns = [
                ...
                path('django_lang_switch/', include('django_lang_switch.urls')),
            ]
        
        You can of course change the path to suit your needs.
        
        
        -------
         Usage
        -------
        
        If you just want to add language switch to django admin site,
        add this application to your ``INSTALLED_APPS`` as described above and you are done.
        
        If you want to use the same switch elsewhere, add template tage ``lang_switch_dropdown`` to your template.
        Don't forget to load ``lang_switch`` tag collection to your template. Example:
        
        .. code-block:: html
        
            {% extends myapp/base_site.html %}
            {% load lang_switch %}
            <div id="header">
                Welcome to MyApp!
                <div class="right">
                    {% lang_switch_dropdown %}
                </div>
            </div>
        
        
        ---------
         Styling
        ---------
        
        Language switch in django admin site is already styled to fit the default design.
        If you want to style the lang switch yourselves,
        you may set css for the ``div.lang-switch`` element and its descendants.
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.5
Provides-Extra: quality
