Metadata-Version: 2.1
Name: django-humans-txt
Version: 0.14.4
Summary: Handle humans.txt
Home-page: https://github.com/vint21h/django-humans-txt/
Author: Alexei Andrushievich
Author-email: vint21h@vint21h.pp.ua
License: GPLv3+
Keywords: django,humans,humans.txt
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Description-Content-Type: text/x-rst
Requires-Dist: django (>=2.2<=3.2)
Requires-Dist: django-appconf (>=1.0.3)
Provides-Extra: test
Requires-Dist: attrs (==20.3.0) ; extra == 'test'
Requires-Dist: bandit (==1.7.0) ; extra == 'test'
Requires-Dist: black (==20.8b1) ; extra == 'test'
Requires-Dist: check-manifest (==0.46) ; extra == 'test'
Requires-Dist: check-wheel-contents (==0.2.0) ; extra == 'test'
Requires-Dist: coverage (==5.3.1) ; extra == 'test'
Requires-Dist: coveralls (==3.0.0) ; extra == 'test'
Requires-Dist: curlylint (==0.12.0) ; extra == 'test'
Requires-Dist: darglint (==1.5.8) ; extra == 'test'
Requires-Dist: dennis (==0.9) ; extra == 'test'
Requires-Dist: django-nose (==1.4.7) ; extra == 'test'
Requires-Dist: django-stubs (==1.7.0) ; extra == 'test'
Requires-Dist: dodgy (==0.2.1) ; extra == 'test'
Requires-Dist: flake8-annotations-complexity (==0.0.6) ; extra == 'test'
Requires-Dist: flake8-annotations-coverage (==0.0.5) ; extra == 'test'
Requires-Dist: flake8-bugbear (==20.11.1) ; extra == 'test'
Requires-Dist: flake8-docstrings (==1.5.0) ; extra == 'test'
Requires-Dist: flake8-fixme (==1.1.1) ; extra == 'test'
Requires-Dist: flake8 (==3.8.4) ; extra == 'test'
Requires-Dist: importlib-metadata (==3.4.0) ; extra == 'test'
Requires-Dist: interrogate (==1.3.2) ; extra == 'test'
Requires-Dist: isort (==5.7.0) ; extra == 'test'
Requires-Dist: mypy (==0.790) ; extra == 'test'
Requires-Dist: nose-exclude (==0.5.0) ; extra == 'test'
Requires-Dist: nose-timer (==1.0.0) ; extra == 'test'
Requires-Dist: pep8-naming (==0.11.1) ; extra == 'test'
Requires-Dist: polint (==0.4) ; extra == 'test'
Requires-Dist: pre-commit-hooks (==3.4.0) ; extra == 'test'
Requires-Dist: pre-commit (==2.9.3) ; extra == 'test'
Requires-Dist: pygments (==2.7.4) ; extra == 'test'
Requires-Dist: pylint-django (==2.4.2) ; extra == 'test'
Requires-Dist: pylint (==2.6.0) ; extra == 'test'
Requires-Dist: pyroma (==2.6) ; extra == 'test'
Requires-Dist: readme-renderer (==28.0) ; extra == 'test'
Requires-Dist: rednose (==1.3.0) ; extra == 'test'
Requires-Dist: removestar (==1.2.2) ; extra == 'test'
Requires-Dist: seed-isort-config (==2.2.0) ; extra == 'test'
Requires-Dist: tabulate (==0.8.7) ; extra == 'test'
Requires-Dist: tox-gh-actions (==2.4.0) ; extra == 'test'
Requires-Dist: tox-pyenv (==1.1.0) ; extra == 'test'
Requires-Dist: tox (==3.21.1) ; extra == 'test'
Requires-Dist: twine (==3.3.0) ; extra == 'test'

.. django-humans-txt
.. README.rst


A django-humans-txt documentation
=================================

