Python-Django

Préparation

Créer un nouveau projet Django

# 新建一个django项目
$ django-admin startproject mysite
# 新建一个app
$ django-admin startapp blog

Structure du projet

├── blog
│   ├── admin.py
│   ├── apps.py
│   ├── __init__.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── manage.py
└── mysite
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

# mysite/settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog', 
    'markdown2'
]

$ python3 manage.py runserver

$ python manage.py collectstatic

Configurez généralement l'url dans urls.py , configurez le modèle dans models.py et configurez la vue dans views.py.

urls.py

Function views

1. Add an import:  from my_app import views
2. Add a URL to urlpatterns:  url(r'^$', views.home, name='home')

Class-based views

1. Add an import:  from other_app.views import Home
2. Add a URL to urlpatterns:  url(r'^$', Home.as_view(), name='home')

Including another URLconf

1. Import the include() function: from django.conf.urls import url, include
2. Add a URL to urlpatterns:  url(r'^blog/', include('blog.urls'))

# blog/urls.py

from django.conf.urls import url
from blog import views

urlpatterns = [
    url(r'^blog/$', views.IndexView.as_view(), name='index'),
    url(r'^blog/article/(?P<article_id>\d+)$', views.ArticleDetailView.as_view(), name='detail'),
    url(r'^blog/category/(?P<cate_id>\d+)$', views.CategoryView.as_view(), name='category'),
    url(r'^blog/tag/(?P<tag_id>\d+)$', views.TagView.as_view(), name='tag'),
]

Utilisez la forme (?P<>d) pour capturer la valeur du paramètre dans <>, par exemple (?Pd lors de l'accès à /blog/article/3, 3). sera capturé dans article_id, cette valeur sera transmise à vues.ArticleDetailView.

# mysite/urls.py

from django.conf.urls import url, include
from django.contrib import admin
from blog import views

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'', include('blog.urls', namespace='blog', app_name='blog'))
]

Le paramètre namespace spécifie l'espace de noms pour nous, ce qui signifie que l'url dans urls.py se trouve sous l'application de blog, donc il n'y aura pas de conflit même s'il y a la même URL sous différentes applications.

Supposons que l'utilisateur souhaite accéder à un article, il analysera automatiquement l'URL correspondant à la fonction blog:detail view et transmettra article.pk (la clé primaire de l'article) à la fonction de vue détaillée, details c'est ce que nous faisons blog/urls.py spécifié en name.

<a href="{% url &#39;blog:detail&#39; article.pk %}">{{ article.title }}</a>

Si vous souhaitez accéder à un répertoire

<a href="{% url &#39;blog:category&#39; category.pk %}">{{ category.name }}</a>

models.py

django.db.models est la base du framework ORM, créez-en un nouveau dans blog/models.pyArticle, Category, Tag trois modèles.

class Article(models.Model):
    STATUS_CHOICES = (
        ('d', 'Draft'),
        ('p', 'Published'),
    )
    
    # 仍然使用默认的 objects 作为 manager 的名字
    objects = ArticleManager()

    title = models.CharField('标题', max_length=70)
    body = models.TextField('正文')
    created_time = models.DateTimeField('创建时间', auto_now_add=True)
    last_modified_time = models.DateTimeField('修改时间', auto_now=True)
    status = models.CharField('文章状态', max_length=1, choices=STATUS_CHOICES)
    # blank和null要同时设置为null，详情参考官方文档
    abstract = models.CharField('摘要', max_length=54, blank=True, null=True, 
                                help_text="可选，如若为空将摘取正文的前54个字符")
    views = models.PositiveIntegerField('浏览量', default=0)
    likes = models.PositiveIntegerField('点赞数', default=0)
    topped = models.BooleanField('置顶', default=False)
    
    category = models.ForeignKey('Category', verbose_name='分类', null=True, on_delete=models.SET_NULL)
    tags = models.ManyToManyField('Tag', verbose_name='标签集合', blank=True)

    def __str__(self):
        return self.title

    class Meta:
        ordering = ['-last_modified_time']

    # 新增 get_absolute_url 方法
    def get_absolute_url(self):
        # 这里 reverse 解析 blog:detail 视图函数对应的 url
        return reverse('blog:detail', kwargs={'article_id': self.pk})

Django nous fournit de nombreux champs utiles, tels que les CharFiled, TestField, DateTimeFiled mentionnés ci-dessus. Pour plus de détails, veuillez vous référer à la documentation officielle.

Un-à-plusieurs dans Django est défini sur un, ce qui correspond à la classification de l'article, et ForeignKey est la clé étrangère de la base de données. on_delete=models.SET_NULL signifie qu'après la suppression d'une catégorie (catégorie), les clés étrangères de tous les articles de la catégorie sont définies sur null (vides), nous définissons donc null=True en même temps. Plusieurs-à-plusieurs est différent, les deux côtés doivent être configurés. Veuillez vous référer à la documentation officielle pour plus de détails.

class Category(models.Model):
    name = models.CharField('类名', max_length=20)
    created_time = models.DateTimeField('创建时间', auto_now_add=True)
    last_modified_time = models.DateTimeField('修改时间', auto_now=True)

    def __str__(self):
        return self.name

class Tag(models.Model):
    name = models.CharField('标签名', max_length=20)
    created_time = models.DateTimeField('创建时间', auto_now_add=True)
    last_modified_time = models.DateTimeField('修改时间', auto_now=True)

    def __str__(self):
        return self.name

Implémentation de la fonction commentaire

class BlogComment(models.Model):
    user_name = models.CharField('评论者名字', max_length=100)
    user_email = models.EmailField('评论者邮箱', max_length=255)
    body = models.TextField('评论内容')
    created_time = models.DateTimeField('评论发表时间', auto_now_add=True)
    article = models.ForeignKey('Article', verbose_name='评论所属文章', on_delete=models.CASCADE)

    def __str__(self):
        return self.body[:20]

class ArticleManage(models.Manager):
    """
    继承自默认的 Manager ，为其添加一个自定义的 archive 方法
    """
    def archive(self):
        date_list = Article.objects.datetimes('created_time', 'month', order='DESC')
        # 获取到降序排列的精确到月份且已去重的文章发表时间列表
        # 并把列表转为一个字典，字典的键为年份，值为该年份下对应的月份列表
        date_dict = defaultdict(list)
        for d in date_list:
            date_dict[d.year].append(d.month)
        # 模板不支持defaultdict，因此我们把它转换成一个二级列表，由于字典转换后无序，因此重新降序排序
        return sorted(date_dict.items(), reverse=True)

Il faut d'abord configurer le fichier de configuration correspondant dans project_name/settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', 
        'NAME': 'DB_NAME',
        'USER': 'DB_USER',
        'PASSWORD': 'DB_PASSWORD',
        'HOST': 'localhost',   # Or an IP Address that your DB is hosted on
        'PORT': '3306',
    }
}

