Foliate电子书阅读器自定义主题配置指南

主题配置原理

Foliate作为一款现代化的GTK电子书阅读器，支持用户通过JSON文件自定义阅读主题。主题系统采用双模式设计，分别适配系统的浅色和深色模式。每个主题需要包含两个配色方案：

• light：浅色模式下的配色
• dark：深色模式下的配色

配置步骤详解

1. 创建主题目录 在用户配置目录下创建特定文件夹：

   ~/.config/com.github.johnfactotum.Foliate/themes/
   

2. 编写主题文件 新建JSON格式的主题文件，例如custom_theme.json，需包含以下基本结构：

   {
     "label": "主题显示名称",
     "light": {
       "fg": "前景色(文字)",
       "bg": "背景色",
       "link": "链接颜色"
     },
     "dark": {
       "fg": "前景色(文字)",
       "bg": "背景色",
       "link": "链接颜色"
     }
   }
   

3. 颜色值格式

   • 支持标准的十六进制颜色代码
   • 示例：

     "fg": "#999999",
     "bg": "#cccccc"
     

使用注意事项

1. 应用生效

   • 修改主题后需要完全重启Foliate应用
   • 某些情况下可能需要重启两次才能看到变化

2. 界面操作

   • 通过视图菜单(右上角三点按钮)切换浅色/深色模式
   • 在"字体与布局设置"对话框中选择自定义主题

3. 系统集成

   • 默认跟随系统颜色模式
   • 可手动覆盖系统设置

高级技巧

1. 主题设计建议

   • 保持足够的对比度确保可读性
   • 深色模式建议使用较暗的背景色
   • 浅色模式避免使用纯白色背景以减少眼睛疲劳

2. 调试技巧

   • 检查JSON文件格式是否正确
   • 确认文件保存在正确的目录
   • 查看应用日志获取错误信息

常见问题解决方案

1. 主题不显示

   • 确认配置文件路径正确
   • 检查JSON语法是否正确
   • 尝试完全退出后重新启动应用

2. 颜色不生效

   • 确认当前系统/应用的颜色模式
   • 检查颜色值格式是否正确

通过以上配置，用户可以轻松打造个性化的阅读体验，满足不同环境和偏好的阅读需求。