Nextcloud 预览生成器（previewgenerator）安装与配置指南

Nextcloud 的预览生成器是一款强大的后台应用，用于在Nextcloud中自动创建文件的预览，比如缩略图、文本概览或JSON概述。以下是关于该项目的核心模块解析：

1. 项目目录结构及介绍

Nextcloud的插件通常遵循特定的目录结构，虽然具体的内部细节可能因项目而异，但一般来说，previewgenerator项目可能会包含以下关键部分：

• root: 主目录，包含整个项目的入口点。
  • composer.json: 管理依赖关系的文件。
  • config.php: 应用的配置模板，定义默认配置选项。
  • lib: 包含主要的应用逻辑代码。
    • PreviewGenerator: 主类或相关功能实现的PHP文件。
  • templates: 存放任何前端所需的HTML模板。
  • assets: 可能包含CSS、JavaScript等静态资源。
  • tests: 测试脚本和案例。
  • README.md: 提供快速入门指导和项目概述。

请注意，实际的目录结构应以下载的项目源码为准，上述仅为常见模式的概括。

2. 项目的启动文件介绍

Nextcloud的插件并非独立运行，它们通过Nextcloud框架激活并工作。因此，“启动”更多是指其在Nextcloud环境中的启用和配置过程，而不是传统意义上的单一启动文件。关键步骤包括：

• 激活插件: 在Nextcloud的管理界面中，通常有一个插件或应用程序的部分，可以找到并激活“Preview Generator”。
• 命令行初始化: 对于预生成预览的任务，可能需要通过Nextcloud提供的命令行工具（如occ命令）来执行预生成操作，例如occ previewgenerator:pre-generate。

3. 项目的配置文件介绍

配置概述

配置主要通过Nextcloud的全局配置机制进行，不直接通过一个特定的配置文件进行修改，除非是涉及到Nextcloud本身的config/config.php。然而，对于特定于该插件的设置，可以通过以下方式调整：

• 命令行配置: 使用类似occ config:app:set previewgenerator key value的命令来设置插件的配置项。

  • 例如，限制预览尺寸可以通过设置previewgenerator squareSizes, widthSizes, 和 heightSizes的值。

• 环境变量: 对于一些高级配置，如改变LibreOffice处理超时时间，可通过设置环境变量LIBREOFFICE_PROCESS_TIMEOUT来完成。

重要配置示例:

• 生成特定大小的预览: 设置方形预览尺寸，使用命令occ config:app:set previewgenerator squareSizes --value="64 256 1024"。

请注意，这些配置指令需在Nextcloud服务器的命令行环境中执行，确保具有适当的权限。

通过以上模块的深入理解，你可以有效地部署并自定义Nextcloud的预览生成器插件，以满足特定的预览需求和优化性能。