从安装到使用：tumblr-utils完整操作指南

【免费下载链接】tumblr-utilsUtilities for dealing with Tumblr blogs, Tumblr backup项目地址: https://gitcode.com/gh_mirrors/tu/tumblr-utils

tumblr-utils是一款强大的Tumblr博客备份工具，能够帮助用户轻松创建Tumblr博客的本地备份，包括文章内容和媒体文件。本指南将从安装到使用，为您提供tumblr-utils的完整操作流程，让您的Tumblr数据安全有保障。

一、tumblr-utils简介

tumblr-utils是一个实用工具集合，主要包含三个核心工具：

• tumble.py：从RSS或Atom源创建新帖子
• tumblr_backup.py：创建帖子和图片的本地备份（核心功能）
• mail_export.py：将标记的链接通过邮件发送给收件人列表

其中，tumblr_backup.py是最常用的工具，它能够备份博客的所有内容，包括文本、图片、音频和视频，并生成美观的HTML5格式备份文件。备份内容可通过浏览器直接查看，结构清晰，便于管理。

二、准备工作：安装必要环境

2.1 安装Python

tumblr-utils基于Python 2.7开发，因此需要先安装Python 2.7环境：

1. 访问Python官方网站下载Python 2.7版本：Python 2.7下载页面
2. 选择适合您操作系统的安装包（Windows用户推荐"Windows x86 MSI installer"）
3. 双击安装文件，按照提示完成安装

2.2 获取tumblr-utils源码

通过以下命令克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/tu/tumblr-utils

克隆完成后，您将得到一个包含所有工具的tumblr-utils文件夹。

2.3 配置API密钥

使用tumblr_backup.py需要Tumblr API密钥：

1. 访问Tumblr OAuth应用页面
2. 注册一个新应用，获取OAuth Consumer Key
3. 打开tumblr_backup.py文件，找到大约105行的API_KEY =行，将您的API密钥复制到单引号之间

2.4 安装可选依赖（增强功能）

• 备份音视频：安装youtube-dl
• EXIF标签支持：安装pyexiv2

建议通过操作系统的包管理器安装这些依赖，如apt-get、yum或brew。

三、tumblr_backup.py使用指南

3.1 基本语法

tumblr_backup.py的基本使用语法如下：

tumblr_backup.py [options] blog-name ...

其中，blog-name是您要备份的Tumblr博客名称。如果您的博客使用自定义域名，请输入完整域名。

3.2 常用选项

3.3 快速开始：首次备份

要备份您的Tumblr博客，只需在命令行中运行：

tumblr_backup.py your-blog-name

其中your-blog-name是您的Tumblr博客名称（不包含.tumblr.com）。

程序将自动创建一个以博客名称命名的文件夹，所有备份内容将保存在该文件夹中。首次备份可能需要较长时间，具体取决于您的博客大小和网络速度。

3.4 增量备份

为了节省时间和带宽，您可以使用增量备份模式，只备份新发布的帖子：

tumblr_backup.py -i your-blog-name

建议将增量备份添加到定时任务中，例如每小时运行一次，以保持备份的最新状态。

3.5 高级用法示例

只备份图片帖子

tumblr_backup.py -T photo your-blog-name

备份特定标签的帖子

tumblr_backup.py -t travel,photography your-blog-name

保存视频和音频

tumblr_backup.py --save-video --save-audio your-blog-name

设置自定义输出目录

tumblr_backup.py -O /path/to/backup/folder your-blog-name

四、备份文件结构解析

tumblr_backup.py生成的备份文件结构清晰，便于浏览和管理：

<outdir>/ # 备份根目录（默认以博客名称命名） ├── index.html # 目录页，包含月度归档链接 ├── backup.css # 默认样式表 ├── archive/ # 月度归档页面 │ ├── <yyyy-mm-pnn>.html │ └── ... ├── posts/ # 单篇帖子页面 │ ├── <id>.html │ └── ... ├── media/ # 媒体文件（图片、音频、视频） │ ├── <image.ext> │ ├── <audio>.mp3 │ ├── <video>.mp4 │ └── ... ├── json/ # 原始JSON数据（如果使用-j选项） │ ├── <id>.json │ └── ... └── theme/ # 博客主题相关文件 ├── avatar.<ext> └── style.css

您可以通过浏览器打开index.html文件来浏览完整的备份内容。

五、自定义备份样式

tumblr_backup.py支持自定义备份页面的样式：

1. 自定义CSS：创建custom.css文件并放入备份文件夹，程序将自动应用您的样式
2. 样式覆盖：创建override.css文件来覆盖默认样式的特定部分
3. 主题样式：博客的原始样式表保存在theme/style.css中

六、常见问题解决

6.1 备份过程中断

如果备份过程意外中断，可以重新运行相同的命令继续备份。对于大型博客，建议使用增量备份模式（-i选项）来避免重复下载。

6.2 无法下载某些媒体文件

某些受版权保护的视频可能无法下载。这种情况下，可以使用--cookiefile选项提供浏览器cookie来解决：

tumblr_backup.py --cookiefile=/path/to/cookies.txt your-blog-name

6.3 备份速度慢

备份速度取决于网络状况和Tumblr服务器响应速度。您可以：

• 减少同时下载的媒体文件数量
• 在网络较空闲的时段进行备份
• 使用增量备份减少数据传输量

七、总结

tumblr-utils是Tumblr用户必备的备份工具，通过本指南，您已经掌握了从安装到高级使用的全部知识。定期备份您的Tumblr博客，确保珍贵的内容不会丢失。

如果您有任何问题，可以查阅项目中的详细文档：

• tumblr_backup.md：完整的备份工具说明
• tumblr_backup_for_beginners.md：新手入门指南

开始使用tumblr-utils，为您的Tumblr数据保驾护航吧！

【免费下载链接】tumblr-utilsUtilities for dealing with Tumblr blogs, Tumblr backup项目地址: https://gitcode.com/gh_mirrors/tu/tumblr-utils