Une fois la définition terminée, nous exécutons la commande suivante pour générer la table de données correspondante dans la base de données :

$ python manage.py makemigrations

$ python manage.py migrate

admins.py

Reportez-vous au tutoriel de Mozila et à Combined avec la documentation officielle.

views.py

Markdown2 est utilisé ci-dessous, donc markdown2 doit être ajouté à INSTALLED_APP Cependant, cette analyse mardown est très mauvaise, et après l'avoir terminée, vous devez télécharger la démarque correspondante. css , il existe un site dédié.

from blog.models import Article, Tag, Category
from django.views.generic import ListView, DetailView
import markdown2

class IndexView(ListView):
    # template_name属性用于指定使用哪个模板进行渲染
    template_name = "blog/index.html"

    # context_object_name属性用于给上下文变量取名（在模板中使用该名字）
    context_object_name = "article_list"

    def get_queryset(self):
        article_list = Article.objects.filter(status='p')
        for article in article_list:
            article.body = markdown2.markdown(article.body, )
        return article_list

    def get_context_data(self, **kwargs):
        kwargs['category_list'] = Category.objects.all().order_by('name')
        # 调用 archive 方法，把获取的时间列表插入到 context 上下文中以便在模板中渲染
        kwargs['date_archive'] = Article.objects.archive()
        kwargs['tag_list'] = Tag.objects.all().order_by('name')
        return super(IndexView, self).get_context_data(**kwargs)

Parce que nous devons effectuer un traitement de démarque, nous avons redéfini get_queryset Si vous ne souhaitez pas effectuer le traitement correspondant, formulez simplement model directement get_context_data peut ajouter des champs supplémentaires. , par exemple, nous souhaitons afficher les répertoires et les balises dans la barre latérale de la page d'accueil à l'avenir, nous devons donc ajouter un category_list et un tag_list ici.

class ArticleDetailView(DetailView):
    model = Article
    template_name = "blog/detail.html"
    context_object_name = "article"
    # pk_url_kwarg会自动和model中相应的主键对应，aritlce_id就是下面配置的URLCONF
    pk_url_kwarg = 'article_id'

    # 为了让文章以markdown形式展现，我们重写get_object()方法
    def get_object(self):
        obj = super(ArticleDetailView, self).get_object()
        obj.body = markdown2.markdown(obj.body)
        return obj
        
    # 新增 form 到 context
    def get_context_data(self, **kwargs):
        kwargs['comment_list'] = self.object.blogcomment_set.all()
        kwargs['form'] = BlogCommentForm()
        return super(ArticleDetailView, self).get_context_data(**kwargs)

class CategoryView(ListView):
    template_name = "blog/index.html"
    context_object_name = "article_list"
    
    def get_queryset(self):
        # url里的cate_id传递给CategoryView，传递的参数在kwargs属性中获取
        article_list = Article.objects.filter(category=self.kwargs['cate_id'],status='p')
        for article in article_list:
            article.body = markdown2.markdown(article.body, )
        return article_list

    def get_context_data(self, **kwargs):
        # 增加一个category_list,用于在页面显示所有分类，按照名字排序
        kwargs['category_list'] = Category.objects.all().order_by('name')
        return super(CategoryView, self).get_context_data(**kwargs)

