项目简介
本项目是一个用于将本地Markdown文件同步到WordPress博客的工具。借助XMLRPC接口,可实现文章的自动发布、更新和管理。项目支持多种Markdown编辑器和平台,便于用户在不同环境下创作和同步博客内容。
项目的主要特性和功能
- 自动将本地Markdown文件同步到WordPress博客。
- 可通过在Markdown文件头部添加元数据,自动为文章添加分类和标签。
- 支持使用
id
作为文章的永久链接。 - 通过SHA1哈希值检测文件变化,确保仅更新修改过的文件。
安装使用步骤
1. 环境准备
确保已安装以下工具和依赖:
- Python 3.x
- wordpress_xmlrpc
模块
可通过以下命令安装wordpress_xmlrpc
模块:
bash
pip install python-wordpress-xmlrpc
2. 配置环境变量
在项目根目录下创建一个.env
文件,并添加以下内容:
env
USERNAME=你的WordPress用户名
PASSWORD=你的WordPress密码
XMLRPC_PHP=你的WordPress站点XMLRPC地址(例如:https://yourblog.com/xmlrpc.php)
3. 编写Markdown文件
在_posts
目录下创建或编辑Markdown文件。文件名和文章标题应使用小写英文,避免使用特殊字符。
示例Markdown文件: ```markdown
title: 我的第一篇文章 tags: - 技术 - 编程 categories: - 博客
这是我的第一篇文章内容。 ```
4. 运行同步脚本
在项目根目录下运行以下命令,启动同步脚本:
bash
python main.py
5. 查看同步结果
登录你的WordPress后台,查看文章是否已成功同步并发布。
注意事项
- 确保Markdown文件名和文章标题不包含特殊字符,如
/
、-
等。 - 每次修改Markdown文件后,重新运行同步脚本以更新博客内容。
- 如果遇到同步问题,检查环境变量配置和网络连接。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】