1、建立项目

• 制定规范

编写一个名为“学习笔记”的Web应用程序，让用户能够记录感兴趣的主题，并在学习每个主题的过程中添加条目。“学习笔记”的主页对这个网站进行描述，并邀请用户注册或登录。用户登录后，就可创建新主题、添加新条目以及阅读既有的条目。

• 建立虚拟环境

虚拟环境是系统思维一个位置，可以在其中安装包，并将其与其他python包隔离。为项目新建一个目录，将其命名为learning_note,再在终端中切换到这个目录，并创建一个虚拟环境，我使用的是python 3.6.1。

learning_note> python -m venv ll_env
learning_note>

这里运行模块venv，并使用它来创建一个名为ll_env的虚拟环境。

• 激活虚拟环境

learning_note>ll_env\Scripts\activate
(ll_env)learning_note>

环境处于活动状态时，环境名将包含在括号内，在这种情况下，你可以在环境中安装包，并使用已安装的包。在ll_env中安装的包仅在该环境处于活动状态时才可用。

停止使用虚拟环境

(ll_env)learning_note>deactivate
learning_note>

• 安装Django,它仅在虚拟环境处于活动状态时才可用

  
  
  安装Django

• 在Django中创建项目

(ll_env)learning_note>django-admin.py startproject learning_note .
(ll_env)learning_note>dir
learning_note ll_env manage.py
(ll_env)learning_note>dir learning_note
__init__.py settings.py urls.py wsgi.py

1.创建一个名为learning_note的项目，这个命令末尾的句点让新项目使用合适的目录结构，这样开发完成后可轻松将应用程序部署到服务器。
2.文件settings.py指定Django如何与你的系统交互以及如何管理项目。
文件urls.py告诉Django应创建哪些网页来响应浏览器请求。
文件wsgi.py帮助Django提供它创建的文件。

• 创建数据库用于存储项目中使用的信息

(ll_env)learning_note>python manage.py migrate
(ll_env)learning_note>dir

• 查看项目，核实Django是否正确地创建了项目
  (ll_env)learning_note>python manage.py runserver

1、Django通过检查确认正确地创建了项目
2、Django使用的版本以及当前使用的设置文件的名称

3、指出项目的URL

现在打开一款Web浏览器，输入你的URL:http://127.0.01:8000/，如果这不管用，请输入http://localhost:8000/。你将看到如下所示的页面，这个页面是Django创建的，让你知道到目前为止一切正常。现在暂时不要关闭这个服务器。若要关闭这个服务器，按Ctrl+C即可。

到目前为止一切正常

注意：如果出现错误消息：指定端口被占用，请执行命令python manage.py runserver 8001，让Django使用另外一个端口；如果这个端口也不可用，请不断执行上述命令，直到找到可用的端口。

2、创建应用程序

Django项目由一系列应用程序组成，它们协同工作，让项目成为一个整体。我们暂时只创建一个应用程序，它将完成项目的大部分工作。
当前，在前面打开的终端窗口中应该还运行着runserver。请再打开一个终端窗口，并切换到manage.py所在的目录。激活该虚拟环境：

learning_note>ll_env\Scripts\activate
(ll_env)learning_note>python manage.py startapp learning_notes
(ll_env)learning_note>dir
db.sqlite3  learning_note  learning_notes  ll_env  manage.py
(ll_env)learning_note>dir learning_notes
admin.py  __init__.py  migrations  models.py  tests.py  views.py  apps.py

• 定义模型

每位用户都需要在学习笔记中创建很多主题。用户输入的每个条目都与特定主题相关联，这些条目将以文本的方式显示。我们还需要存储每个条目的时间戳，以便能够告诉用户各个条目都是什么时候创建的。

打开文件models.py(我这里使用的是pycharm 5.0.3版本的)

models.py

模型告诉Django如何处理应用程序中存储的数据。在代码层面，模型就是一个类，包含属性和方法。下面表示用户将要存储的主题的模型：

class Topic(models.Model):
    """用户学习的主题"""
    text = models.CharField(max_length=200)
    date_added = models.DateTimeField(auto_now_add=True)
    
    def __str__(self):
        """返回模型的字符串表示"""
        return self.text

• 激活模型

要使用模型，必须让Django将应用程序包含到项目中。打开settings.py,你将看到一个片段，它告诉Django哪些应用程序安装在项目中：

settings.py