class TagView(ListView):
    template_name = "blog/index.html"
    context_object_name = "article_list"

    def get_queryset(self):
        """
        根据指定的标签获取该标签下的全部文章
        """
        article_list = Article.objects.filter(tags=self.kwargs['tag_id'], status='p')
        for article in article_list:
            article.body = markdown2.markdown(article.body, extras=['fenced-code-blocks'], )
        return article_list

    def get_context_data(self, **kwargs):
        kwargs['tag_list'] = Tag.objects.all().order_by('name')
        return super(TagView, self).get_context_data(**kwargs)

from django.views.generic.edit import FormView

class CommentPostView(FormView):
    form_class = BlogCommentForm
    template_name = 'blog/detail.html' 

    def form_valid(self, form):
        target_article = get_object_or_404(Article, pk=self.kwargs['article_id'])
        # 调用ModelForm的save方法保存评论，设置commit=False则先不保存到数据库，
        # 而是返回生成的comment实例，直到真正调用save方法时才保存到数据库。
        comment = form.save(commit=False)
        # 把评论和文章关联
        comment.article = target_article
        comment.save()
        # 评论生成成功，重定向到被评论的文章页面，get_absolute_url 请看下面的讲解。
        self.success_url = target_article.get_absolute_url()
        return HttpResponseRedirect(self.success_url)

    def form_invalid(self, form):
        target_article = get_object_or_404(Article, pk=self.kwargs['article_id'])

        # 不保存评论，回到原来提交评论的文章详情页面
        return render(self.request, 'blog/detail.html', {
            'form': form,
            'article': target_article,
            'comment_list': target_article.blogcomment_set.all(),
        })

modèle

{% for %} balise de boucle, {% if %}balise de juge {{ variable }} sont des balises très couramment utilisées

<.>Nous pouvons l'utiliser comme ceci dans le fichier modèle

a été spécifié dans vues.py, et le traitement de démarque a été effectué dans context_object_name = "article_list"get_queryset()

définit généralement un modèle parent commun. . :

{% for article in article_list %}
    {{article.title}}

Il semble être configuré comme ceci :

{% extends "base_generic.html" %}

{% block content %}
...
{% endblock %}

Fichier statique

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'blog/templates')]
        ,
        'APP_DIRS': True,
...
]

Le code source étant perdu, je ne me souviens plus du situation spécifique, le chemin du fichier statique doit être défini. Eh bien, si le fichier js se charge anormalement, il peut s'agir d'un problème avec l'ordre de chargement.

base_generic.html est probablement au format suivant :

Il semble y avoir un problème avec les paramètres suivants :

<!DOCTYPE html>
{% load staticfiles %}
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Myblog</title>
    <link rel="stylesheet" href="{% static &#39;lib/css/bootstrap.min.css&#39; %}">
    <link rel="stylesheet" href="{% static &#39;blog/css/style.css&#39; %}">
    <link rel="stylesheet" href="{% static &#39;blog/css/pygments/github.css&#39; %}">
</head>
...

Pour plus de détails, veuillez vous référer à la documentation officielle

# mysite/settings.py
STATIC_URL = '/static/'
STATICFILES = os.path.join(BASE_DIR, 'blog/static')

Déploiement

Utilisez uwsgi nginx

/etc/nginx/sites-available/mysite.conf, blog est le nom de l'application et le statique Le fichier est placé en dessous. Il est recommandé de le placer directement sous monsite, modèle. Il en va de même :

server {
    listen 80;

    location /static/ {
        alias /home/omrsf/mysite/blog/static/;
    }

    location / {
        uwsgi_pass 127.0.0.1:8001;
        include     /etc/nginx/uwsgi_params;
    }
}

pour démarrer le processus uwsgi, combiné avec

 : uwsgi -i uwsgi.ininohup &Amélioration

[uwsgi]
socket = 127.0.0.1:8001
chdir=/home/ormsf/mysite/
wsgi-file = mysite/wsgi.py

processes = 2
threads = 4

chmod-socket = 664

L'article actuel est directement dans admin.py Enregistrez le modèle puis accédez au fond d'administration pour le publier. Vous pouvez en faire une interface API et un éditeur en ligne. Ajoutez une fonction d'authentification utilisateur de base.

Points de connaissance fragmentaires

La différence entre null et vide

null est pour la base de données. Si null = True, cela signifie que le champ de. la boîte de base de données est vide.

• le blanc est destiné aux formulaires. Si vide = True, cela signifie que vous n'avez pas besoin de remplir ce champ lorsque vous remplissez votre formulaire, par exemple lors de l'ajout d'un enregistrement de modèle dans l'administration. interface. Ce que vous pouvez voir intuitivement, c'est que le champ n'est pas en gras.

• render et render_response

Utilisez d'abord le rendu.

get_absolute_url

le modèle a un get_absolute_url, qui peut être combiné avec reverse.

Pour plus d'articles sur Python-Django, veuillez faire attention au site Web PHP chinois !