Использование Markdown в Django

Привет, Habr!

В этой статье мы научимся использовать Markdown вместе с Django на примере блога. Она написана для новичков, для базового ознакомления. Её в формате .md можно скачать в моём развивающемся Telegram канале.

Markdown — это простой язык разметки, используемый для создания форматированного текста (например, HTML) с помощью текстового редактора. Кстати, эту статью я писал, использую синтаксис Markdown)

Создание и активация виртуального окружения

python -m venv venv  source venv/bin/activate

Установка необходимых пакетов

pip install Django==4.2

Версия Django является LTS (версия с долгосрочной поддержкой) на момент 2024 года.

pip install markdown

Создание сайта и приложения

django-admin startproject markdown_blog  cd markdown_blog  python manage.py startapp posts

Мы создаем:

проект markdown_blog
приложение posts

Создание модели поста

Откройте файл posts/models.py, и напишите следующее:

from django.db import models from django.contrib.auth.models import User from django.urls import reverse   class Post(models.Model):     title = models.CharField(max_length=250)     slug = models.SlugField(max_length=250)     author = models.ForeignKey(User,     on_delete=models.CASCADE,     related_name='blog_posts')     body = models.TextField()  def __str__(self): return self.title  def get_absolute_url(self):         return reverse('post_detail',         args=[self.id])

Мы создали модель Post, в которой есть такие поля:

title — Заголовок, длиной до 250 символов
slug — Слаг, длиной до 250 символов
author — ForeignKey к модели User. При удалении пользователя удаляются все его посты.
body — Текст поста (с этим полем мы и поработаем)

Добавьте приложение в markdown_blog/settings.py:

