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

从安装到使用tumblr-utils完整操作指南【免费下载链接】tumblr-utilsUtilities for dealing with Tumblr blogs, Tumblr backup项目地址: https://gitcode.com/gh_mirrors/tu/tumblr-utilstumblr-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 安装Pythontumblr-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-dlEXIF标签支持安装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），仅供参考