Metadata-Version: 2.1
Name: django-markupfield-helpers
Version: 0.1.0
Summary: A set of Django helpers that make it easier to get up and running quickly with django-markupfield
Home-page: https://github.com/mfcovington/django-markupfield-helpers
Author: Michael F. Covington
Author-email: mfcovington@gmail.com
License: BSD License
Keywords: markup markdown
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.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: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Documentation
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: Django (>=1.11)
Requires-Dist: django-markupfield (>=1.3.5)
Requires-Dist: docutils (>=0.12)
Requires-Dist: markdown2 (>=2.3.0)
Requires-Dist: Pygments (>=2.0.2)

**************************
django-markupfield-helpers
**************************

``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 <https://github.com/mfcovington/django-markupfield-helpers>`_. Information about ``django-markupfield`` is available on `GitHub <https://github.com/jamesturk/django-markupfield>`_.


.. contents:: :local:


Installation
============

**PyPI**

.. code-block:: sh

    pip install django-markupfield-helpers


**GitHub (development branch)**

.. code-block:: sh

    pip install git+http://github.com/mfcovington/django-markupfield-helpers.git@develop


Configuration
=============

Add ``markupfield_helpers`` to ``INSTALLED_APPS`` in ``settings.py``:

.. code-block:: python

    INSTALLED_APPS = (
        ...
        'markupfield_helpers',
    )


Add a link to the CSS file for syntax highlighting in ``base.html`` or in a specific template.

.. code-block:: python

    {% 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``:

.. code-block:: python

    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:


.. code-block:: python

    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 <https://github.com/mfcovington/django-markupfield-helpers/issues>`_ on GitHub.


*Version 0.1.0*


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


