项目描述

PureStudy，学科知识分享网站。

学生可以使用这个网站，来浏览相应学科的知识点、学习总结，获取相关的资料。此外，他们可以选择上传文件，保存和分享自身的学习笔记。

总之，学生们可以使用这个网站，来浏览所学学科的相应知识点和学习笔记，以得到增强学习成果的作用。

PureStudy将会有几个核心功能：

学科与章节的分类导航：学生们可以在网站找到正确的学科、章节和知识点。

知识大纲与学习笔记的展示：学生们可以浏览静态的知识大纲和相应的学习笔记，获取学科的相应知识与要点。

知识思维导图的展示：学生们可以观看大幅的思维导图，获取整体的知识脉络，了解学科的知识点之间的逻辑联系。

复习总结与考试总结：学生们可以观看前辈们的学科复习笔记与考试总结，来增强自身对于学科考试的准备。

主要页面：

思维导图：

---

用户与需求概述

用户认知

此网站的主要用户群体，是对于诸多学科有明确学习需求的人群。

其中大多数为学生，以大学生为主。因为学生们普遍有着明确的考试需求，需要通过学科考试或者取得高分，因此会积极的去获取知识，提升自身的学习效果。

此网站就是为这些人群所服务的。网站所提供的主要功能，将致力于提升学生们对于知识点的掌握程度，连贯知识脉络，建立知识体系。

目标用户有着以下明确特点：

目标明确：有着确定的目标和学习需求，不会因为一时而改变。

辅助学习：学生们普遍有着自己的学习知识来源，比如课堂、教科书，他们并不需要大而全、事无巨细的知识描述，因为他们在课堂或者教科书里已经见够这个了。他们需要的是，对知识点的掌握、对重点的把控、理解知识点之间的联系、建立知识体系。因此，网站的作用，主要是辅助他们学习，总结归纳逻辑和知识点，帮助学生们获取更好的学习效果，而非代替课堂和教科书，成为学生们的一切知识来源。

用户群体集中且联系密切：学生们，以大学生为例，集中在大学校园里学习，平时生活、学习、交流的场所也较为集中，并且，同一个学校、专业、班级的学生们，普遍联系密切。这一点比社会上的职员们有过之而无不及。此外，学生平日里的交流和讨论，将会有很大一部分，涉及到学科、考试和学科知识。

所学知识点和学科体系重合程度大，变化较少：在大多数学校，同一个专业或相近专业，对于某一学科的学习要求与知识体系，大多重合程度高。大多只是考试范围、教科书版本的区别，对于同一知识点、同一学科、同一学科考题，多数区别不大，考试题型也较为相近。因而，四川的某一大学生，和上海的某一大学生，可以用同一套网站的学科知识分享，完成对同一学科的知识学习，阅读知识总结与思维导图，并应对考试。因而，这些学科知识，对于这些用户们而言，具有通用性。此外，大多数学科，或者大学考试科目，相应变化较少。此点可以查阅不同年份的考试试卷得知。某些少数学科，学科重点知识和考试重点，将会发生变化，这点暂不作重点讨论。

渴望建立单一学科之外的专业知识体系：这一点暂不是普遍用户的普遍特点，暂且只是作者个人的个人体会与大学总结。但个人觉得它很重要，并且比较引人注目，所以列出来。大多数大学学生，对此有着实际的需求。以学分切割的各个课程，将各个专业的整体知识体系，切割得过于凌乱了，以至于很多学生难以建立整体专业和行业所需的知识体系。

用户需求

以下实际上是产品实际上的需求分析。第一次迭代，将首先满足用户所需要的核心需求。

核心需求

学生们可以在网站上展示自己的复习笔记，和一些学习资料。

知识将会以学科、知识点的形式进行构建。

！！核心需求加一：夜间模式。（晚上看，突然觉得很亮。）

业务流程

用户通过学科、章节、知识点的分类和标签进行知识检索，查找到自己想要的内容

学生通过大纲模式进行简便、直接的阅读，可以在网页上进行清晰的阅读

学生们可以通过大而全的知识导图图片，进行总体的复习

额外内容

此外，学生们要可以通过客服邮件，发送自己的反馈，和送出想要给网站增添的内容

邮件将会由运营直接处理

---

功能简要解析

emmm，再贴一遍。

以下实际上是产品实际上的需求分析。第一次迭代，将首先满足用户所需要的核心需求。

核心需求

学生们可以在网站上展示自己的复习笔记，和一些学习资料。

知识将会以学科、知识点的形式进行构建。

！！核心需求加一：夜间模式。（晚上看，突然觉得很亮。）

业务流程

用户通过学科、章节、知识点的分类和标签进行知识检索，查找到自己想要的内容