请将INSTALLED_APPS修改成下面这样，将前面的应用程序添加到这个元组中：

INSTALLED_APPS = (
        'django.contrib.staticfiles'
        #  我的应用程序
        'learning_notes',
)

让Django修改数据库，使其能够存储与模型Topic相关的信息。

(ll_env)learning_note>python manage.py makemigrations learning_notes

创建迁移文件

命令makemigrations让Django确定改如何修改数据库，使其能够存储与我们定义的新模型相关联的数据。输出表明Django创建了一个名为0001_initial.py的迁移文件，这个文件将在数据库中为模型Topic创建一个表。

• 应用迁移，让Django替我们修改数据库：
  (ll_env)learning_note> python manage.py migrate

修改数据库

每当修改“学习笔记”管理的数据时，都采用如下三个步骤：

1. 修改models.py
2. 对learning_notes调用makemigrations
3. 让Django迁移项目

• Django管理网站

为应用程序定义模型时，Django提供的管理网站让你能够轻松地处理模型。网站的管理员可使用管理网站，但普通用户不能使用。建议管理网站，并通过它使用模型Topic来添加一些主题。

1. 创建超级用户

(ll_env)learning_note> python manage.py createsuperuser

创建超级用户

2. 向管理网站注册模型

Django自动在管理网站中添加了一些模型，如User和Group，但对于我们创建的模型，必须手工进行注册。
我们创建应用程序learning_notes时，Django在models.py所在的目录中创建了一个名为admin.py的文件：

admin.py

• 为向管理网站注册Topic,请输入下面的代码：

from learning_notes.models import Topic
admin.site.register(Topic)

这些代码导入我们要注册的模型Topic,再使用admin.site.register()让Django通过管理网站管理我们的模型。

现在，使用超级用户账户访问管理网站：访问http://localhost:8000/admin/，并输入你刚创建的超级用户的用户名和密码，这个网页让你能够添加和修改用户和用户组，还可以管理与刚才定义的模型Topic相关的数据。

login in

包含模型Topic的管理网站

3.添加主题

单击Topics进入主题网页，它几乎是空的，这是因为我们没有添加任何主题。单击Add，你将看到一个用于添加新主题的表单。在第一个方框中输入Sichuan Cuisine ，再单击Save，将返回到主题管理页面。

• 定义模型Entry

要记录学到的四川菜系和广东菜系知识，需要为用户可在学习笔记中添加的条目定义模型。每个条目都与特定主题相关联，这种关系被称为多对一关系，即多个条目可关联到同一个主题。

models.py

from django.db import models
# Create your models here.
class Topic(models.Model):
    """用户学习的主题"""
    text = models.CharField(max_length=200)
    date_added = models.DateTimeField(auto_now_add=True)

class Entry(models.Model):
    """学到的有关某个主题的具体知识"""
    topic = models.ForeignKey(Topic)   #将每个条目关联到特定的主题
    text = models.TextField()
    date_added = models.DateTimeField(auto_now_add=True)
    
    #存储用于管理模型的额外信息，让Django在需要的时使用Entries来管理多个条目
    class Meta:
        verbose_name_plural = 'entries'
      
     #方法__str__()告诉Django，呈现条目时应该显示哪些信息
    def __str__(self):
        """返回模型的字符串表示"""
        return self.text[:50] + "..."

• 迁移模型Entry

因为我们添加了一个模型，因此需要再次迁移数据库，修改models.py，执行命令python manage.py makemigrations learning_notes，再执行命令python manage.py migrate。

(ll_env)learning_note> python manage.py makemigrations learning_notes
(ll_env)learning_note>python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, learning_notes, sessions
Running migrations:
  Applying learning_notes.0002_entry... OK

• 向管理网站注册Entry
  admin.py

from learning_notes.models import Topic,Entry
admin.site.register(Topic)
admin.site.register(Entry)

返回到http://localhost:8000/admin/，你将看到learning_notes下列出了Entries。单击Entries的Add链接，选择我们之前创建过的主题并添加相应的条目。

• Django shell

输入一些数据后，就可以通过交互式终端会话以编程方式查看这些数据了。这种交互式环境称为Django shell，是测试项目和排除其故障的理想之地。

(ll_env)learning_note> python manage.py shell
>>> from learning_notes.models import Topic
>>> Topic.objects.all()
<QuerySet [<Topic: Topic object>, <Topic: Topic object>]>
>>>

3、创建网页：学习笔记主页

