Python 30 天实战:个人博客网站开发(基础部分)

经过前面一系列对 Flask、数据库操作以及表单处理等知识的学习,今天我们将把这些知识综合运用起来,开发一个简单的个人博客网站的后端部分,并搭配基础的 HTML、CSS 进行页面布局和样式设计,打造出具备基本外观与功能的博客网站雏形。

一、项目准备

  1. 技术选型与环境搭建:后端框架选用 Flask,它能方便地处理路由、请求和响应等 Web 相关操作。数据库方面继续使用 SQLAlchemy 来连接和操作数据库,这里以 SQLite 数据库为例进行演示(方便本地开发和测试)。前端页面使用 HTML 构建页面结构,CSS 进行样式设计,实现简单的页面布局和美化。
  2. 数据库设计与模型定义(使用 SQLAlchemy)
    首先创建一个表示文章的数据库表模型,代码如下:
from flask import Flask
from sqlalchemy import create_engine, Column, Integer, String, Text
from sqlalchemy.orm import sessionmaker, declarative_base

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = "sqlite:///blog_database.db"
engine = create_engine(app.config['SQLALCHEMY_DATABASE_URI'])
Session = sessionmaker(bind=engine)
db_session = Session()

Base = declarative_base()

class Article(Base):
    __tablename__ = 'articles'
    id = Column(Integer, primary_key=True)
    title = Column(String(100), nullable=False)
    content = Column(Text, nullable=False)

Base.metadata.create_all(engine)


在上述代码中,定义了 Article 类继承自 declarative_base() 创建的基类,该类对应数据库中的 articles 表,包含 id(文章唯一标识,整数类型主键)、title(文章标题,字符串类型且不能为空)、content(文章内容,使用 Text 类型来存储较长的文本,也不能为空)这几个字段。通过 Base.metadata.create_all(engine) 语句让 SQLAlchemy 根据这个模型创建对应的数据库表结构。

二、文章列表展示功能


  1. 后端路由与数据查询逻辑
    在 Flask 应用中定义路由来获取并展示文章列表,代码如下:
from flask import render_template

@app.route('/')
@app.route('/articles')
def article_list():
    articles = db_session.query(Article).all()
    return render_template('article_list.html', articles=articles)


在上述代码中,定义了两个路由(根路由 '/' 和 /articles 路由)都指向 article_list 函数,该函数通过 db_session.query(Article).all() 查询出数据库中所有的文章记录,以列表形式返回,然后将这个包含文章对象的列表传递给 article_list.html 模板进行渲染展示。


  1. HTML 模板设计(article_list.html)




    
    个人博客 - 文章列表
    



    

我的博客文章列表


