# 文档

课程**文档**工具的行为设置——上传、允许的扩展名、共享和模板。

通过**管理 > 配置设置 > 文档**访问这些设置。此类别包含**29个设置**，以下列出平台设置固定数据（`SettingsCurrentFixtures.php`）中提供的标题和注释。

> 代码中的变量名以等宽字体显示。在通过API进行脚本编写或需要通过编辑[`config/settings_override.yaml`](https://github.com/chamilo/chamilo-lms/wiki/Configurations#configsettings_overridesyaml) 在全局级别更改这些设置时使用它。

## 设置

### `access_url_specific_files`

**启用特定URL文件**

在多URL配置中启用此功能后，您可以访问主URL并为任何文件（在文档工具中）提供特定URL版本。从不同URL查看时，原始文件将被替代文件替换。这允许您进一步自定义每个URL，同时享受多次重复使用相同课程的优势。

*默认值：`false`*

### `default_document_quotum`

**默认硬盘空间**

课程的可用磁盘空间是多少？您可以通过以下路径为特定课程覆盖配额：平台管理 > 课程 > 修改

*默认值：`1000`*

### `default_group_quotum`

**小组可用磁盘空间**

小组文档工具的默认可用硬盘空间是多少？

*默认值：`250`*

### `documents_custom_cloud_link_list`

**为云链接设置严格的主机列表**

文档工具可以集成云端文件的链接。云服务列表限制在硬编码列表中，但您可以定义‘links’数组，其中包含您自己的服务/URL列表。此处定义的列表将替换默认列表。

### `documents_default_visibility_defined_in_course`

**课程中定义的文档可见性**

所有课程的默认文档可见性

*默认值：`false`*

### `documents_hide_download_icon`

**隐藏文档下载图标**

在文档工具中，对用户隐藏下载图标。

*默认值：`false`*

### `enable_x_sendfile_headers`

**启用X-sendfile头**

如果您在Web服务器级别启用了X-sendfile，并且希望为浏览器添加所需的头信息，请启用此选项。

*默认值：`false`*

### `group_category_document_access`

**为小组类别内的文档启用共享选项**

启用后，管理员可以按类别为文档小组设置文档访问和共享权限。

*默认值：`false`*

### `group_document_access`

**为小组文档启用共享选项**

启用后，可以在小组级别配置文档共享和访问权限。

*默认值：`false`*

### `pdf_export_watermark_by_course`

**按课程启用水印定义**

启用此选项后，教师可以为他们课程中的文档定义自己的水印。

*默认值：`false`*

### `pdf_export_watermark_enable`

**在PDF导出中启用水印**

通过启用此选项，您可以上传图像或文本，这些图像或文本将自动作为水印添加到系统上所有文档的PDF导出中。

*默认值：`false`*

### `pdf_export_watermark_text`

**PDF水印文本**

此文本将作为水印添加到文档的PDF导出中。

### `permanently_remove_deleted_files`

**删除的文件无法恢复**

在文档工具中删除文件将永久删除该文件。文件无法恢复。

*默认值：`false`*

### `permissions_for_new_directories`

**新目录的权限**

定义分配给每个新创建目录的权限设置的能力让您可以提高安全性，防止黑客上传危险内容到您的门户网站。默认设置（0770）应该足以给您的服务器提供合理的保护级别。给定的格式使用UNIX术语，即Owner-Group-Others的读-写-执行权限。

*默认值：`0770`*

### `permissions_for_new_files`

**新文件的权限**

定义分配给每个新创建文件的权限设置的能力让您可以提高安全性，防止黑客上传危险内容到您的门户网站。默认设置（0550）应该足以给您的服务器提供合理的保护级别。给定的格式使用UNIX术语，即Owner-Group-Others的读-写-执行权限。如果您使用Oogie，请注意启动LibreOffice的用户可以在课程文件夹中写入文件。

*默认值：`0660`*

### `send_notification_when_document_added`

**添加文档时向学生发送通知**

每当有人在文档工具中创建新项目时，向用户发送通知。

*默认值：`false`*

***

### `show_default_folders`

**在文档工具中显示默认提供的包含多媒体资源的文件夹**

多媒体文件文件夹包含按类别组织的默认提供的文件，包括视频、音频、图像和Flash动画，可在课程中使用。即使您在文档工具中将其设置为不可见，您仍然可以在平台网页编辑器中使用这些资源。

*默认值：`true`*

### `show_documents_preview`

**显示文档预览**

在文档工具中显示文档预览可以避免仅为显示文档而加载新页面，但在某些较旧的浏览器或较小宽度的屏幕上可能会导致不稳定。

*默认值：`false`*

### `show_users_folders`

**在文档工具中显示用户文件夹**

此选项允许您向教师显示或隐藏系统为每个访问文档工具或通过网页编辑器发送文件的用户生成的文件夹。如果您向教师显示这些文件夹，他们可以选择是否对学习者可见，并允许每个学习者拥有课程中的特定空间，不仅可以存储文档，还可以创建和编辑网页并导出为PDF、制作绘图、创建个人网页模板、发送文件，以及创建、移动和删除目录和文件，并从他们的文件夹中制作安全副本。每个课程用户都拥有一个完整的文档管理器。此外，请记住，任何用户都可以将文档工具中任何文件夹（无论是否为所有者）中可见的文件复制到他/她的作品集或社交网络的个人文档区域，从而可以在其他课程中使用。

*默认值：`true`*

### `students_download_folders`

**允许学习者下载目录**

允许学习者从文档工具中打包并下载整个目录。

*默认值：`true`*

### `students_export2pdf`

**允许学习者在文档和Wiki工具中将网页文档导出为PDF格式**

此功能默认启用，但在服务器过载滥用情况下，或在特定的学习环境中，您可能希望为所有课程禁用此功能。

*默认值：`true`*

### `thematic_pdf_orientation`

**课程进度PDF方向**

在课程进度工具中，您可以打印不同元素的PDF。设置‘portrait’（纵向）或‘landscape’（横向）（技术术语）来更改方向。

*默认值：`landscape`*

### `upload_extensions_blacklist`

**黑名单 - 设置**

黑名单用于通过删除（或重命名）以下黑名单中列出的文件扩展名来过滤文件扩展名。扩展名应不带前导点（.），并以分号（;）分隔，例如：exe;com;bat;scr;php。没有扩展名的文件是可以接受的。字母大小写（大写/小写）无关紧要。

### `upload_extensions_list_type`

**文档上传的过滤类型**

您是希望使用黑名单还是白名单过滤。有关更多详细信息，请参见下面的黑名单或白名单描述。

*默认值：`blacklist`*

### `upload_extensions_replace_by`

**替换扩展名**

输入您希望用来替换过滤器检测到的危险扩展名的扩展名。仅在您选择了按替换进行过滤时需要。

*默认值：`dangerous`*

### `upload_extensions_skip`

**过滤行为（跳过/重命名）**

如果您选择跳过，通过黑名单或白名单过滤的文件将不会上传到系统。如果您选择重命名，它们的扩展名将被替换为扩展名替换设置中定义的扩展名。请注意，重命名并不能真正保护您，并且如果存在多个同名但扩展名不同的文件，可能会导致名称冲突。

*默认值：`true`*

### `upload_extensions_whitelist`

**白名单 - 设置**

白名单用于通过删除（或重命名）任何文件扩展名不在以下白名单中列出的文件来过滤文件扩展名。通常认为这是一种更安全但更具限制性的过滤方法。扩展名应不带前导点（.），并以分号（;）分隔，例如：htm;html;txt;doc;xls;ppt;jpg;jpeg;gif;sxw。没有扩展名的文件是可以接受的。字母大小写（大写/小写）无关紧要。

### `users_copy_files`

**允许用户将课程中的文件复制到个人文件区域**

允许用户将课程中的文件复制到个人文件区域，可通过社交网络或在课程外通过HTML编辑器查看。

*默认值：`true`*

### `video_features`

**视频功能**

您可以为Chamilo中的视频播放器启用的一系列额外功能。选项包括‘speed’，允许您更改视频的播放速度。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-zh-cn/guan-li-zhi-nan/admin-guide/platform-settings/document-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.