Nextcloud Preview Generator 项目教程

Nextcloud Preview Generator 项目教程

previewgenerator Nextcloud app to do preview generation in the background. 项目地址: https://gitcode.com/gh_mirrors/pr/previewgenerator

1. 项目的目录结构及介绍

Nextcloud Preview Generator 项目的目录结构如下：

previewgenerator/
├── appinfo/
│   ├── app.php
│   ├── info.xml
│   └── routes.php
├── css/
├── img/
├── js/
├── lib/
│   ├── Command/
│   ├── Controller/
│   ├── Preview/
│   └── Settings/
├── templates/
├── tests/
├── .gitignore
├── .travis.yml
├── composer.json
├── COPYING
├── README.md
└── settings.php

目录结构介绍：

• appinfo/: 包含应用的基本信息和路由配置文件。

  • app.php: 应用的主配置文件。
  • info.xml: 应用的元数据文件。
  • routes.php: 定义应用的路由。

• css/: 存放应用的样式文件。

• img/: 存放应用的图片资源。

• js/: 存放应用的JavaScript文件。

• lib/: 包含应用的核心逻辑和功能实现。

  • Command/: 包含命令行相关的类。
  • Controller/: 包含控制器类，处理用户请求。
  • Preview/: 包含预览生成相关的类。
  • Settings/: 包含设置相关的类。

• templates/: 存放应用的模板文件。

• tests/: 存放应用的测试文件。

• .gitignore: Git忽略文件配置。

• .travis.yml: Travis CI配置文件。

• composer.json: Composer依赖管理文件。

• COPYING: 许可证文件。

• README.md: 项目说明文件。

• settings.php: 应用的配置文件。

2. 项目的启动文件介绍

Nextcloud Preview Generator 项目的启动文件主要是 appinfo/app.php。这个文件是应用的主入口，负责初始化应用并加载必要的组件。

appinfo/app.php 文件介绍：

<?php

// 加载应用的依赖
require_once __DIR__ . '/../vendor/autoload.php';

// 初始化应用
$app = new \OCA\PreviewGenerator\AppInfo\Application();

// 注册应用的命令
$app->registerCommands();

• 加载依赖: 使用 require_once 加载 Composer 生成的自动加载文件。
• 初始化应用: 创建 Application 类的实例，初始化应用。
• 注册命令: 调用 registerCommands 方法，注册应用的命令行命令。

3. 项目的配置文件介绍

Nextcloud Preview Generator 项目的主要配置文件是 settings.php。这个文件包含了应用的配置选项，如预览生成的超时时间、支持的文件格式等。

settings.php 文件介绍：

<?php

return [
    'preview_generator' => [
        'timeout' => 60, // 预览生成的超时时间，单位为秒
        'supported_mimetypes' => [
            'image/png',
            'image/jpeg',
            'image/gif',
            // 其他支持的 MIME 类型
        ],
        // 其他配置选项
    ],
];

• timeout: 预览生成的超时时间，单位为秒。可以通过设置 LIBREOFFICE_PROCESS_TIMEOUT 环境变量来修改。
• supported_mimetypes: 支持的 MIME 类型列表，用于指定哪些文件格式可以生成预览。

通过这些配置选项，管理员可以根据实际需求调整预览生成的行为。

previewgenerator Nextcloud app to do preview generation in the background. 项目地址: https://gitcode.com/gh_mirrors/pr/previewgenerator