从安装到使用：tumblr-utils完整操作指南
从安装到使用：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环境：
- 访问Python官方网站下载Python 2.7版本：Python 2.7下载页面
- 选择适合您操作系统的安装包（Windows用户推荐"Windows x86 MSI installer"）
- 双击安装文件，按照提示完成安装
2.2 获取tumblr-utils源码
通过以下命令克隆仓库到本地：
git clone https://gitcode.com/gh_mirrors/tu/tumblr-utils克隆完成后，您将得到一个包含所有工具的tumblr-utils文件夹。
2.3 配置API密钥
使用tumblr_backup.py需要Tumblr API密钥：
- 访问Tumblr OAuth应用页面
- 注册一个新应用，获取OAuth Consumer Key
- 打开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 常用选项
| 选项 | 功能描述 |
|---|---|
| -h, --help | 显示帮助信息 |
| -O OUTDIR | 设置输出目录（默认：blog-name） |
| -i, --incremental | 增量备份模式（只备份新帖子） |
| -l, --likes | 备份博客的点赞内容，而非帖子 |
| -j, --json | 保存原始JSON数据 |
| -k, --skip-images | 不保存图片，链接到Tumblr原图 |
| --save-video | 保存所有视频文件 |
| --save-audio | 保存音频文件 |
| -t TAGS | 只备份包含指定标签的帖子（逗号分隔） |
| -T TYPE | 只备份指定类型的帖子（如text, photo, video等） |
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支持自定义备份页面的样式：
- 自定义CSS：创建custom.css文件并放入备份文件夹，程序将自动应用您的样式
- 样式覆盖：创建override.css文件来覆盖默认样式的特定部分
- 主题样式：博客的原始样式表保存在theme/style.css中
六、常见问题解决
6.1 备份过程中断
如果备份过程意外中断，可以重新运行相同的命令继续备份。对于大型博客，建议使用增量备份模式（-i选项）来避免重复下载。
6.2 无法下载某些媒体文件
某些受版权保护的视频可能无法下载。这种情况下，可以使用--cookiefile选项提供浏览器cookie来解决：
tumblr_backup.py --cookiefile=/path/to/cookies.txt your-blog-name6.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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考