{% extends "base_generic.html" %}
{% block content %}
  <h1>Book List</h1>
  {% if book_list %}
      {% for book in book_list %}
          <a href="{{ book.get_absolute_url }}">{{ book.title }}</a> ({{book.author}})
      {% endfor %}
  {% else %}
    <p>There are no books in the library.</p>
  {% endif %}
{% endblock %}
视图默认将上下文（书本列表）作为 object_list 和 book_list 的别名传递；任何一个都会奏效。
我们使用 if, else 和 endif模板标签，来检查 book_list是否已定义且不为空。如果 book_list为空，则 else子句显示文本，说明没有要列出的书本。如果 book_list不为空，那么我们遍历书本列表。
django
{% if book_list %}
  <!-- code here to list the books -->
{% else %}
  <p>There are no books in the library.</p>
{% endif %}
上述条件仅检查一种情况，但你可以使用 elif 模板标记（例如{% elif var2 %} ）测试其他条件。有关条件运算符的更多信息，请参阅：if， ifequal/ifnotequal，以及内置模板标记和过滤器（Django Docs）中的 ifchanged 。
For 循环/回圈
模板使用for 和 endfor模板标签，以循环遍历书本列表，如下所示。每次迭代都会使用当前列表项的信息，填充书本模板变量book。
django
{% for book in book_list %}
  <li><!-- code here get information from each book item --></li>
{% endfor %}
虽然这里没有使用，但在循环中，Django 还会创建其他可用于跟踪迭代的变量。例如，你可以测试forloop.last 变量，以运行最后一次循环当中的条件处理代码。
循环内的代码，为每本书创建一个列表项，显示作者和标题（作为尚未创建的详细视图的链接）。
html
<a href="{{ book.get_absolute_url }}">{{ book.title }}</a> ({{book.author}})
我们使用“点符号”（例如 book.title 和 book.author）访问相关书本记录的字段，其中书本项目book后面的文本是字段名称（如同在模型中定义的）。
我们还可以在模板中，调用模型中的函数 - 在这里，我们调用Book.get_absolute_url()，来获取可用于显示关联详细记录的 URL。这项工作提供的函数没有任何参数（没有办法传递参数！）
在模板中调用函数时，我们必须要小心“副作用”。在这里我们只需要显示一个 URL，但是一个函数几乎可以做任何事情 - 我们不想仅仅通过渲染模板，而删除了我们的数据库（例如）！

更新基本模板
打开基本模板（/locallibrary/catalog/templates/base_generic.html）并将 {% url 'books' %} 插入所有书本 All books 的 URL 链接，如下所示。这将启用所有页面中的链接（由于我们已经创建了“books”的 url 映射器，我们可以成功地将其设置到位）。
python
<li><a href="{% url 'index' %}">Home</a></li>
<li><a href="{% url 'books' %}">All books</a></li>
<li><a href="">All authors</a></li>

