Metadata-Version: 2.1
Name: django-automatic-links
Version: 0.2.7
Summary: django-automatic-links is django app, that allows you to adding keywords that will be automatically converted into links.
Home-page: https://github.com/silentsokolov/django-automatic-links
Author: Dmitriy Sokolov
Author-email: silentsokolov@gmail.com
License: MIT
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Utilities
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*

.. image:: https://travis-ci.org/silentsokolov/django-automatic-links.svg?branch=master
   :target: https://travis-ci.org/silentsokolov/django-automatic-links

.. image:: https://codecov.io/gh/silentsokolov/django-automatic-links/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/silentsokolov/django-automatic-links


django-automatic-links
======================

django-automatic-links is a application, that allows
you to adding keywords that will be automatically converted into links.


Requirements
------------

* Python 2.7+ or Python 3.2+
* Django 1.8+


Installation
------------

Use your favorite Python package manager to install the app from PyPI, e.g.

Example:

``pip install django-automatic-links``


Add ``automatic_links`` to ``INSTALLED_APPS``:

Example:

.. code:: python

    INSTALLED_APPS = (
        ...
        'automatic_links',
        ...
    )


After run command ``manager.py migrate automatic_links``.

Example usage
-------------

In templates
~~~~~~~~~~~~

.. code:: html

    {% load automatic_link_tags %}
    ...
    <p>{{ object.text|add_links|safe }}</p>


In code
~~~~~~~

.. code:: python

    from automatic_links.utils import render_links

    text = render_links('text')


If you have many links and the process takes a long time, you need to
concern yourself with cache.


Settings
--------

``LINK_DEFAULT_LIMIT`` (default: ``0``)

``LINK_DEFAULT_EVERY`` (default: ``1``)

``LINK_DEFAULT_TARGET`` (default: ``'_blank'``)

``LINK_DEFAULT_NOFOLLOW`` (default: ``False``)

``LINK_DEFAULT_CSS_CLASS`` (default: ``None``)

These values ​​are only used in the model, you will still be able to
customize for each link their values​​.


