> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/ja/gaido/teacher-guide/adding-content/documents.md).

# ドキュメント

ドキュメントツールは、コースのファイルリポジトリです。ファイルのアップロード、HTML形式のドキュメント作成、フォルダによるコンテンツの整理、学習者が必要な教材すべてへのアクセス付与が可能です。

## ドキュメントツールへのアクセス

コースホームページから **ドキュメント**  ツールを開きます。コースのドキュメントライブラリのルートフォルダを示すファイルブラウザが表示されます。

## ファイルのアップロード

1. **アップロード**  ボタンをクリックします
2. コンピュータから1つ以上のファイルを選択します（アップロード領域にファイルをドラッグ＆ドロップすることもできます）
3. ファイルがアップロードされ、現在のフォルダに表示されます

Chamiloは、一般的なファイル形式のほとんどをサポートしています。PDF、オフィス文書（.docx、.odt）、プレゼンテーション（.pptx、.odp）、スプレッドシート（.xlsx、.ods）、画像（PNG、JPG、SVG、GIF）、音声ファイル、動画ファイル（WEBMを含む）、HTMLファイルなどです。

一部の形式は、管理画面のセキュリティセクションにあるホワイトリスト／ブラックリストのフィルタ設定により、ポータル管理者が禁止している場合があります。

学習者の読みやすさを高めるため、ブラウザが追加ツールなしで表示または開けるファイルをアップロードすることを推奨します。これによりコースの移植性が高まり、モバイル端末からも利用しやすくなり、特別な支援が必要な人にとっても読みやすくなります。

## コンテンツの作成

ファイルのアップロードに加え、Chamilo内で直接コンテンツを作成できます。

### Webページ

1. **新規ドキュメント** をクリックします
2. リッチテキストエディタを使い、書式、画像、表、リンクを含むコンテンツを作成します
3. ページの **タイトル** を入力します
4. 保存します

リッチテキストエディタ（TinyMCE）は、ワードプロセッサに近い次の機能を提供します。

* テキストの書式設定（太字、斜体、見出し、リスト）
* 表
* 画像（アップロード、または既存画像へのリンク）
* 埋め込み動画と音声
* 他のリソースへのリンク
* 上級者向けのHTMLソース編集

### AIメディア生成

プラットフォームでAIヘルパーが有効な場合、編集中のドキュメントの段落を説明する **画像** または **短い動画** の生成をAIに依頼できます。段落を選択し、**AIメディアを生成** ダイアログを開くと、AIがメディア項目を生成し、確認して挿入できます。ダイアログはコースレベルの権限に従い、AIメディア生成が許可されているコースでのみ表示されます。

### 音声録音

ブラウザが対応している場合、ドキュメントツール内で直接音声を録音できます。音声による指示や語学学習コンテンツの作成に便利です。音声録音は、接続が安全な場合にのみブラウザが許可する技術を使用するため、ChamiloのHTTPS構成が必要です。

## フォルダによる整理

フォルダを使ってドキュメントライブラリを整理します。

1. **新規フォルダ**  をクリックします
2. フォルダ名を入力します
3. 保存します

入れ子のフォルダを作成し、論理的なコンテンツ階層を構築できます（例: `Module 1 > Week 1 > Readings`）。

### ファイルの移動

* 一覧からファイルを探します
* **移動**  をクリックします
* 移動先フォルダを選択します
* 確定します

## ドキュメントの管理

各ファイルまたはフォルダに対して、次の操作ができます。

| 操作         | アイコン | 説明                           |
| ---------- | ---- | ---------------------------- |
| **編集**     |      | ファイル名の変更、または内容の編集（Webページの場合） |
| **削除**     |      | ファイルまたはフォルダを削除します            |
| **ダウンロード** |      | ファイルをコンピュータにダウンロードします        |
| **表示／非表示** |      | 学習者に対してファイルを非表示または表示にします     |
| **置換**     |      | ファイルを更新版に置き換えます              |
| **移動**     |      | 別のフォルダへ移動します                 |

ファイルの置換は、ドキュメントを使ってラーニングパスを構築する場合に重要な機能です。ドキュメントを置換すると、学習者がそのドキュメントに保存した進捗を失うことなく、内容を更新できます。

### 一括操作

チェックボックスで複数のファイルを選択し、ツールバーから選択した項目をまとめて削除またはダウンロードできます。

## OnlyOffice 連携

管理者が **OnlyOffice** プラグインを設定している場合、Word、Excel、PowerPoint（または LibreOffice）のファイルをダウンロードせずに、ブラウザー上で直接編集できます。対応ファイルを表示しているときに、**OnlyOffice で編集**  オプションを探してください。

文書は Chamilo に保存されます。OnlyOffice は、追加のツールを必要とせず、ブラウザー上で文書を**表示**または編集するためだけに使用されます。

## クラウドファイル

ファイルにクラウドストレージ（Azure Blob、AWS S3、または Google Cloud）を使用している場合、ファイルはクラウドに保存されますが、ここからリンクできます。これはあなたと学習者にとって透過的です。ストレージのバックエンドに関係なく、ドキュメントツールは同じように動作します。

## ヒント

* **早めに整理する** — 後で再整理しなくて済むよう、コンテンツをアップロードする前にフォルダー構造を作成してください。適切な構造の他のコースを作成済みであれば、後でそれらのコースをテンプレートとして使用できます
* **分かりやすいファイル名を使う** — 明確で意味のある名前で、学習者が必要なものを見つけやすくします
* **作成中のものを非表示にする** — まだ準備中の文書は、表示切替を使って非表示にします
* **ラーニングパスからリンクする** — ラーニングパス内で文書を参照し、ガイド付きの学習シーケンスを作成します
* **ディスククォータを確認する** — コースにストレージ上限がある場合は、古いファイルを削除して空き容量を確保します
