目錄

前文列表

實現所需要的檢視函式

• 在開始實現首頁模板之前, 我們為了除錯和顯示的方便, 首先偽造一些假資料:
  
  • fake_data.py

import random
import datetime
from uuid import uuid4

from models import db, User, Tag, Post

user = User(id=str(uuid4()), username='jmilkfan', password='fanguiju')
db.session.add(user)
db.session.commit()

user = db.session.query(User).first()
tag_one = Tag(id=str(uuid4()), name='Python'
 
)
tag_two = Tag(id=str(uuid4()), name='Flask')
tag_three = Tag(id=str(uuid4()), name='SQLALchemy')
tag_four = Tag(id=str(uuid4()), name='JMilkFan')
tag_list = [tag_one, tag_two, tag_three, tag_four]

s = "EXAMPLE TEXT"

for i in xrange(100):
    new_post = Post(id=str(uuid4()), title="Post" + str(i))
    new_post.user = user
    new_post.publish_date = datetime.datetime.now()
    new_post.text = s
    new_post.tags = random.sample(tag_list, random.randint(1
 
, 3))
    db.session.add(new_post)

db.session.commit()

直接在 manager shell 中匯入就能夠執行該指令碼檔案:

>>> import fake_data

home.html 的檢視函式之前博文中就已經記錄過了，現在再將必須的檢視函式程式碼貼出。

• views.py

from flask import render_template
from sqlalchemy import func

from main import app
from models import db, User, Post, Tag, Comment, posts_tags


def
 
 sidebar_data():
    """Set the sidebar function."""

    # Get post of recent
    recent = db.session.query(Post).order_by(
            Post.publish_date.desc()
        ).limit(5).all()

    # Get the tags and sort by count of posts.
    top_tags = db.session.query(
            Tag, func.count(posts_tags.c.post_id).label('total')
        ).join(
            posts_tags
        ).group_by(Tag).order_by('total DESC').limit(5).all()
    return recent, top_tags


@app.route('/')
@app.route('/<int:page>')
def home(page=1):
    """View function for home page"""

    posts = Post.query.order_by(
        Post.publish_date.desc()
    ).paginate(page, 10)

    recent, top_tags = sidebar_data()

    return render_template('home.html',
                           posts=posts,
                           recent=recent,
                           top_tags=top_tags)

@app.route('/post/<string:post_id>')
def post(post_id):
    """View function for post page"""

    post = Post.query.get_or_404(post_id)
    tags = post.tags
    comments = post.comments.order_by(Comment.date.desc()).all()
    recent, top_tags = sidebar_data()

    return render_template('post.html',
                           post=post,
                           tags=tags,
                           comments=comments,
                           recent=recent,
                           top_tags=top_tags)


@app.route('/tag/<string:tag_name>')
def tag(tag_name):
    """View function for tag page"""

    # Tag.qurey() 物件才有 first_or_404()，而 db.session.query(Model) 是沒有的
    tag = Tag.query.filter_by(name=tag_name).first_or_404()
    posts = tag.posts.order_by(Post.publish_date.desc()).all()
    recent, top_tags = sidebar_data()

    return render_template('tag.html',
                           tag=tag,
                           posts=posts,
                           recent=recent,
                           top_tags=top_tags)

實現 home.html 模板

• templates/home.html

<!-- Replace the TITLE of template base.html -->
{% extends "base.html"%}
{% block title %}JmilkFan's Blog{% endblock %}

<!-- Replace the BODY of template base.html -->
{% block body %}
<!-- The data object from view function: `home()` -->
<div class="row">
  <div class="col-lg-9">
    <!-- Get Pagination object-->
    {% for post in posts.items %}
    <div class="row">
      <div class="col-lg-12">
        <h1>{{ post.title }}</h1>
      </div>
    </div>
    <div class="row">
      <div class="col-lg-12">
        {{ post.text | truncate(255) | safe }}
        <!-- Set the link for read more -->
        <a href="{{
          url_for('post', post_id=post.id)
          }}">Read More</a>
      </div>
    </div>
    {% endfor %}
  </div>
  <div class="col-lg-3">
    <div class="row">
      <h5>Recent Posts</h5>
      <ul>
        {% for post in recent %}
        <!-- Set the link for recent posts. -->
        <li><a href="{{
          url_for('post', post_id=post.id)
          }}">{{ post.title }}</a></li>
        {% endfor %}
      </ul>
    </div>
    <div class="row">
      <h5>Popular Tags</h5>
      <ul>
        {% for tag in top_tags %}
        <li><a href="{{
          url_for('tag', tag_name=tag[0].name)
          }}">{{ tag[0].name }}</a></li>
        {% endfor %}
      </ul>
    </div>
  </div>
  <!-- Call the Macro: `render_pagination` from base.html -->
  {{ render_pagination(posts, 'home') }}
</div>
{% endblock %}

程式碼分析

需求：我們希望當訪問到域名 http://<ipaddress>:5000/，即訪問部落格的 / 時，能夠正文處顯示文章列表，右上側邊欄顯示最新的 5 篇博文，右下側邊攔顯示 關聯博文數最多的 5 個標籤，並且希望每一個頁面的右側邊欄都是一致的。

• 按照這個需求，首先我們需要定義一個路由函式(在這裡同時也是檢視函式) home() 來跳轉到首頁，並且首頁中具有分頁的功能，所以會定義兩個 app.oute() 裝飾器。

• 同時因為我們需要在右側邊欄顯示最新的 5 篇博文和博文關聯數最多的 5 個標籤，所以需要提供 recent/recent 資料物件，並且這些物件是高重用的，所以將其抽象成一個函式。

• 我們還希望能夠通過右側邊攔提供的連結跳轉到具體的 post 或 tag 中，這就需要得到 posts/tags 表中的資料物件，所以會使用到檢視函式 post()/tag() 。

實現效果

• 再結合在前面博文中實現的分頁連結巨集