学生通过大纲模式进行简便、直接的阅读，可以在网页上进行清晰的阅读

学生们可以通过大而全的知识导图图片，进行总体的复习

额外内容

此外，学生们要可以通过客服邮件，发送自己的反馈，和送出想要给网站增添的内容

邮件将会由运营直接处理

---

使用情景

此网站将会主要有两种使用情景。

平日学习

学生们在平日里对学科知识进行学习。

考试复习

学生们在考试前的复习阶段，对学科知识进行学习。因此，主要以：“时间紧迫，快速建立知识体系，找到重点”，来考虑。

---

内部代码逻辑

接下来将会是实现部分。

网站主要以python——Django框架的MVC架构，来进行搭建。

我将内部代码主要分为三类：数据类，前端类，逻辑类。

在总体逻辑上，主要是：构建数据库，构建数据与网页之间的内部逻辑，构建前端视图。

其实不麻烦。我也承认，这并不是一个很复杂、很难的网站啦。好用就成。也只需要好用。

感兴趣的读者，可以观看Django官方中文文档： https://docs.djangoproject.com/zh-hans/3.0/ ，里面详细介绍了我所用到的技术和框架的逻辑。

数据类：

主要建立了五张表。最重要的是Chapter表，这里面将会存放网站的主要内容。其他的表都是为它而服务的。

前端类：

先写前端类。

如下图所见，前端主要分为四个部分：

主要用于学科导航的导航栏；

展示当前学科名，用于章节导航的右侧侧边栏；

展示主要学习笔记内容（大纲）的正文部分；

有利于学生构建知识体系，目前放置在最下方，以大图展示的学科知识思维导图部分。

其中，下图为主要部分的前端，也就是用户最常用的页面。此外还有网站的首页、学科页面、制作人页面，这些都是用于网站的导航分类，便于用户找到自己需要的信息。这些页面都是基于同一套模板，页面相似，这里暂不做讨论。

前端主要使用了Bootsrtap技术。并未费太多功夫，感兴趣的观众，可以关注Bootstrap官方中文文档：https://v3.bootcss.com/css/。所用技术并不复杂，都是基础的前端知识。

前端主要以 Django 的 base.html（模板）为主。以base.html创建模板，然后各个部分，比如首页、章节、学科、章节等等，分别使用 {% block %}

{% endblock %} 的部分，放入自己的内容，组成相应的实际网站。

此外，参数以双括号，类似于{{ chapter.name }}，{{chapter.img}}（chapter为对象变量名）的方式，进行传递。可以观看下方的代码段。

并且，在章节列表等涉及到循环展示的地方，以下列方式进行：

 {% for chapter in chapter_list %}
         <h5><a href="{% url 'chapter' chapter.id %}">{{ chapter.name }}</a></h5>
 {% endfor %}

主要页面：

思维导图：

逻辑类

逻辑类代码，这里主要指的是前后端连接部分。

也就是将目标数据从数据库取出来，分类处理，并传递到前端网页。同时，收集前端的表单部分等，将之存储入数据库。

PureStudy的第一次迭代版本，逻辑类代码并不复杂，其主要代码如下：

def get_chapter(request, chapter_id):
    chapter = Chapter.objects.get(id = int(chapter_id))
    course = chapter.course
    chapter_list = Chapter.objects.filter(course = course)

    all_chapter = Chapter.objects.all()
        # 判断chaper_id是否为1或者最后一个
    if chapter.id == 1:
        previous_id = 1
        next_id = 2
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "当前页是第一章"
        next_text = "下一篇：" + next_chapter.name

    elif chapter.id == len(all_chapter):
        previous_id = chapter.id-1
        next_id = chapter.id
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "上一篇：" + previous_chapter.name
        next_text = "当前页是最后一章"

    # 如果不，则取到平常状态下的前一篇和后一篇的id
    else:
        previous_id = chapter.id - 1
        next_id = chapter.id + 1
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "上一篇：" + previous_chapter.name
        next_text = "下一篇：" + next_chapter.name

    # 根据id取出前一篇和后一篇章节的数据
    # previous_chapter = Chapter.objects.get(id = previous_id)
    # next_chapter = Chapter.objects.get(id = next_id)

    return render(request, 'read/chapter.html',{
        'chapter':chapter,
        'chapter_list': chapter_list,
        'course': course,
        'previous_chapter': previous_chapter,
        'next_chapter': next_chapter,
        'previous_text': previous_text,
        'next_text': next_text,
        })

def get_course(request, course_id):
    course = Course.objects.get(id = int(course_id))
    chapter_list = Chapter.objects.filter(course = course)
    leibie = course.leibie
    relat_course_list = Course.objects.filter(leibie = leibie)
    return render(request, 'read/course.html',{
        'course':course,
        'chapter_list':chapter_list,
        'relat_course_list': relat_course_list
        })

