RedNotebook跨平台日记应用安装配置全攻略

RedNotebook是一款功能丰富的跨平台日记应用，支持富文本编辑、标签管理、图片插入和即时搜索等功能，采用Python+GTK技术栈构建，兼容Windows、macOS和Linux系统，是个人知识管理的理想工具。

核心功能速览

RedNotebook提供五大核心功能，满足日常记录需求：

现代化编辑体验

• 支持Markdown语法与可视化编辑切换
• 内置代码高亮与拼写检查功能
• 实时预览与自动保存机制

高效组织系统

• 标签分类与时间轴导航
• 全文搜索与过滤功能
• 自定义模板与快捷插入

多媒介支持

• 图片拖放插入与管理
• 链接自动识别与格式化
• 表格与列表快速创建

数据安全保障

• 本地文件存储（JSON格式）
• 自动备份与版本控制
• 加密笔记功能（需插件支持）

跨平台兼容

• Windows/macOS/Linux全支持
• 数据文件可在不同系统间迁移
• 轻量级设计（安装包<20MB）

RedNotebook 2.0版本主界面，展示日记编辑区与侧边导航面板

3步完成环境准备

Windows环境检查清单

必备组件	最低版本	推荐版本	验证命令
Python	3.8	3.10+	python --version
GTK3	3.18	3.24+	通过安装器自动检测
PyYAML	3.10	6.0+	pip show pyyaml
Git	2.20	2.30+	git --version

💡 实用提示：Windows用户建议通过微软应用商店安装Python，可自动配置环境变量

macOS环境准备指南

1. 安装Homebrew包管理器：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装核心依赖：

   brew install python3 gtk+3 gtksourceview3 py3cairo
   

3. 验证安装：

   brew list | grep -E "python3|gtk\+3"  # 检查关键包是否安装
   

Linux环境快速配置

Debian/Ubuntu系统：

sudo apt update && sudo apt install -y \
  python3 python3-pip python3-yaml \
  libgtk-3-0 libgtksourceview-3.0-1 \
  gir1.2-gtksource-3.0 python3-gi-cairo

Fedora/RHEL系统：

sudo dnf install -y python3 python3-pip python3-PyYAML \
  gtk3 gtksourceview3 python3-gobject-cairo

📌 本节重点：所有平台均需确保Python 3.8+环境，Linux用户优先使用系统包管理器安装依赖，Windows和macOS用户可借助官方安装器简化配置。

零基础也能懂的多平台安装方案

Windows系统安装（基础版）

1. 获取源码：

   git clone https://gitcode.com/gh_mirrors/re/rednotebook  # 克隆仓库
   cd rednotebook  # 进入项目目录
   

2. 安装依赖：

   pip install -r win/requirements.txt  # 安装Windows专用依赖
   

3. 启动应用：

   python rednotebook/journal.py  # 直接运行主程序
   

⚠️ 注意事项：若出现"找不到GTK"错误，请下载并安装GTK3运行时

macOS/Linux系统安装（基础版）

1. 克隆代码库：

   git clone https://gitcode.com/gh_mirrors/re/rednotebook
   cd rednotebook
   

2. 安装依赖：

   pip3 install -r requirements.txt  # 安装Python依赖
   

3. 启动应用：

   ./run  # 执行项目根目录下的run脚本
   

开发者进阶安装方案

1. 安装开发工具链：

   # Ubuntu/Debian
   sudo apt install -y python3-dev libgtk-3-dev
   
   # macOS
   brew install pkg-config gobject-introspection
   

2. 创建虚拟环境：

   python3 -m venv venv  # 创建虚拟环境
   source venv/bin/activate  # 激活环境（Windows: venv\Scripts\activate）
   

3. 安装开发依赖：

   pip install -e .[dev]  # 以可编辑模式安装
   pre-commit install  # 配置代码检查钩子
   

4. 运行测试：

   pytest tests/  # 执行单元测试
   

RedNotebook安装流程示意图，展示从源码获取到应用启动的完整路径

📌 本节重点：普通用户推荐基础版安装，开发者可通过虚拟环境和开发依赖进行二次开发。所有平台均可通过源码直接运行，无需编译步骤。

5分钟个性化配置指南

基础配置优化

1. 界面主题设置

   • 功能说明：调整应用界面风格与颜色方案
   • 推荐设置：菜单栏→编辑→首选项→外观→选择"系统主题"
   • 高级选项：创建~/.config/rednotebook/style.css自定义样式

2. 默认存储位置

   • 功能说明：设置日记数据的保存路径
   • 推荐设置：保持默认~/RedNotebook（Windows: Documents\RedNotebook）
   • 高级选项：在首选项→存储位置中自定义路径，支持网络存储

3. 快捷键配置

   • 功能说明：自定义常用操作的键盘快捷键
   • 推荐设置：启用"Emacs风格快捷键"提升编辑效率
   • 高级选项：编辑default.cfg文件配置自定义快捷键

数据迁移指南

1. 导出数据：

   # 导出为纯文本格式
   python scripts/text2rednotebook.py --export ~/RedNotebook
   

2. 导入数据：

   • 旧版本数据：直接将数据目录复制到新位置
   • 其他格式：使用text2rednotebook.py脚本转换Markdown/HTML文件

3. 云同步设置：

   • 将数据目录添加到Dropbox/OneDrive等同步工具
   • 启用"自动备份"功能（首选项→备份→设置每日备份）

插件扩展功能

RedNotebook支持通过插件扩展功能，常用插件包括：

1. 语法高亮插件

   • 安装：复制插件文件到~/.rednotebook/plugins
   • 功能：支持更多编程语言的代码高亮显示

2. 图片优化插件

   • 安装：pip install rednotebook-image-optimizer
   • 功能：自动压缩插入的图片，节省存储空间

3. 导出增强插件

   • 安装：从项目scripts/目录获取导出脚本
   • 功能：支持导出为PDF、LaTeX等格式

📌 本节重点：通过首选项可完成80%的个性化配置，数据迁移建议采用"导出+导入"方式确保安全，高级用户可通过插件系统扩展功能。

常见问题解决与支持

启动故障排查

错误现象	可能原因	解决方案
缺少GTK模块	GTK运行时未安装	安装对应平台的GTK3运行时
中文显示乱码	字体配置问题	安装文泉驿或思源黑体
启动闪退	Python版本不兼容	确保使用Python 3.8-3.11版本

性能优化技巧

1. 减少启动时间：

   # 创建启动脚本（Linux/macOS）
   cat > ~/rednotebook.sh << EOF
   #!/bin/bash
   cd /path/to/rednotebook
   source venv/bin/activate
   python journal.py
   EOF
   chmod +x ~/rednotebook.sh
   

2. 清理历史数据：

   • 定期删除不需要的旧日记
   • 使用"数据库优化"功能（工具→优化数据库）

3. 禁用不必要功能：

   • 在首选项中关闭"实时拼写检查"
   • 减少自动备份频率（大型日记）

获取官方支持

• 查看内置帮助文档：帮助→RedNotebook帮助
• 查阅官方指南：RedNotebook官方指南
• 提交问题报告：通过项目Issue系统反馈bug

RedNotebook高级功能界面，展示标签云与搜索结果面板

📌 本节重点：启动问题多与依赖环境相关，性能优化可通过脚本和设置调整实现，遇到复杂问题建议查阅官方文档或提交反馈。

通过本指南，您已掌握RedNotebook的安装配置全过程。这款强大的跨平台日记应用将帮助您高效管理个人笔记与想法，开始您的数字记录之旅吧！

官方文档链接：RedNotebook官方指南