EVOLUTION-MANAGER

Edit File: wysiwyg.py

from __future__ import absolute_import, unicode_literals

import markdown
from django.utils import six
from markdown.blockprocessors import BlockProcessor, OListProcessor
from markdown.postprocessors import RawHtmlPostprocessor
from markdown.treeprocessors import Treeprocessor
from markdown.util import etree

class SmartEmptyBlockProcessor(BlockProcessor):
    """Handles empty blocks in a more specialized way.

By default, Python-Markdown will trim away excess empty blocks, with
    the idea being that it doesn't matter how much whitespace exists
    between tags when rendered to HTML. However, in our case, we need to
    preserve whitespace in order to better match the resulting render to
    the input text.

We replace any empty lines with paragraph tags, which will safely stick
    around.

This is invoked before EmptyBlockProcessor.
    """

def test(self, parent, block):
        """Test that the processor should apply to the given block."""
        return not block or block.startswith('\n')

def run(self, parent, blocks):
        """Run the processor on the given blocks."""
        block = blocks.pop(0)

# We'll enter this while loop at least once, given that test() must
        # pass before run() is called.
        #
        # We know that blocks are separated by 2 blank lines. At a minimum,
        # we'll have 2 resulting paragraphs here.
        #
        # For odd-numbered sequences of newlines, we'll end up with a block
        # starting with a newline. We'll add a paragraph in this case, and
        # continue on.
        while self.test(parent, block):
            etree.SubElement(parent, 'p')

if block:
                block = block[1:]
            else:
                etree.SubElement(parent, 'p')
                return

# Add remaining lines to master blocks for later.
        #
        # We know there's a block here, given that test() passes if block
        # is None. We'll only exit the while loop to here if there's a block
        # without any leading newlines.
        blocks.insert(0, block)

class PreserveStartOListBlockProcessor(OListProcessor):
    """Applies CSS styles to any <ol> with a start= attribute.

This allows for CSS tricks to be performed that ensure that ordered list
    item numbers and item contents line up between source text and rendered
    text. It basically turns off the <li>'s native counter value and instead
    creates its own using :before and CSS counters. These tricks end up causing
    the start= attribute on the <ol> to be ignored.

This block processor extends the standard OListProcessor to also apply
    a CSS style to set the displayed counter value to the intended start
    value.

This replaces OListProcessor.
    """

def run(self, parent, blocks):
        """Run the processor on the given blocks."""
        # The base BlockProcessor class does not inherit from object, so
        # we can't use super() here.
        OListProcessor.run(self, parent, blocks)

list_el = self.lastChild(parent)

# The element should always be an <ol>, but better safe than sorry.
        if list_el.tag == 'ol' and 'start' in list_el.attrib:
            try:
                start = int(list_el.attrib['start'])
            except ValueError:
                start = 1

if start > 1:
                # Set a style= attribute to force the text to render with the
                # particular start value.
                list_el.attrib['style'] = 'counter-reset: li %s' % (start - 1)

class TrimTrailingEmptyParagraphs(Treeprocessor):
    """Removes empty paragraphs from the end of the tree.

This will remove any trailing empty paragraphs formerly added by
    SmartEmptyBlockProcessor. This step must be done after all the blocks are
    processed, so that we have a complete picture of the state of the tree.
    It's therefore performed right before we prettify the tree.
    """

def run(self, root):
        """Run the processor on the root of the tree."""
        num_children = len(root)
        start_i = num_children

# Loop through the children from end to beginning, counting how many
        # of them are empty <p> elements.
        for child in reversed(root):
            if child.tag != 'p' or child.text or len(child) > 0:
                break

start_i -= 1

if start_i < num_children:
            # Clear away any of the trailing paragraphs we found.
            root[start_i:] = []

class RTrimmedString(six.text_type):
    """Keeps a string free of trailing whitespace when replacing.

This is used in TrimmedRawHtmlPostprocessor to prevent the base
    RawHtmlPostprocessor code from adding an extra unnecessary newline when
    replacing raw HTML placeholders.

When that code calls replace(), the replaced contents will be rstrip'd,
    removing the newline. The result of that call is another RTrimmedString.

Note that other functions may result in a standard string being returned,
    but in the case of RawHtmlPostprocessor, this isn't really a concern.
    """

def replace(self, src, dest):
        """Replace the contents of the string.

This wraps the string's replace method to return another
        RTrimmedString instead of a standard string, rstripping any newlines
        in the process.
        """
        return RTrimmedString(
            super(RTrimmedString, self).replace(src, dest.rstrip('\n')))

class TrimmedRawHtmlPostprocessor(RawHtmlPostprocessor):
    """Post-processes raw HTML placeholders, without adding extra newlines.

Python Markdown's RawHtmlPostprocessor had a nasty habit of adding an
    extra newline after replacing a placeholder with stored raw HTML. That
    would cause extra newlines to appear in our output.

This version first converts the string to a RTrimmedString, preventing
    these newlines from being added. It then converts back to a standard
    string.
    """

def run(self, text):
        """Run the processor on the HTML."""
        return text.__class__(
            super(TrimmedRawHtmlPostprocessor, self).run(RTrimmedString(text)))

class WysiwygFormattingExtension(markdown.Extension):
    """Provides a series of WYSIWYG formatting rules for Markdown rendering.

We have a lot of specific rendering concerns that Python Markdown doesn't
    really address, or generally need to care about. We try very hard to match
    up newlines around various code blocks, and we have special ways we do
    ordered lists. The resulting rendered output is meant to look identical
    to the input text, as much as possible.

This extension renders a series of processors that ensures that the HTML
    output is in the format required for our rendering.

This is meant to be used with the following Markdown configuration
    and extensions:

.. code-block:: python

{
            'lazy_ol': False,
            'extensions': [
                'sane_lists', 'nl2br', 'djblets.markdown.extentions.wysiwyg',
            ],
        }
    """

def extendMarkdown(self, md, md_globals):
        """Extend the list of Markdown processors.

Each processor in this file will be registered in the order
        necessary for the smarter formatting.
        """
        md.parser.blockprocessors['olist'] = \
            PreserveStartOListBlockProcessor(md.parser)
        md.parser.blockprocessors.add(
            'smart-empty',
            SmartEmptyBlockProcessor(md.parser),
            '<empty')
        md.treeprocessors.add(
            'trim_empty_p',
            TrimTrailingEmptyParagraphs(md),
            '<prettify')
        md.postprocessors['raw_html'] = TrimmedRawHtmlPostprocessor(md)

def makeExtension(configs={}):
    """Create a Markdown extension instance for this file."""
    return WysiwygFormattingExtension(configs=configs)