Flask入门教程实例：搭建一个静态博客

下面是针对“Flask入门教程实例：搭建一个静态博客”的完整攻略。

1. 确保系统已经具备Python环境

在开始构建一个Flask应用程序之前，我们需要确保系统已经安装并配置好了Python环境。Python的版本推荐使用最新的稳定版本，如Python3.8或Python3.9。如果您还没有安装Python，可以在Python官网下载对应平台的安装包进行安装。

2. 安装Flask并创建虚拟环境

安装Flask是构建一个Flask应用的第一步，并且创建虚拟环境可以避免全局安装Flask带来的冲突和问题。具体步骤如下：

打开终端或命令行界面，并进入项目根目录
在终端或命令行中使用命令pip install virtualenv来安装虚拟环境工具
使用命令virtualenv venv来创建虚拟环境，并将虚拟环境目录命名为venv
在终端或命令行中使用命令source venv/bin/activate来进入虚拟环境

3. 编写Flask应用程序

在进入虚拟环境后，我们需要通过编写Flask应用程序来实现我们的目标。下面是一个简单的Flask应用程序示例：

# app.py
from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return 'Hello, Flask!'

该应用程序导入了Flask并创建了一个Flask实例，并在根目录/下定义了一个视图函数index。该视图函数返回一个简单的字符串“Hello, Flask!”。通过将该视图函数与根目录路径/关联起来，我们创建了一个简单的Web应用程序。

4. 运行Flask应用程序

在编写完Flask应用程序后，我们需要运行该应用程序来查看其效果。在终端或命令行中使用命令export FLASK_APP=app.py将刚才编写的Flask应用程序文件app.py保存的位置告诉Flask。然后使用命令flask run来运行该应用程序。这样我们就可以在浏览器中访问http://localhost:5000/，并看到“Hello, Flask!”这个字符串了。

5. 创建一个静态博客

在了解了Flask的基本用法后，我们可以开始自己写一个静态博客了。下面是实现静态博客的步骤：

5.1. 安装依赖库

首先需要安装一些依赖库，包括Flask、flask-markdown、Pygments（需要用到代码高亮功能）、Jinja2（渲染html）等等。运行以下命令行：

pip install Flask flask-markdown Pygments Jinja2

5.2. 创建博客文件与模板

在博客根目录下创建articles文件夹，用于存放Markdown格式的博客文章。每个博客文章需要在文件名前添加时间戳与slug，例如2022-09-25-hello-world.md。这里的时间戳可以使用Python中的datetime模块实现。

然后创建基本模板文件templates/base.html，并在此基础上衍生出templates/index.html和templates/article.html两个子模板。

5.3. 实现博客路由与视图函数

在Flask应用程序中添加路由和视图函数，用于显示“首页”和“文章详情页”。其中，“首页”需要获取articles文件夹中的所有Markdown文件，并解析成HTML格式的文本，并将结果渲染到模板中。而“文章详情页”需要获取特定的Markdown文件，解析成HTML文本，并将结果渲染到模板中。

使用以下代码片段实现上述路由：

# app.py
import os
from datetime import datetime
from flask import Flask, render_template
from flask.ext.markdown import Markdown
from pygments.formatters import html

app = Flask(__name__)
app.config['MARKDOWN_EXTENSION_CONFIGS'] = {
    'codehilite': {'linenums': False},
    'nl2br': {},
}
Markdown(app, extensions=['codehilite', 'nl2br'])

def get_articles():
    path = os.path.join(os.getcwd(), 'articles')
    articles = []
    for filename in os.listdir(path):
        if not filename.endswith('.md'):
            continue
        filepath = os.path.join(path, filename)
        with open(filepath, 'r', encoding='utf-8') as f:
            mtime = datetime.strptime(
                filename.split('-', 1)[0], '%Y-%m-%d')
            slug = f.readline().strip()[2:]
            title = f.readline().strip()[2:]
            content = f.read()
            articles.append((mtime, slug, title, content))
    articles.sort(reverse=True)
    return articles

@app.route('/')
def index():
    articles = get_articles()
    return render_template('index.html', articles=articles)

@app.route('/<slug>/')
def detail(slug):
    for mtime, s, title, content in get_articles():
        if s == slug:
            return render_template(
                'article.html', title=title,
                content=content, mtime=mtime)
    return 'article not found', 404