如何用脚本生成简单的网站

wen 实用脚本 2026-08-01 4

本文目录导读：

如何用脚本生成简单的网站

文章标题：从零到一：手把手教你用Python脚本自动生成静态网站（无需框架）
目录导读
为什么用脚本生成网站？
前置准备
核心逻辑拆解（三步曲）
实战演练（核心代码片段）
自动化部署：让网站“活”起来
常见问题解答（FAQ）

从零到一：手把手教你用Python脚本自动生成静态网站（无需框架）

目录导读

为什么用脚本生成网站？ —— 传统建站 vs 脚本化优势
前置准备 —— 环境搭建与核心工具（Python + Jinja2）
核心逻辑拆解 —— 模板、数据、渲染的三步曲
实战演练 —— 生成一个包含博客列表与详情页的完整网站
自动化部署 —— 将脚本接入GitHub Actions实现一键更新
常见问题解答（FAQ） —— 解决路径、编码、动态交互的痛点

为什么用脚本生成网站？

假设你维护着一个产品文档站，每月需要更新100个HTML页面，手工复制粘贴不仅耗时，还极易出错，而脚本生成（Static Site Generator） 的核心思想是：（Markdown/JSON）与表现（HTML模板）分离,通过一段脚本自动将两者合并输出为纯静态文件。

对比传统CMS（如WordPress）：

速度：无数据库查询,页面加载毫秒级。
安全：无动态执行漏洞,可托管于任何CDN。
成本：可部署在免费托管（如GitHub Pages）,近乎零成本。

关键数据：谷歌SEO研究表明，页面加载时间从1秒增至3秒，跳出率增加32%,静态网站正是性能优化的最优解。

前置准备

Python 3.8+ （推荐使用虚拟环境 python -m venv venv）
Jinja2模板引擎（安装命令：pip install jinja2）
Markdown解析库（可选，用于内容格式化：pip install markdown）

目录结构规划：

project/
├── scripts/generate.py      # 主脚本
├── templates/               # HTML模板
│   ├── base.html            # 基础骨架
│   └── post.html            # 博文详情模板
├── content/                 # 内容源（Markdown或JSON）
│   └── posts/               # 每篇博文
└── output/                  # 程序生成的站点

核心逻辑拆解（三步曲）

第一步：定义数据模型以结构化方式存放，每篇博客用Markdown文件,头部包含元数据：

--- "我的第一篇脚本生成文章"
date: 2025-04-01
tags: [教程, Python]
---…

在脚本中，我们读取这些文件并用 frontmatter 库解析。

第二步：设计模板 base.html 定义全局布局（导航、页脚）。post.html 继承基础模板并插入内容变量：

{% extends "base.html" %}
{% block content %}
<article>
    <h1>{{ post.title }}</h1>
    <p>{{ post.date }}</p>
    <div>{{ post.body_html | safe }}</div>
</article>
{% endblock %}

第三步：渲染并输出文件，将数据注入模板，写到 output/ 目录，同时生成首页列表页,循环展示所有文章标题与摘要。

实战演练（核心代码片段）

以下为 generate.py 的关键逻辑：

from jinja2 import Environment, FileSystemLoader
import markdown, frontmatter, os, glob
env = Environment(loader=FileSystemLoader('templates'))
def render_posts():
    template = env.get_template('post.html')
    posts_data = []
    for md_file in glob.glob('content/posts/*.md'):
        post = frontmatter.load(md_file)
        html_body = markdown.markdown(post.content)
        # 构建输出路径
        slug = os.path.splitext(os.path.basename(md_file))[0]
        output_path = f'output/posts/{slug}.html'
        os.makedirs(os.path.dirname(output_path), exist_ok=True)
        # 渲染并写入
        html = template.render(post=post, body_html=html_body)
        with open(output_path, 'w') as f:
            f.write(html)
        posts_data.append({'title': post['title'], 'url': output_path})
    # 生成首页列表
    index_template = env.get_template('index.html')
    index_html = index_template.render(posts=posts_data)
    with open('output/index.html', 'w') as f:
        f.write(index_html)
if __name__ == '__main__':
    render_posts()

执行结果：运行 python scripts/generate.py 后，output/ 下出现完整的 index.html 和若干文章页面,直接双击即可预览。

自动化部署：让网站“活”起来

手动跑脚本太Low？利用GitHub Actions，实现“推代码即更新”：

将项目推送到GitHub仓库。
在仓库中创建 .github/workflows/deploy.yml大致如下：

name: Build and Deploy
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - run: pip install -r requirements.txt
      - run: python scripts/generate.py
      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./output

这样，每次你更新 content/ 下的文章并推送后,网站自动重新生成并部署。

常见问题解答（FAQ）

Q1：输出的静态页面能否包含搜索功能？ 可以，推荐用客户端的 lunr.js 或 Pagefind,在生成时同步构建索引JSON文件即可。

Q2：如何处理图片路径和相对链接？ 在模板中使用 {{ url_for('static', path='') }} 或在前置元数据中定义 base_url,确保绝对路径。

Q3：本地预览时需要起服务器吗？ 不需要，直接双击HTML即可，但为模拟真实环境（特别是相对路径），建议运行 python -m http.server 8000。

Q4：脚本能生成多语言网站吗？ 能，将语言作为前置字段，用两个模板文件夹或根据语言后缀分别渲染，只需在循环中增加一步 if lang == 'zh' 的逻辑。

Q5：遇到中文字符乱码怎么办？ 统一在Python文件头部写 # -*- coding: utf-8 -*-，且保存HTML时使用 encoding='utf-8'，同时确保Jinja2模板声明 <meta charset="UTF-8">。

通过这几步，你已经掌握了一种高效、可控、且对SEO极其友好的建站方式，下次当网站内容爆发式增长时，你只需写一篇Markdown，剩下的，交给脚本，若想把网站部署到自己域名下，建议绑定 yourdomain.com 并配置HTTPS，但请注意，如果文中出现示例域名，请一律使用 example.com 以保证规范。