INSTALLED_APPS = [   # other apps,   'posts.apps.PostsConfig', ]

Создайте и выполните миграции:

python manage.py makemigrations  python manage.py migrate

Регистрация модели в админ панели

Откройте файл posts/admin.py , и напишите следующее:

from django.contrib import admin from .models import Post  admin.site.register(Post)

Мы зарегистрировали модель Post в админ панели.

Создание представлений и шаблонов

Откройте файл posts/views.py, и напишите следующее:

from django.shortcuts import render, get_object_or_404  from .models import Post   def post_list(request):     posts = Post.objects.all()     return render(request,     'post_list.html',     {'posts': posts})  def post_detail(request, id): post = get_object_or_404(Post, id=id) return render(request, 'post_detail.html', {'post': post})

Мы создали два простых представления:

post_list — Получает из базы данных список постов, и передаёт его в шаблон post_list.html.
post_detail — Получает из базы данных пост по id, и передает его в шаблон post_detail.html.

Создайте директорию posts/templates и внутри создайте новый файл post_list.html. В него напишите следующее:

<!DOCTYPE html> <html lang="en">  <head>     <meta charset="UTF-8">     <title>List of posts</title> </head>  <body> {% for post in posts %} <h2> <a href="{{ post.get_absolute_url }}">{{ post.title }}</a> </h2> <div> {{ post.body|truncatewords_html:30 }} </div> {% endfor %} </body> </html>

Внутри posts/templates создайте файл post_detail.html. В него напишите следующее:

<!DOCTYPE html> <html lang="en">  <head>     <meta charset="UTF-8">     <title>Post: {{ post.title }}</title> </head>  <body> <a href='{% url "post_list" %}'>List of posts</a> <h2> {{ post.title }} </h2> <div> {{ post.body }} </div> </body> </html>

Откройте файл markdown_blog/urls.py, и напишите следующее:

from django.contrib import admin from django.urls import path  from posts import views  urlpatterns = [   path('admin/', admin.site.urls),   path('', views.post_list, name='post_list'),   path('<int:id>/', views.post_detail, name='post_detail'), ]

Мы создали два URL для наших представлений.

Добавление синтаксиса Markdown на сайт

Один из способов добавления синтаксиса Markdown на сайт — это создание конкретно-прикладного шаблонного фильтра.

Создайте пакет posts/templatetags, создайте файлы post_tags.py, и __init.py__. Файл post_tags.py будет содержать нашу библиотеку конкретно-прикладных шаблонных фильтров и тегов. В него напишите следующее:

from django import template from django.utils.safestring import mark_safe  import markdown  register = template.Library()   @register.filter(name='markdown') def markdown_format(text):     return mark_safe(markdown.markdown(text))

Мы используем предоставляемую веб-фреймворком Django функцию
mark_safe, чтобы помечать результат как безопасный для прорисовки в шаблоне исходный код HTML. По умолчанию Django не будет доверять никакому исходному коду HTML и будет экранировать его перед его вставкой
в результат. Единственными исключениями являются переменные, которые
помечены как безопасные, чтобы тем самым избежать экранирования. Такое
поведение не дает Django выводить потенциально опасный исходный код
HTML и позволяет создавать исключения, дабы возвращать безопасный исходный код HTML.

Отредактируйте файл templates/post_detail.html:

{% load post_tags %} <!DOCTYPE html> <html lang="en">  <head>     <meta charset="UTF-8">     <title>Post: {{ post.title }}</title> </head>  <body> <a href='{% url "post_list" %}'>List of posts</a> <h2> {{ post.title }} </h2> <div> {{ post.body|markdown }} </div> </body> </html>

Отредактируйте файл templates/post_list.html:

{% load post_tags %} <!DOCTYPE html> <html lang="en">  <head>     <meta charset="UTF-8">     <title>List of posts</title> </head>  <body> {% for post in posts %} <h2> <a href="{{ post.get_absolute_url }}">{{ post.title }}</a> </h2> <div> {{ post.body|markdown|truncatewords_html:30 }} </div> {% endfor %} </body> </html>

Проверка

Создайте суперпользователя:

python manage.py createsuperuser

Выполните все инструкции, и запустите сервер разработки:

python manage.py runserver

Пройдите по адресу 127.0.0.1:8000/admin, войдите, используя ранее введённые данные. Через админ панель добавьте несколько постов (используя синтаксис Markdown). Некоторые тексты есть ниже:

**Модель** — это единственный и точный источник информации о ваших данных. Он содержит основные поля и поведение данных, которые вы храните. Обычно каждая модель сопоставляется с одной таблицей базы данных.  ### Основы - - -  - Каждая модель представляет собой класс Python, который является подклассом `django.db.models.Model`. - Каждый атрибут модели представляет поле базы данных. - При всем этом Django предоставляет вам автоматически генерируемый API доступа к базе данных; см. [Создание запросов](https://docs.djangoproject.com/en/5.0/topics/db/queries/).   - - -

## MTV  Django подчиняется шаблону архитектурного дизайна **MTV** (Model-Template-View)  Обязанности в шаблоне архитектурного дизайна MTV Django распределе- ны следующим образом:  - **Model** (модель) – определяет логическую структуру данных и является обработчиком данных между базой данных и их представлением  - **Template** (шаблон) – это слой представления. В Django используется система текстовых шаблонов, в которой хранится все, что браузер прорисовывает на страницах.  - **View** (представление) – взаимодействует с базой данных через модель и передает данные в шаблон для их прорисовки и просмотра.   - - -

Перейдите по адресу 127.0.0.1:8000. Вы должны увидеть список постов. Нажмите на одну из ссылок, вы увидите всё содержимое страницы.

Итог

Мы реализовали один из вариантов использования синтаксиса Markdown в Django. Целью статьи не была реализация идеального блога, а лишь простейшая реализация такой задачи. В дальнейшем можно встроить на сайт редактор для удобного написания страниц с использованием Markdown. Но это уже совсем другая история), в дальнейшем рассмотрим.

P.S. это моя первая статья. Всем пока, Control + D!

ссылка на оригинал статьи https://habr.com/ru/articles/810119/