File size: 5,266 Bytes
d1ceb73 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 |
from typing import Dict, Any
from textwrap import indent
from ._list import render_list
from ..core import BaseRenderer, BlockState
from ..util import strip_end
class RSTRenderer(BaseRenderer):
"""A renderer for converting Markdown to ReST."""
NAME = 'rst'
#: marker symbols for heading
HEADING_MARKERS = {
1: '=',
2: '-',
3: '~',
4: '^',
5: '"',
6: "'",
}
INLINE_IMAGE_PREFIX = 'img-'
def iter_tokens(self, tokens, state):
prev = None
for tok in tokens:
# ignore blank line
if tok['type'] == 'blank_line':
continue
tok['prev'] = prev
prev = tok
yield self.render_token(tok, state)
def __call__(self, tokens, state: BlockState):
state.env['inline_images'] = []
out = self.render_tokens(tokens, state)
# special handle for line breaks
out += '\n\n'.join(self.render_referrences(state)) + '\n'
return strip_end(out)
def render_referrences(self, state: BlockState):
images = state.env['inline_images']
for index, token in enumerate(images):
attrs = token['attrs']
alt = self.render_children(token, state)
ident = self.INLINE_IMAGE_PREFIX + str(index)
yield '.. |' + ident + '| image:: ' + attrs['url'] + '\n :alt: ' + alt
def render_children(self, token, state: BlockState):
children = token['children']
return self.render_tokens(children, state)
def text(self, token: Dict[str, Any], state: BlockState) -> str:
text = token['raw']
return text.replace('|', r'\|')
def emphasis(self, token: Dict[str, Any], state: BlockState) -> str:
return '*' + self.render_children(token, state) + '*'
def strong(self, token: Dict[str, Any], state: BlockState) -> str:
return '**' + self.render_children(token, state) + '**'
def link(self, token: Dict[str, Any], state: BlockState) -> str:
attrs = token['attrs']
text = self.render_children(token, state)
return '`' + text + ' <' + attrs['url'] + '>`__'
def image(self, token: Dict[str, Any], state: BlockState) -> str:
refs: list = state.env['inline_images']
index = len(refs)
refs.append(token)
return '|' + self.INLINE_IMAGE_PREFIX + str(index) + '|'
def codespan(self, token: Dict[str, Any], state: BlockState) -> str:
return '``' + token['raw'] + '``'
def linebreak(self, token: Dict[str, Any], state: BlockState) -> str:
return '<linebreak>'
def softbreak(self, token: Dict[str, Any], state: BlockState) -> str:
return ' '
def inline_html(self, token: Dict[str, Any], state: BlockState) -> str:
# rst does not support inline html
return ''
def paragraph(self, token: Dict[str, Any], state: BlockState) -> str:
children = token['children']
if len(children) == 1 and children[0]['type'] == 'image':
image = children[0]
attrs = image['attrs']
title = attrs.get('title')
alt = self.render_children(image, state)
text = '.. figure:: ' + attrs['url']
if title:
text += '\n :alt: ' + title
text += '\n\n' + indent(alt, ' ')
else:
text = self.render_tokens(children, state)
lines = text.split('<linebreak>')
if len(lines) > 1:
text = '\n'.join('| ' + line for line in lines)
return text + '\n\n'
def heading(self, token: Dict[str, Any], state: BlockState) -> str:
attrs = token['attrs']
text = self.render_children(token, state)
marker = self.HEADING_MARKERS[attrs['level']]
return text + '\n' + marker * len(text) + '\n\n'
def thematic_break(self, token: Dict[str, Any], state: BlockState) -> str:
return '--------------\n\n'
def block_text(self, token: Dict[str, Any], state: BlockState) -> str:
return self.render_children(token, state) + '\n'
def block_code(self, token: Dict[str, Any], state: BlockState) -> str:
attrs = token.get('attrs', {})
info = attrs.get('info')
code = indent(token['raw'], ' ')
if info:
lang = info.split()[0]
return '.. code:: ' + lang + '\n\n' + code + '\n'
else:
return '::\n\n' + code + '\n\n'
def block_quote(self, token: Dict[str, Any], state: BlockState) -> str:
text = indent(self.render_children(token, state), ' ')
prev = token['prev']
ignore_blocks = (
'paragraph',
'thematic_break',
'linebreak',
'heading',
)
if prev and prev['type'] not in ignore_blocks:
text = '..\n\n' + text
return text
def block_html(self, token: Dict[str, Any], state: BlockState) -> str:
raw = token['raw']
return '.. raw:: html\n\n' + indent(raw, ' ') + '\n\n'
def block_error(self, token: Dict[str, Any], state: BlockState) -> str:
return ''
def list(self, token: Dict[str, Any], state: BlockState) -> str:
return render_list(self, token, state)
|