Adds Renderer.default_output method for alternative output formats #20
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Useful for building alternative output methods (like docx) using the Renderer class.
This is useful for using an empty list as the default output value instead of a string. This allows renderers to build their own stack of directives using Python objects. This makes it easy to convert that tree of objects into other document formats besides HTML (such as docx).
|
👍 that would be very helpful for one of my projects. This would also make mistune a real parser and not just a string translator. |
|
What we'd need is a real parser that outputs a tree of the Markdown structure without rendering it first. The lexers are a first step but I'd need to replicate quite a lot of the |
|
Having the ability get the parse tree as emerald-tree/elementtree would be a boon. |
|
It has been merged into 96edd43 Working on |
|
Great! Thanks |
Closed
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The new method returns the default, empty output value for the renderer.
All renderer methods use the '+=' operator to append to this value. Default is a string so rendering HTML can build up a result string with the rendered Markdown.
Can be overridden by Renderer subclasses to be types like an empty list, allowing the renderer to create a tree-like structure to represent the document (which can then be reprocessed later into a separate format like docx or pdf).
Includes an end-to-end test. I've been using it in my own projects for about 2 weeks now.