QLAddict 项目安装与使用指南

QLAddict 项目安装与使用指南

QLAddict A QuickLook plugin that lets you view subtitles .srt files like Addic7ed.com on mac 项目地址: https://gitcode.com/gh_mirrors/ql/QLAddict

1. 项目目录结构及介绍

QLAddict 是一个用于在 macOS 上预览 .srt 字幕文件的 QuickLook 插件。以下是项目的目录结构及其介绍：

QLAddict/
├── QuickLookAddict.xcodeproj
├── QuickLookAddict
│   ├── assets
│   ├── clang-format
│   ├── gitignore
│   ├── LICENSE
│   ├── README.md
│   └── available-themes.md
└── qlgenerator
    └── Contents
        ├── Info.plist
        ├── MacOS
        │   └── QuickLookAddict
        └── Resources
            ├── themes
            └── styles.css

目录结构说明

• QuickLookAddict.xcodeproj: Xcode 项目文件，用于开发和构建插件。
• QuickLookAddict: 包含插件的主要源代码和资源文件。
  • assets: 可能包含项目所需的静态资源文件。
  • clang-format: 代码格式化配置文件。
  • gitignore: Git 忽略文件配置。
  • LICENSE: 项目许可证文件。
  • README.md: 项目说明文档。
  • available-themes.md: 主题配置说明文档。
• qlgenerator: QuickLook 插件的核心文件夹。
  • Contents: 插件的主要内容。
    • Info.plist: 插件的配置文件，包含插件的基本信息。
    • MacOS: 包含插件的可执行文件。
      • QuickLookAddict: 插件的可执行文件。
    • Resources: 包含插件的资源文件。
      • themes: 主题文件夹，包含不同的主题样式。
      • styles.css: 默认的样式文件。

2. 项目的启动文件介绍

QLAddict 的启动文件是 QuickLookAddict，位于 qlgenerator/Contents/MacOS/ 目录下。这个文件是插件的可执行文件，负责处理 .srt 文件的预览功能。

启动文件说明

• QuickLookAddict: 这是一个二进制可执行文件，当用户在 Finder 中选择一个 .srt 文件并按下空格键时，系统会调用这个文件来生成预览。

3. 项目的配置文件介绍

QLAddict 的配置文件主要包括 Info.plist 和 styles.css。

Info.plist

Info.plist 文件位于 qlgenerator/Contents/ 目录下，包含插件的基本信息和配置。以下是一些关键配置项：

<key>CFBundleIdentifier</key>
<string>com.tattali.QLAddict</string>
<key>CFBundleName</key>
<string>QLAddict</string>
<key>CFBundleVersion</key>
<string>1.3.0</string>
<key>CFBundleShortVersionString</key>
<string>1.3.0</string>
<key>QLSupportedContentTypes</key>
<array>
    <string>public.subtitle</string>
</array>

styles.css

styles.css 文件位于 qlgenerator/Contents/Resources/ 目录下，定义了预览窗口的样式。用户可以根据需要自定义样式，并通过 available-themes.md 文件中的说明创建新的主题。

body {
    font-family: Arial, sans-serif;
    font-size: 14px;
    color: #333;
}

总结

QLAddict 是一个功能强大的 QuickLook 插件，能够方便地在 macOS 上预览 .srt 字幕文件。通过了解项目的目录结构、启动文件和配置文件，用户可以更好地理解和使用这个插件。

QLAddict A QuickLook plugin that lets you view subtitles .srt files like Addic7ed.com on mac 项目地址: https://gitcode.com/gh_mirrors/ql/QLAddict