A set of Django helpers that make it easier to get up and running quickly with django-markupfield
Project description
django-markupfield-helpers is a set of Django helpers that make it easier to get up and running quickly with django-markupfield.
Source code is available on GitHub at mfcovington/django-markupfield-helpers. Information about django-markupfield is available on GitHub.
Installation
PyPI
pip install django-markupfield-helpers
GitHub (development branch)
pip install git+http://github.com/mfcovington/django-markupfield-helpers.git@develop
Configuration
Add markupfield_helpers to INSTALLED_APPS in settings.py:
INSTALLED_APPS = (
...
'markupfield_helpers',
)
Add a link to the CSS file for syntax highlighting in base.html or in a specific template.
{% load staticfiles %}
<link rel="stylesheet" type="text/css" href="{% static 'markupfield_helpers/css/syntax-highlighting.css' %}">
markupfield_helpers can be left out of INSTALLED_APPS if the provided CSS for syntax highlighting is not needed.
Helpers
MarkupField
The MarkupField class from markupfield_helpers can be used in place of the class of the same name from markupfield.
The markupfield_helpers version comes with four markup types defined:
Markdown (Default): Markdown 2 with extras (code-friendly, cuddled-lists, fenced-code-blocks, footnotes, and tables)
Markdown Basic: Markdown 2 without extras
Plain Text
reStructuredText
Here is a basic example of how to use the markupfield_helpers version of MarkupField:
from django.db import models
from markupfield_helpers.helpers import MarkupField
class Article(models.Model):
title = models.CharField(max_length=100)
slug = models.SlugField(max_length=100)
body = MarkupField()
MARKUP_FIELD_TYPES
Alternatively, MARKUP_FIELD_TYPES can be imported from markupfield_helpers.helpers and used as-is or modified. This is equivalent to the code above:
from django.db import models
from markupfield.fields import MarkupField
from markupfield_helpers.helpers import MARKUP_FIELD_TYPES
class Article(models.Model):
title = models.CharField(max_length=100)
slug = models.SlugField(max_length=100)
body = MarkupField(
default_markup_type='Markdown',
markup_choices=MARKUP_FIELD_TYPES,
)
Issues
If you experience any problems or would like to request a feature, please create an issue on GitHub.
Version 0.1.1
Revision History
0.1.0 2018-12-01
A set of Django helpers that make it easier to get up and running quickly with django-markupfield
0.1.1 2018-12-01
Fix manifest to include static CSS file
Project details
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
Hashes for django-markupfield-helpers-0.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 970c5bb6187640c6c281879b9da087d326ef56a2347e8d9652396f9d5194cdca |
|
MD5 | d05a99727b191b773aa3b44028204663 |
|
BLAKE2b-256 | 76b6bed8efeb81ec2941a3603ffdbf5883c92fc7ef6078e09d7ab1b2b507828b |
Hashes for django_markupfield_helpers-0.1.1-py33-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 517bb696443658ca06982e84f821e87756c8d3ab907cd39f1bc1ee035076f1cd |
|
MD5 | 9eea7ed07c82db4a0f8ba2692dc94d51 |
|
BLAKE2b-256 | fe7c820aa70f584e407c63bd3c4d9bc116eadeac9298bb30ef92865a022c1fb0 |