새로운 Django 프로젝트 생성
# 新建一个django项目 $ django-admin startproject mysite # 新建一个app $ django-admin startapp blog
프로젝트 구조
├── 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
일반적으로 urls.py에서 url을 설정하고, models에서 모델을 설정합니다. py 및 views.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'))
(?P< >d+) <>의 매개변수에 대한 값을 캡처하기 위해 (?P
# 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'), ]
네임스페이스 매개변수는 네임스페이스를 지정합니다. 즉, urls.py의 URL이 블로그 앱 아래에 있으므로 다른 앱 아래에 동일한 URL이 있어도 충돌이 발생하지 않습니다.
사용자가 기사에 액세스하려고 한다고 가정하면 blog:세부 보기 기능에 해당하는 URL을 자동으로 구문 분석하고 기사의 기본 키인 Article.pk를 세부 보기 기능에 전달합니다. details
은 blog/urls.py
에 지정된 name
을 수행하는 작업입니다.
# 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')) ]
orm 프레임워크의 기반인
<a href="{% url 'blog:detail' article.pk %}">{{ article.title }}</a>
django.db.models
디렉토리에 액세스하려면 새 blog/models.py
, Article
를 생성하세요. Category
>에는 Tag
3가지 모델이 있습니다.
<a href="{% url 'blog:category' category.pk %}">{{ category.name }}</a>
Django는 위에서 언급한 CharFiled
, TestField
, DateTimeFiled
등 유용한 필드를 많이 제공합니다. 자세한 내용은 공식 문서를 참조하세요.
Django에서는 일대다를 one으로 설정하는데, 이는 기사의 분류에 해당하며, ForeignKey는 데이터베이스의 외래키입니다. on_delete=models.SET_NULL은 카테고리(카테고리)를 삭제한 후 해당 카테고리에 속한 모든 Article의 외래 키가 null(비어 있음)로 설정되므로 동시에 null=True로 설정한다는 의미입니다. 다대다 방식은 다르므로 양쪽을 모두 구성해야 합니다. 자세한 내용은 공식 문서를 참조하세요.
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})
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
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]
먼저 project_name/settings.py
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)
에서 해당 구성 파일을 구성해야 합니다. 정의가 완료된 후, 다음 명령을 실행하여 데이터베이스에 해당 데이터 테이블을 생성합니다:
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', } }
Mozila의 튜토리얼과 공식 문서를 참조하세요.
아래에서는 Markdown2를 사용하므로 INSTALLED_APP에 markdown2를 추가해야 합니다. 그런데 이 mardown 파싱이 매우 열악하여 마친 후 해당 markdown을 다운로드해야 합니다. CSS 파일을 보면 전용 웹사이트가 있습니다.
$ python manage.py makemigrations $ python manage.py migrate
마크다운 처리를 수행해야 하므로 get_queryset
을 재정의했습니다. 해당 처리를 수행하지 않으려면 model
을 직접 공식화하면 다음과 같은 추가 필드를 추가할 수 있습니다. 앞으로는 홈페이지 사이드바에 목차와 태그를 표시할 예정이므로 여기에 get_context_data
, category_list
를 추가해야 합니다. tag_list
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)
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)
루프 태그, {% for %}
judgment 태그 {% if %}
는 매우 일반적으로 사용되는 태그입니다{{ variable }}
가 지정되어 있고, context_object_name = "article_list"
에서 마크다운 처리가 이루어졌습니다. get_queryset()
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(), })
{% for article in article_list %} {{article.title}}
{% extends "base_generic.html" %} {% block content %} ... {% endblock %}
TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [os.path.join(BASE_DIR, 'blog/templates')] , 'APP_DIRS': True, ... ]
<!DOCTYPE html> {% load staticfiles %} <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>Myblog</title> <link rel="stylesheet" href="{% static 'lib/css/bootstrap.min.css' %}"> <link rel="stylesheet" href="{% static 'blog/css/style.css' %}"> <link rel="stylesheet" href="{% static 'blog/css/pygments/github.css' %}"> </head> ...
# mysite/settings.py STATIC_URL = '/static/' STATICFILES = os.path.join(BASE_DIR, 'blog/static')
를 사용하여 uwsgi 프로세스를 시작하고 uwsgi -i uwsgi.ini
: nohup &
server { listen 80; location /static/ { alias /home/omrsf/mysite/blog/static/; } location / { uwsgi_pass 127.0.0.1:8001; include /etc/nginx/uwsgi_params; } }