在这个模板中,首先设置了页面标题等基本信息,并且引入了外部的 CSS 文件(styles.css,后续会介绍样式设计)。然后通过 Jinja2 模板引擎的循环语法 {% for article in articles %} 遍历从后端传递过来的文章列表,为每篇文章生成一个列表项

  • ,列表项中包含文章标题的链接,链接指向文章详情页面(通过 url_for 函数生成对应的 URL,传递文章的 id 参数给文章详情页面路由)。

    三、文章详情页面功能


    1. 后端路由与根据文章 ID 查询逻辑
    @app.route('/article/')
    def article_detail(article_id):
        article = db_session.query(Article).filter_by(id=article_id).first()
        if article:
            return render_template('article_detail.html', article=article)
        return '

    文章不存在

    '


    在上述代码中,定义了 /article/ 路由,用于接收文章的 id 参数,通过 db_session.query(Article).filter_by(id=article_id).first() 从数据库中查询对应 id 的文章记录,如果找到文章则将其传递给 article_detail.html 模板进行渲染展示,若文章不存在则返回相应的提示信息。


    1. HTML 模板设计(article_detail.html)
    
    
    
    
        
        个人博客 - 文章详情
        
    
    
    
        

    {{ article.title }}

    {{ article.content }}


    在这个模板中,展示了文章的标题和内容,标题通过 {{ article.title }} 获取传递过来的文章对象的标题属性进行展示,文章内容则放在一个具有特定类名(article-content,方便 CSS 样式设置)的

    元素中进行展示。

    四、文章发布功能


    1. 表单类定义(使用 Flask-WTF)
    from flask_wtf import FlaskForm
    from wtforms import StringField, TextAreaField, SubmitField
    from wtforms.validators import DataRequired
    
    class ArticleForm(FlaskForm):
        title = StringField('文章标题', validators=[DataRequired(message='标题不能为空')])
        content = TextAreaField('文章内容', validators=[DataRequired(message='内容不能为空')])
        submit = SubmitField('发布文章')
    


    在上述表单类中,定义了文章标题字段(title)、文章内容字段(content),都添加了不能为空的验证规则,还有一个提交按钮字段(submit)用于触发表单提交操作。


    1. 后端路由与表单处理及数据保存逻辑
    from flask import render_template, redirect, url_for
    from flask_wtf import FlaskForm
    
    @app.route('/create_article', methods=['GET', 'POST'])
    def create_article():
        form = ArticleForm()
        if form.validate_on_submit():
            title = form.title.data
            content = form.content.data
            new_article = Article(title=title, content=content)
            db_session.add(new_article)
            db_session.commit()
            return redirect(url_for('article_list'))
        return render_template('create_article.html', form=form)
    


    在上述代码中,定义了 /create_article 路由来处理文章发布相关操作,支持 GET(用于显示文章发布页面)和 POST(用于处理表单提交)两种请求方法。在函数中先创建 ArticleForm 的实例 form,如果表单提交且通过验证,就获取表单中的标题和内容数据,创建一个新的 Article 对象并添加到数据库会话中,提交事务将新文章保存到数据库,最后重定向到文章列表页面。若表单未提交或验证不通过,则渲染 create_article.html 模板展示文章发布页面以及可能的错误提示信息。


    1. HTML 模板设计(create_article.html)
    
    
    
    
        
        个人博客 - 发布文章
        
    
    
    
        

    发布新文章

    {{ form.csrf_token }}

    {{ form.title.label }} {{ form.title }}

    {{ form.content.label }} {{ form.content }}

    {{ form.submit }}


    在这个模板中,创建了一个

    表单元素,设置表单提交方法为 POST,并且渲染了表单类中的各个字段(包括 csrf_token 用于防止跨站请求伪造攻击),用户可以在相应的输入框中输入文章标题和内容,点击提交按钮触发表单提交操作。

    五、简单的 CSS 样式设计(styles.css,示例部分样式)

    body {
        font-family: Arial, sans-serif;
        margin: 0;
        padding: 0;
        background-color: #f4f4f4;
    }
    
    h1 {
        text-align: center;
        color: #333;
    }
    
    ul {
        list-style-type: none;
        padding: 0;
    }
    
    li {
        margin-bottom: 10px;
    }
    
    a {
        text-decoration: none;
        color: #0066cc;
    }
    
    .article-content {
        margin: 20px;
        padding: 10px;
        background-color: #fff;
        border: 1px solid #ccc;
    }
    


    上述 CSS 代码对页面的整体字体、背景颜色、标题样式、列表样式、链接样式以及文章内容展示区域的样式等进行了简单设置,让页面看起来更加整洁、美观。


    通过今天这个综合练习,我们搭建起了一个简单个人博客网站的后端基础部分,实现了文章列表展示、文章详情查看以及文章发布等核心功能,并通过简单的 HTML、CSS 设计让网站具备了基本的外观。后续可以继续在此基础上完善功能,比如添加用户认证、评论功能等,以及进一步优化页面的样式设计。


    #个人博客开发# #Flask 综合应用# #数据库与 Web 应用# #HTML CSS 基础# #Web 功能构建# #Python 项目实战#

  • 相关文章

    Python新手的福音,涵盖20+种初学者必练项目!这本实战书太火了

    对学Python的新手同学来说,最最最想要的干货是什么?是大量可以练手的项目啊。俗话说,三天不练手生,三天不念口生。#技术派的书架#在知乎上有一个关于"Python的练手项目”的问题,有6W人关注,...

    247个Python实战案例:从入门到进阶(含源码)

    Python是目前最热门的编程语言之一。由于其可读性和对初学者的友好性,已被广泛使用。那么要想学会并掌握Python,可以实战的练习项目是必不可少的。这247个实战案例让你告别枯燥,60秒学会一个小例...

    从零开始学习 Python!6《项目实战》教你玩转 Python 项目

    大家好啊!今天我们要聊一个超级有趣的话题——Python学习的实战项目!作为一个编程小白,你可能会觉得学完基础语法之后,完全不知道该怎么实战。别担心,老铁!这这篇文章就是为你量身定制的!为什么要做 P...

    Python 30 天实战:数据分析实战全流程

    在前面的学习中,我们已经分别掌握了 NumPy、Pandas 和 Matplotlib 这三个强大库的基础及部分进阶知识,今天我们将迎来一个综合性的实战练习,通过对真实世界数据集的处理、分析与可视化,...

    Python+微信小程序开发实战(超清完结)

    获课:97java.xyz/5101/标题:Python+微信小程序开发实战:从入门到精通引言随着移动互联网的快速发展,微信小程序因其便捷性和广泛的用户基础,成为开发者们关注的焦点。Python作为一...

    实战:用python写个小游戏!(详细解释,建议收藏)

    前言:今天为大家带来的内容是实战:用python写个小游戏!(详细解释,建议收藏)本文具有不错的参考意义及学习意义,希望大家会喜欢!要是觉得不错记得点赞,转发关注,不迷路哦!引言自从python语言大...