Docutils (a.k.a. reStructuredText, reST, RST) support for django.
Project description
django-docutils · 
docutils (a.k.a. reStructuredText / rst / reST) support for Django.
Quickstart
Install django-docutils:
$ pip install django-docutils
Next, add django_docutils to your INSTALLED_APPS in your settings file:
INSTALLED_APPS = [
# ... your default apps,
'django_docutils'
]
Template tag
In your template:
{% load django_docutils %}
{% rst %}
# hey
# how's it going
A. hows
B. it
C. going
D. today
**hi**
*hi*
{% endrst %}
Template filter
In your template:
{% load django_docutils %}
{% filter rst %}
# hey
# how's it going
A. hows
B. it
C. going
D. today
**hi**
*hi*
{% endfilter %}
Template engine (class-based view)
You can also use a class-based view to render reStructuredText (reST).
If you want to use reStructuredText as a django template engine, INSTALLED_APPS isn't required,
instead you add this to your TEMPLATES variable in your settings:
TEMPLATES = [
# ... Other engines
{
"NAME": "docutils",
"BACKEND": "django_docutils.engines.Docutils",
"DIRS": [],
"APP_DIRS": True,
}
]
Now django will be able to scan for .rst files and process them. In your view:
from django_docutils.views import DocutilsView
class HomeView(DocutilsView):
template_name = 'base.html'
rst_name = 'home.rst'
Settings
# Optional, automatically maps roles, directives and transformers
DJANGO_DOCUTILS_LIB_RST = {
"docutils": {
"raw_enabled": True,
"strip_comments": True,
"initial_header_level": 2,
},
"roles": {
"local": {
"gh": "django_docutils.lib.roles.github.github_role",
"twitter": "django_docutils.lib.roles.twitter.twitter_role",
"email": "django_docutils.lib.roles.email.email_role",
}
},
"font_awesome": { # Transformer to inject <em class="<class>"></em>
"url_patterns": {
r".*github.com.*": "fab fa-github",
r".*twitter.com.*": "fab fa-twitter",
r".*news.ycombinator.com*": "fab fa-hacker-news",
r".*leanpub.com.*": "fab fa-leanpub",
r".*python.org.*": "fab fa-python",
r".*pypi.org.*": "fab fa-python",
r".*djangoproject.com.*": "fab fa-python",
r".*wikipedia.org.*": "fab fa-wikipedia",
r"((rtfd|readthedocs).)*$": "fab fa-books",
r"^mailto:.*": "fas fa-envelope",
r"((?!mywebsite.com|localhost).)*$": "fas fa-external-link",
}
},
}
# Optional
DJANGO_DOCUTILS_LIB_TEXT = {
"uncapitalized_word_filters": ["project.my_module.my_capitalization_fn"]
}
More information
- Python 3.8+
- Django 3.2+
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django_docutils-0.16.0.tar.gz.
File metadata
- Download URL: django_docutils-0.16.0.tar.gz
- Upload date:
- Size: 30.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | cf53196e00572b44e1a27dae276add39bc5d2f5861e42d26fe3c8cc7f502e626 |
|
| MD5 | c8539bdacd8d2de94e20c6c01988ed28 |
|
| BLAKE2b-256 | 1a51a050cc67191c18e3f428f227bf7dbf108c1e187bc974a8316650adc5af34 |
Provenance
File details
Details for the file django_docutils-0.16.0-py3-none-any.whl.
File metadata
- Download URL: django_docutils-0.16.0-py3-none-any.whl
- Upload date:
- Size: 44.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 087dbdc31300d531ee4cb2bcf98391f90549808f838cb6b831f40fc2e7568879 |
|
| MD5 | c06cc25256e5d7a6a23926d87f63e538 |
|
| BLAKE2b-256 | 73748fd0f2b960f9a653a81b42fe8f39e0100a5fa9da18229f0cede1943e6c59 |