urlpatterns = [
    path('', views.index, name='index'),
    path('books/', views.BookListView.as_view(), name='books'),
    path('book/<int:pk>', views.BookDetailView.as_view(), name='book-detail'),
对于书本详细信息路径，URL 模式使用特殊语法，来捕获我们想要查看的书本的特定 id。语法非常简单：尖括号定义要捕获的 URL 部分，包含视图可用于访问捕获数据的变量的名称。例如，<something> 将捕获标记的模式，并将值作为变量“something” ，传递给视图。你可以选择在变量名称前，加上一个定义数据类型的转换器规范（int，str，slug，uuid，path）。
在这里，我们使用 '<int:pk>' 来捕获 book id，它必须是一个整数，并将其作为名为 pk 的参数（主键的缩写）传递给视图。
如前所述，我们匹配的 URL 实际上是 catalog/book/<digits>（因为我们在应用程序 catalog 中，假定使用/catalog/）。

基于类的通用详细信息视图，需要传递一个名为 pk 的参数。如果你正在编写自己的函数视图，则可以使用你喜欢的任何参数名称，或者，确实也可以，在未命名的参数中传递信息。

高级路径匹配/正则表达式入门
完成教程并不需要此部分说明！我们提供它，是因为了解此可选的部分，未来可能对你使用 Django 有帮助。

path()提供的模式匹配非常简单，对于你只想捕获任何字符串或整数的（非常常见的）情况非常有用。如果需要更精细的过滤（例如，仅过滤具有一定数量字符的字符串），则可以使用 re_path() 方法。
path()的使用一样，除了它允许你使用正则表达式，以指定模式。例如，上面的路径可以编写为如下所示：
python
re_path(r'^book/(?P<pk>\d+)$', views.BookDetailView.as_view(), name='book-detail'),
正则表达式是一种非常强大的模式映射工具。坦率地说，对于初学者来说，他们是非常不直观和可怕的。下面是一个非常短的入门！
首先要知道的是，正则表达式通常应该使用原始字符串文字语法声明（即它们如图所示：r'<你的正则表达式文本放在这里>'）。
声明模式匹配需要知道的语法，主要部分是：
          这是我们的 url 映射器中使用的
          RE。它匹配一个字符串，该字符串在行（^book/）的开头具有book/，然后有一个或多个数字（\d+），然后结束（在行标记结束之前，没有非数字字符）。
          它还捕获所有数字（?P<pk>\d+），并将它们传递给名为
          'pk' 的参数中的视图。捕获的值始终作为字符串传递！
          例如，这将匹配 book/1234，并向视图发送变量
          pk='1234'。
          这匹配一个字符串，该字符串在行（^book/）的开头具有book/，然后有一个或多个字符，可以是
          ' - '
          或单词字符（([-\w]+），然后结束。它还捕获这组字符，并将它们传递给名为“stub”的参数中的视图。
          这是“stub”的一种相当典型的模式。存根 stub 是用于数据的、URL
          友好的、基于单词的主键。如果你希望本书网址提供更多信息，则可以使用
          stub。例如
          /catalog/book/the-secret-garden
          ，而不是/catalog/book/33。
在 URL 地图中传递其他选项
我们在这里没有使用、但你可能觉得有价值的一个功能是，你可以向视图声明并传递其他选项。这些选项被声明为一个字典，你将其作为第三个未命名参数，传递给 path()函数。
如果要对多个资源，使用相同的视图，并在每种情况下，传递数据以配置其行为，则此方法非常有用（下面我们在每种情况下提供不同的模板）。
python
path('url/', views.my_reused_view, {'my_template_name': 'some_path'}, name='aurl'),
path('anotherurl/', views.my_reused_view, {'my_template_name': 'another_path'}, name='anotherurl'),
额外选项和命名捕获的模式，二者都作为命名参数传递给视图。如果对捕获的模式和额外选项使用相同的名称，则仅将捕获的模式值发送到视图（将删除附加选项中指定的值）。

{% extends "base_generic.html" %}
{% block content %}
  <h1>Title: {{ book.title }}</h1>
  <p><strong>Author:</strong> <a href="">{{ book.author }}</a></p> <!-- author detail link not yet defined -->
  <p><strong>Summary:</strong> {{ book.summary }}</p>
  <p><strong>ISBN:</strong> {{ book.isbn }}</p>
  <p><strong>Language:</strong> {{ book.language }}</p>
  <p><strong>Genre:</strong> {% for genre in book.genre.all %} {{ genre }}{% if not forloop.last %}, {% endif %}{% endfor %}</p>
  <div style="margin-left:20px;margin-top:20px">
    <h4>Copies</h4>
    {% for copy in book.bookinstance_set.all %}
    <p class="{% if copy.status == 'a' %}text-success{% elif copy.status == 'm' %}text-danger{% else %}text-warning{% endif %}">{{ copy.get_status_display }}</p>
    {% if copy.status != 'a' %}<p><strong>Due to be returned:</strong> {{copy.due_back}}</p>{% endif %}
    <p><strong>Imprint:</strong> {{copy.imprint}}</p>
    <p class="text-muted"><strong>Id:</strong> {{copy.id}}</p>
    {% endfor %}
{% endblock %}
上面模板中的作者链接，有一个空 URL，因为我们尚未创建作者详细信息页面。一旦创建了，你应该像这样更新 URL：

python
<a href="{% url 'author-detail' book.author.pk %}">{{ book.author }}</a>
虽然有点大，但此模板中的几乎所有内容，都已在前面描述过：
我们扩展基本模板，并覆盖“内容”区块 content。
我们使用条件处理，来确定是否显示特定内容。
我们使用 for 循环遍历对象列表。
我们使用 "点表示法" 访问上下文字段（因为我们使用了详细的通用视图，上下文被命名为book；我们也可以使用“object”）。
我们以前没见过的一件有趣的事情是函数book.bookinstance_set.all()。此方法由 Django“自动”构造，以便返回与特定 Book 相关联的 BookInstance记录集合。
python
{% for copy in book.bookinstance_set.all %}
<!-- code to iterate across each copy/instance of a book -->
{% endfor %}
需要此方法，是因为你仅在关系的“一”侧声明 ForeignKey（一对多）字段。由于你没有做任何事情，来声明其他（“多”）模型中的关系，因此它没有任何字段，来获取相关记录集。为了解决这个问题，Django 构造了一个适当命名的“反向查找”函数，你可以使用它。函数的名称，是通过对声明 ForeignKey 的模型名称，转化为小写来构造的，然后是_set（即，在 Book中创建的函数是 bookinstance_set()）。
这里我们使用all()来获取所有记录（默认值）。虽然你可以使用filter()方法获取代码中的记录子集，但你无法直接在模板中执行此操作，因为你无法指定函数的参数。

还要注意，如果你没有定义顺序（在基于类的视图或模型上），你还会看到开发服务器中的错误，如下所示：
[29/May/2017 18:37:53] "GET /catalog/books/?page=1 HTTP/1.1" 200 1637
/foo/local_library/venv/lib/python3.5/site-packages/django/views/generic/list.py:99: UnorderedObjectListWarning: Pagination may yield inconsistent results with an unordered object_list: <QuerySet [<Author: Ortiz, David>, <Author: H. McRaven, William>, <Author: Leigh, Melinda>]>
  allow_empty_first_page=allow_empty_first_page, **kwargs)
发生这种情况，是因为 paginator object 对象希望在下划线数据库上看到一些 ORDER BY。没有它，它无法确定，返回的注册表实际上是否为正确顺序！
本教程还没有说明到 Pagination（还没，但很快），但由于你不能使用sort_by() 并传递一个参数（与上面描述的filter() 相同），你将不得不在下面三个选择当中，进行挑选：
在模型的class Meta声明中，添加排序ordering。
Add a queryset attribute in your custom class-based view, specifying a order_by().在自定义基于类的视图中添加 queryset 属性，指定 order_by（）。
Adding a get_queryset method to your custom class-based view and also specify the order_by().将 get_queryset 方法添加到基于类的自定义视图中，并指定 order_by（）。
如果你决定使用class Meta 作为作者模型Author（可能不像定制基于类的视图那样灵活，但很容易），你最终会得到这样的结果：
python
class Author(models.Model):
    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
    date_of_birth = models.DateField(null=True, blank=True)
    date_of_death = models.DateField('Died', null=True, blank=True)
    def get_absolute_url(self):
        return reverse('author-detail', args=[str(self.id)])
    def __str__(self):
        return '%s, %s' % (self.last_name, self.first_name)
    class Meta:
        ordering = ['last_name']
当然，该字段不需要是last_name：它可以是任何其他字段。
最后，但并非最不重要的是，你应该按照实际上在数据库上具有索引（唯一或非唯一）的属性/栏位进行排序，以避免性能问题。当然，如果这么少量的书本（和用户！），这里就没有必要（我们可能会让自己提前做太多事情），但是对于未来的项目来说，这是需要考虑的事情。

class BookListView(generic.ListView):
    model = Book
    paginate_by = 10
通过添加这行，只要你有超过 10 条记录，视图就会开始对它发送到模板的数据，进行分页。使用 GET 参数访问不同的页面 - 要访问第 2 页，你将使用 URL：/catalog/books/?page=2。

{% block content %}{% endblock %}
{% block pagination %}
  {% if is_paginated %}
      <div class="pagination">
          <span class="page-links">
              {% if page_obj.has_previous %}
                  <a href="{{ request.path }}?page={{ page_obj.previous_page_number }}">previous</a>
              {% endif %}
              <span class="page-current">
                  Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}.
              </span>
              {% if page_obj.has_next %}
                  <a href="{{ request.path }}?page={{ page_obj.next_page_number }}">next</a>
              {% endif %}
          </span>
  {% endif %}
{% endblock %}
page_obj 是一个 Paginator 对象，如果在当前页面上使用分页，它将存在。它允许你获取有关当前页面，之前页面，有多少页面等的所有信息。
我们使用 {{ request.path }}，来获取用于创建分页链接的当前页面 URL。这很有用，因为它独立于我们正在分页的对象。
就是这样！

<p>
  <strong>Author:</strong>
  <a href="{% url 'author-detail' book.author.pk %}">{{ book.author }}</a>