Django - Сабақ 064. Python Markdown кеңейтімін қалай жазуға болады

Python, markdown, MarkdownField, Django

Осы сайтта және бірнеше басқа жобаларда мен мәтін жазу үшін markdown қызметін белсенді қолданамын, содан кейін одан html кодын жасаймын. Соңында мен кейбір нақты функцияларды орындайтын бірнеше кеңейтімдер жаздым, бұл менің жобаларымда html кодын жасауды қолдауды біршама жеңілдетеді.

Мысалы, жобалардың бірінде сайтқа қосылатын және жазбаға тіркелген мәтінге суреттер қосылады. Сәйкесінше, кескіндердің nginx бұл кескінді жіберетін арнайы URL мекенжайы бар. Бірақ мен сайтқа жүктеп салынған кескіндер үшін белгілеу кескінін ендіру кодын қарапайым етіп жасадым.

Кескінді ендіру кодының сипаттамасы

Яғни, бұл жағдайда кескінді енгізу коды келесідей көрінеді

![](e272ed2bca9e46e8b017c20eddd1e5b2.webp)

Бұл кодта e272ed2bca9e46e8b017c20eddd1e5b2.webp кескін файлының аты ғана бар. Бұл іске асырылатын жобада барлық кескіндер uuid көмегімен бірегей жасалған атаумен бір каталогқа жүктеледі және кескін қысылады және WEBP пішіміне түрлендіріледі. Мұны қалай істеу керектігі туралы қосымша ақпаратты ImageField файлына сақтау кезінде кескінді WEBP пішіміне қалай түрлендіруге болады мақаласынан біле аласыз.

Сонымен, суреттер постқа тіркелгенде, олар сол жобада мәтіннің астындағы галерея ретінде көрсетіледі, бірақ оны хабарлама мәтінінің ішіне де қосуға болады. Бірақ пайдаланушыларды белгілеудегі кескіннің ұзақ URL мекенжайымен шатастырмау үшін, сондай-ақ кескін жолдарын одан әрі ықтимал өзгертуді жеңілдету үшін осы жеңілдетілген кескін кодынан html img тегін жасау функциясы жүзеге асырылды.

Python белгілеу кеңейтімін қосу

Python белгілеуімен html мәтінін жасаңыз

Python-Markdown бумасы HTML құру үшін пайдаланылады. Генерация коды келесідей болуы мүмкін:

def generate_html(markdown_text):
    return markdown.markdown(
                markdown_text,
                extensions=['markdown.extensions.attr_list',
                            'markdown.extensions.tables',
                            'markdown.extensions.fenced_code',
                            'markdown.extensions.nl2br',
                            'markdown.extensions.toc'],
                output_format='html5'
            )

Көріп отырғаныңыздай, генерациялау кезінде кодты генерациялау нәтижесіне әсер ететін кеңейтімдерді санауға болады. Дәл осы кеңейтімдерде біз кеңейтімді қосамыз.

Кеңейтім қосу

Django жобасында core деп аталатын қолданба бар делік. Оның ішінде каталогты бума ретінде инициализациялайтын __init__.py файлы бар кеңейтімдер каталогын, сонымен қатар кеңейтім атауы бар файлды жасайық. Ол осылай көрінуі керек.

• core/
  • extensions/
    • __init__.py
    • image.py

Image.py файлы

Енді image.py файлының мазмұнын қосамыз.

# -*- coding: utf-8 -*-

import markdown
from markdown.util import etree


class ImageExtension(markdown.Extension):

    def add_inline(self, md, name, klass, re):
        pattern = klass(re)
        pattern.md = md
        pattern.ext = self
        md.inlinePatterns.add(name, pattern, "<reference")

    def extendMarkdown(self, md, md_globals):
        self.add_inline(md, 'internal_image', InternalImage, r'!\[\]\((?P<internal_image>[a-zA-Z0-9]+).webp\)')


class InternalImage(markdown.inlinepatterns.Pattern):

    def handleMatch(self, m):
        return render_image(m.group('internal_image'))


def render_image(internal_image_name):
    img = etree.Element('img')
    img.set('src', '/media/photos/{}.webp'.format(internal_image_name))
    img.set('class', 'd-block mx-auto mw-100 mvh-75')
    return img


def makeExtension(**kwargs):
    return ImageExtension(**kwargs)

Бұл жағдайда InternalImage үлгісін пайдаланып Markdown белгілеуін кеңейтетін ImageExtension кеңейтімін жасаймыз.
Бұл үлгі add_inline әдісіне жіберілген қалыпты өрнекке сәйкес келетін барлық сурет тегтеріне қолданылады, ол соңында үлгіні белгілеу коды өңдеушісі бар үлгілер тізіміне қосады.

makeExtension функциясы Python-Markdown қақпағы астында шақырылады және кеңейтімді тіркейді.

Қорытынды

Соңғы сөз ретінде жаңа кеңейтімді html кодыңыздың генерациясына қосамыз.

def generate_html(markdown_text):
    return markdown.markdown(
                markdown_text,
                extensions=['core.extensions.image',
                            'markdown.extensions.attr_list',
                            'markdown.extensions.tables',
                            'markdown.extensions.fenced_code',
                            'markdown.extensions.nl2br',
                            'markdown.extensions.toc'],
                output_format='html5'
            )