---

关键代码解析

定义数据库（models.py）:

from django.db import models

# Create your models here.

class Course(models.Model):
    name = models.CharField(max_length = 40, verbose_name = '课程名')
    about = models.CharField(max_length = 1000, default='', blank=True,
        null=True, verbose_name='课程描述')
    leibie = models.CharField(max_length = 40, verbose_name='课程类别')

    def __str__(self):
        return self.name

class Maker(models.Model):
    name = models.CharField(max_length = 40, verbose_name = '制作者')
    school = models.CharField(max_length = 40, default='', blank=True,
        null=True, verbose_name='所属学校')

    def __str__(self):
        return self.name

class Chapter(models.Model):
    name = models.CharField(max_length = 40, verbose_name = '章节名')
    about = models.CharField(max_length = 1000, default='', blank=True,
        null=True, verbose_name='章节描述')
    text = models.TextField(verbose_name='章节文本')
    link = models.TextField(default='', blank=True,
        null=True, verbose_name='章节链接')
    course = models.ForeignKey(Course, on_delete = models.CASCADE)
    maker = models.ForeignKey(Maker, on_delete = models.CASCADE)
    img = models.ImageField(upload_to='img', verbose_name='思维导图')
    img_name = models.CharField(max_length = 40,  default='', blank=True,
        null=True, verbose_name='导图名')

    def __str__(self):
        return self.name

class Img(models.Model):
    img = models.ImageField(upload_to='img', verbose_name='图像')
    name = models.CharField(max_length = 40,  default='', blank=True,
        null=True, verbose_name='图像名')

    def __str__(self):
        return self.name

逻辑处理（views.py）:

from django.shortcuts import render
from read.models import Chapter, Course
# Create your views here.
def index(request):
    return render(request, 'read/index.html')

def read(request):
    return render(request, 'read/read.html')

def get_chapter(request, chapter_id):
    chapter = Chapter.objects.get(id = int(chapter_id))
    course = chapter.course
    chapter_list = Chapter.objects.filter(course = course)

    all_chapter = Chapter.objects.all()
        # 判断chaper_id是否为1或者最后一个
    if chapter.id == 1:
        previous_id = 1
        next_id = 2
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "当前页是第一章"
        next_text = "下一篇：" + next_chapter.name

    elif chapter.id == len(all_chapter):
        previous_id = chapter.id-1
        next_id = chapter.id
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "上一篇：" + previous_chapter.name
        next_text = "当前页是最后一章"

    # 如果不，则取到平常状态下的前一篇和后一篇的id
    else:
        previous_id = chapter.id - 1
        next_id = chapter.id + 1
        previous_chapter = Chapter.objects.get(id = previous_id)
        next_chapter = Chapter.objects.get(id = next_id)
        previous_text = "上一篇：" + previous_chapter.name
        next_text = "下一篇：" + next_chapter.name

    # 根据id取出前一篇和后一篇章节的数据
    # previous_chapter = Chapter.objects.get(id = previous_id)
    # next_chapter = Chapter.objects.get(id = next_id)

    return render(request, 'read/chapter.html',{
        'chapter':chapter,
        'chapter_list': chapter_list,
        'course': course,
        'previous_chapter': previous_chapter,
        'next_chapter': next_chapter,
        'previous_text': previous_text,
        'next_text': next_text,
        })

def get_course(request, course_id):
    course = Course.objects.get(id = int(course_id))
    chapter_list = Chapter.objects.filter(course = course)
    leibie = course.leibie
    relat_course_list = Course.objects.filter(leibie = leibie)
    return render(request, 'read/course.html',{
        'course':course,
        'chapter_list':chapter_list,
        'relat_course_list': relat_course_list
        })

chapter.html网页代码：

{% extends 'read/base.html' %}

{% block title %}{{course.name}}{% endblock title %}
{% block page_header %}
    <h2>使用PureStudy，学习{{course.name}}
    </h2>
{% endblock page_header %}

{% block main %}
       <h2>{{course.name}}</h2>
       <p>{{course.about}}</p>
       <h3>课程章节</h3>

            {% for chapter in chapter_list %}
            <h5><a href="{% url 'chapter' chapter.id %}">{{ chapter.name }}</a></h5>
            {% endfor %}
{% endblock main %}

{% block side %}
       <h3>与之相关的课程：</h3>
       {% for relat_course in relat_course_list %}
       <h4><a href="{% url 'course' relat_course.id %}">{{ relat_course.name }}</a></h4>
       {% endfor %}
{% endblock side %}