|GitHub|_ |Coveralls|_ |Requires|_ |pypi-license|_ |pypi-version|_ |pypi-python-version|_ |pypi-django-version|_ |pypi-format|_ |pypi-wheel|_ |pypi-status|_

    *django-humans-txt is a Django reusable application to handle humans.txt (http://humanstxt.org/)*

.. contents::

Installation
------------
* Obtain your copy of source code from the git repository: ``$ git clone https://github.com/vint21h/django-humans-txt.git``. Or download the latest release from https://github.com/vint21h/django-humans-txt/tags/.
* Run ``$ python ./setup.py install`` from the repository source tree or the unpacked archive. Or use pip: ``$ pip install django-humans-txt``.

Configuration
-------------
* Add ``"humans_txt"`` to ``settings.INSTALLED_APPS``:

.. code-block:: python

    # settings.py

    INSTALLED_APPS += [
        "humans_txt",
    ]

* Add ``"humans_txt"`` to your URLs definitions:

.. code-block:: python

    # urls.py

    from django.urls import re_path


    urlpatterns += [
        re_path(r"^humans\.txt", include("humans_txt.urls")),
    ]

* Run ``$ python ./manage.py migrate`` in your project folder to apply app migrations.

Settings
--------
``HUMANS_TXT_BANNER``
    Contains a banner that placed at the start of humans.txt response. Defaults to ``""``.
``HUMANS_TXT_LAST_UPDATE``
    Contains project last update date. Defaults to ``None``.
``HUMANS_TXT_LANGUAGES``
    Contains list of site supported languages. Defaults to ``None``.

Usage
-----
* Include ``"humans_txt/includes/humans_txt_meta.html"`` in your base template rel meta tag to ``<head>`` HTML tag:

.. code-block:: django

    {# base.html #}

    <head>
        {% include "humans_txt/includes/humans_txt_meta.html" %}
    </head>

* Just fill Django humans.txt models instances in your admin in your taste.

Licensing
---------
django-humans-txt is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (a
t your option) any later version.
For complete license text see COPYING file.

Contacts
--------
**Project Website**: https://github.com/vint21h/django-humans-txt/

**Author**: Alexei Andrushievich <vint21h@vint21h.pp.ua>

For other authors list see AUTHORS file.

.. |GitHub| image:: https://github.com/vint21h/django-humans-txt/workflows/build/badge.svg
    :alt: GitHub
.. |Coveralls| image:: https://coveralls.io/repos/github/vint21h/django-humans-txt/badge.svg?branch=master
    :alt: Coveralls
.. |Requires| image:: https://requires.io/github/vint21h/django-humans-txt/requirements.svg?branch=master
    :alt: Requires
.. |pypi-license| image:: https://img.shields.io/pypi/l/django-humans-txt
    :alt: License
.. |pypi-version| image:: https://img.shields.io/pypi/v/django-humans-txt
    :alt: Version
.. |pypi-django-version| image:: https://img.shields.io/pypi/djversions/django-humans-txt
    :alt: Supported Django version
.. |pypi-python-version| image:: https://img.shields.io/pypi/pyversions/django-humans-txt
    :alt: Supported Python version
.. |pypi-format| image:: https://img.shields.io/pypi/format/django-humans-txt
    :alt: Package format
.. |pypi-wheel| image:: https://img.shields.io/pypi/wheel/django-humans-txt
    :alt: Python wheel support
.. |pypi-status| image:: https://img.shields.io/pypi/status/django-humans-txt
    :alt: Package status
.. _GitHub: https://github.com/vint21h/django-humans-txt/actions/
.. _Coveralls: https://coveralls.io/github/vint21h/django-humans-txt?branch=master
.. _Requires: https://requires.io/github/vint21h/django-humans-txt/requirements/?branch=master
.. _pypi-license: https://pypi.org/project/django-humans-txt/
.. _pypi-version: https://pypi.org/project/django-humans-txt/
.. _pypi-django-version: https://pypi.org/project/django-humans-txt/
.. _pypi-python-version: https://pypi.org/project/django-humans-txt/
.. _pypi-format: https://pypi.org/project/django-humans-txt/
.. _pypi-wheel: https://pypi.org/project/django-humans-txt/
.. _pypi-status: https://pypi.org/project/django-humans-txt/


