Metadata-Version: 1.1
Name: django-text
Version: 1.2.4
Summary: Intuitive text editing for the Django Admin.
Home-page: https://github.com/antonagestam/django-text/
Author: Anton Agestam
Author-email: msn@antonagestam.se
License: The MIT License (MIT)
Description: :warning:  This project is in early development and has bugs, contribution is welcome.
        
        # django-text
        
        Intuitive text editing for the Django Admin.
        
        ## Installation
        
        Install the package with pip.
        
        ```shell
        $ pip install django-text
        ```
        
        Add `text` to your installed packages.
        
        ```python
        # settings.py
        
        INSTALLED_APPS = (
            # ...
            'text',
        )
        ```
        
        Add `text.middleware.TextMiddleware` to your middleware.
        
        ```python
        # settings.py
        
        MIDDLEWARE = (
            # ...
            'text.middleware.TextMiddleware',
        )
        ```
        
        Run `migrate`.
        
        ```shell
        $ python manage.py migrate
        ```
        
        ## Usage
        
        ### Template tags
        
        Add `editable` tags to your templates. Beware this tag will show the name
        of the text node if there is no corresponding text nodes in the database.
        
        ```html
        <h1>{% editable header %}</h1>
        
        <div class="content">
            {% editable text_body %}
        </div>
        ```
        
        You can also use the `blockeditable` tag that let's you specify a default text
        that will show up if there is no database entry.
        
        ```html
        <div class="content">
            <h1>
                {% blockeditable header %}
                    Read My Awesome Text
                {% endblockeditable %}
            </h1>
            
            {% blockeditable content %}
                Put your default text here!
            {% endblockeditable %}
        </div>
        ```
        
        The `blockeditable` tags works with translation tags inside of it. So if you already
        have a translated site, you can wrap your content with this tag and only
        add text nodes for some of the languages that you support.
        
        ### Content editing
        
        ![django-text in action](/docs/printscreen.png)
        
        Now add text nodes with the corresponding names in the Django Admin. Currently raw text and [markdown](http://daringfireball.net/projects/markdown/) is supported.
        
        Missing text nodes will be added to the database automatically when their
        template tags are rendered. Blocktags will be added with their default
        text and inline tags will be added with the name of the node as the text content.
        
        To disable automatic updating of missing text nodes add the following to your settings.
        
        ```python
        AUTOPOPULATE_TEXT = False
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
