静态WordPress转换工具使用教程

静态WordPress转换工具使用教程

static-wordpress Python Library for Static WordPress (Autmated Crawling, Post-Processing and Hosting) 项目地址: https://gitcode.com/gh_mirrors/st/static-wordpress

1. 项目介绍

静态WordPress转换工具（static-wordpress）是一个Python包，用于将WordPress网站转换成静态网站。它可以自动化爬取、后处理并托管静态版本的WordPress网站。通过使用这个工具，你可以将动态的WordPress网站转换为更快速、更安全的静态网页，适合不需要经常更新内容的情况。

2. 项目快速启动

环境准备

• Python 3.8 或更高版本
• pip（Python 包管理器）

安装步骤

1. 克隆或下载项目到本地计算机。

git clone https://github.com/serpwings/static-wordpress.git
cd static-wordpress

2. 创建虚拟环境并安装依赖。

python -m venv venv
source venv/bin/activate  # 在Windows系统中使用 `venv\Scripts\activate`
pip install -e .

3. 运行静态WordPress转换工具。

staticwordpress

注意事项

• 请确保已经安装了所有必需的依赖项。
• 如果需要使用Windows安装程序，请从项目的发布部分下载最新的exe文件。

3. 应用案例和最佳实践

以下是一个简单的使用案例，展示如何将WordPress的ZIP文件转换为静态网站并部署到Netlify。

import logging
from staticwordpress.core.workflow import Workflow
from staticwordpress.core.constants import SOURCE, HOST

# 启用日志记录
logging.basicConfig(
    format="%(asctime)s - %(levelname)s - %(message)s",
    level=logging.DEBUG,
    stream=sys.stdout,
)

# 初始化工作流
swp = Workflow()
swp.create_project(
    project_name="simply-static-zip-deploy",
    wp_user="your_wordpress_username",
    wp_api_token="your_wordpress_api_token",
    src_url="source_url_of_wordpress",
    dst_url="destination_url_for_static_version",
    output_folder="output_folder_location",
    src_type=SOURCE.ZIP,
    host_type=HOST.NETLIFY,
)

# 执行转换过程
swp.download_zip_file()
swp.setup_zip_folders()
swp.add_404_page()
swp.add_robots_txt()
swp.add_redirects()
swp.add_search()

注意事项

• 替换示例代码中的变量值为实际使用的值。
• 根据需要调整工作流中的步骤。

4. 典型生态项目

• Simply Static：一个WordPress插件，用于生成静态HTML文件。
• Netlify：一个用于部署静态网站的托管平台。
• GitHub：用于托管开源项目的代码仓库。

通过结合这些生态项目，你可以构建一个完整的静态网站生成、部署和管理流程。

static-wordpress Python Library for Static WordPress (Autmated Crawling, Post-Processing and Hosting) 项目地址: https://gitcode.com/gh_mirrors/st/static-wordpress