# ドキュメント

コースの**ドキュメント**ツールの動作 — アップロード、許可される拡張子、共有、テンプレート。

これらの設定には、**管理 > 設定 > ドキュメント**からアクセスできます。このカテゴリには**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`

**クラウドリンクの厳密なホストリストを設定する**

ドキュメントツールはクラウド内のファイルへのリンクを統合できます。クラウドサービスのリストはハードコードされたリストに制限されていますが、独自のサービス/URLのリストを含む‘links’配列を定義できます。ここで定義したリストはデフォルトのリストを置き換えます。

### `documents_default_visibility_defined_in_course`

**コース内で定義されたドキュメントの可視性**

すべてのコースにおけるデフォルトのドキュメントの可視性。

*デフォルト: `false`*

### `documents_hide_download_icon`

**ドキュメントのダウンロードアイコンを非表示にする**

ドキュメントツール内で、ユーザーからダウンロードアイコンを非表示にします。

*デフォルト: `false`*

### `enable_x_sendfile_headers`

**X-sendfileヘッダーを有効にする**

ウェブサーバーレベルで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用語を使用しています。

*デフォルト: `0770`*

### `permissions_for_new_files`

**新しいファイルの権限**

新しく作成されるすべてのファイルに割り当てる権限設定を定義する機能により、ポータルに危険なコンテンツをアップロードするハッカーからの攻撃に対するセキュリティを向上させることができます。デフォルト設定（0550）は、サーバーに合理的な保護レベルを提供するのに十分であるはずです。指定された形式は、所有者-グループ-その他に対する読み取り-書き込み-実行権限のUNIX用語を使用しています。Oogieを使用する場合、LibreOfficeを起動するユーザーがコースフォルダにファイルを書き込めるように注意してください。

*デフォルト: `0660`*

### `send_notification_when_document_added`

**ドキュメントが追加されたときに学生に通知を送信する**

ドキュメントツールで新しいアイテムが作成されるたびに、ユーザーに通知を送信します。

*デフォルト: `false`*

***

### `show_default_folders`

**ドキュメントツールにデフォルトで提供されるマルチメディアリソースを含むすべてのフォルダを表示する**

デフォルトで提供されるファイルをカテゴリ別に整理したマルチメディアファイルフォルダ（ビデオ、オーディオ、画像、フラッシュアニメーション）をコースで使用するために表示します。ドキュメントツール内で非表示にしても、プラットフォームのウェブエディタではこれらのリソースを引き続き使用できます。

*デフォルト: `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-ja/gaido-1/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.
