Skip to main content

Intuitive text editing for the Django Admin.

Project 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
```

## License

Copyright (c) 2015 Anton Agestam. django-text is released under the MIT license.
See the LICENSE file for more information and licenses for bundled code.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-text-1.2.6.tar.gz (86.7 kB view details)

Uploaded Source

File details

Details for the file django-text-1.2.6.tar.gz.

File metadata

  • Download URL: django-text-1.2.6.tar.gz
  • Upload date:
  • Size: 86.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-text-1.2.6.tar.gz
Algorithm Hash digest
SHA256 94585e53bdcfe359b9adebffe297451d8da8ea0ad0dc8ee79c640c85ecff2851
MD5 e92106089ba27bfec2398d1bb428aa8b
BLAKE2b-256 b263be91076de6ea012537a6ca66b4a0c892cc1375dfec83eb3fe95dd247bbaa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page