使用Django创建网页的过程通常分为三个阶段：定义URL、编写视图和编写模板。
每个URL都被映射到特定的视图——视图函数获取并处理网页所需的数据。视图函数通常调用一个模板，后者生成浏览器能够理解的网页。

• 映射URL

用户通过在浏览器中输入URL以及单击链接来请求网页，因此我们需要确定项目需要哪些URL。主页的URL最重要，它是用户用来访问项目的基础URL.当前，基础URL（http://localhost:8000/）返回默认Django网站 ，让我们知道正确地建立了项目。

urls.py

from django.conf.urls import url
from django.contrib import admin

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

该模块定义了可在管理网站中请求的所有的URL。
我们需要包含learning_notes的URL：

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

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

默认的urls.py包含在文件夹learning_note中，现在我们需要在文件夹learning_notes中创建另一个urls.py文件：

urls.py

"""定义learning_notes的URL模式"""

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

urlpatterns = [
    #主页
    url(r'^$',views.index,name='index'),
]

- 此为基础URL，url()的第二个实参指定了要调用的视图函数。请求的url与前述正则表达式匹配时，Django将调用views.index，第三个实参将这个URL的名称指定为index,让我们能够在代码的其他地方引用它。

• 编写视图

视图函数接受请求中的信息，准备好生成网页所需的数据，再将这些数据发送给浏览器。

views.py

from django.shortcuts import render
# Create your views here.

函数render()根据视图提供的数据渲染响应，

from django.shortcuts import render

# Create your views here.
def index(request):
    """学习笔记的主页"""
    return render(request,'learning_notes/index.html')

• 编写模板

模板定义了网页的结构。模板指定了网页是什么样子的，而每当网页被请求时，Django将填入相关的数据。模板让你能够访问视图提供的任何数据。
在文件夹learning_notes中新建一个文件夹，并将其命名为templates。在文件夹templates中，再新建一个文件夹，并将其命名为learning_notes。再最里面的文件夹learning_notes中，新建一个文件，并将其命名为

index.html:

<p>Learning Log</p>
    
<p>Learning Log helps you keep track of your learning, for any 
    topic you're learning about.</p>

此时请求默认URL，将出现如下结果：

学习笔记的主页

4、 创建其他网页

• 模板继承
  1.父模板
  base.html

<p>
    <a href="{% url 'learning_notes:index' %}">Learnning Log</a>
</p>

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

2.子模块
index.html

{% extends "learning_notes/base.html" %}

{% block content %}
  <p>Learning Log</p>
  <p>Learning Log helps you keep track of your learning, for any topic you're learning about.</p>
{% endblock content %}

• 显示所有主题的页面

1.URL模式

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


urlpatterns = [
    #主页
    url(r'^$',views.index, name='index'),
    #显示所有的主题
    url(r'^topics/$',views.topics,name='topics'),
]

2.视图
views.py

from django.shortcuts import render
from .models import Topic

# Create your views here.
def index(request):
    """学习笔记的主页"""
    return render(request,'learning_notes/index.html')

def topics(request):
    #显示所有的主题
    topics = Topic.objects.order_by('date_added')
    context = {'topics':topics}
    return render(request,'learning_notes/topics.html',context)

base.html

<p>
  <a href="{% url 'learning_notes:index' %}">Learnning Log</a> -
  <a href="{% url 'learning_notes:topics' %}">Topics</a>
</p>

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

• 显示特定主题的页面
  1.URL模式

urls.py

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

urlpatterns = [
    #主页
    url(r'^$',views.index, name='index'),
    #显示所有的主题
    url(r'^topics/$',views.topics,name='topics'),
    #特定主题的详细页面
    url(r'^topics/(?P<topic_id>\d+)/$',views.topics,name='topics'),
]

2.视图
views.py

from django.shortcuts import render
from .models import Topic

# Create your views here.
def index(request):
    """学习笔记的主页"""
    return render(request,'learning_notes/index.html')

def topics(request):
    #显示所有的主题
    topics = Topic.objects.order_by('date_added')
    context = {'topics':topics}
    return render(request,'learning_notes/topics.html',context)

def topic(request,topic_id):
    #显示单个主题及其所有的条目
    topic = Topic.objects.get(id=topic_id)
    entries = topic.entry_set.order_by('-date_added')
    context = {'topic':topic,'entries':entries}
    return render(request,'learning_notes/topic.html',context)

3.模板
topic.html