> 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/fr/guide-de-lenseignant/teacher-guide/adding-content/documents.md).

# Documents

L'outil documents est le dépôt de fichiers de votre cours. Vous pouvez y téléverser des fichiers, créer des documents au format HTML, organiser le contenu en dossiers et donner aux apprenants l'accès à tous les supports dont ils ont besoin.

## Accéder à l'outil Documents

Ouvrez l'outil **Documents**  depuis la page d'accueil du cours. Vous verrez un explorateur de fichiers affichant le dossier racine de la bibliothèque de documents de votre cours.

## Téléverser des fichiers

1. Cliquez sur le bouton **Téléverser** 
2. Sélectionnez un ou plusieurs fichiers depuis votre ordinateur (vous pouvez glisser-déposer des fichiers dans la zone de téléversement)
3. Les fichiers sont téléversés et apparaissent dans le dossier courant

Chamilo prend en charge la plupart des types de fichiers courants : PDF, documents bureautiques (.docx, .odt), présentations (.pptx, .odp), tableurs (.xlsx, .ods), images (PNG, JPG, SVG, GIF), fichiers audio, fichiers vidéo (y compris WEBM), fichiers HTML, et plus encore.

Certains formats peuvent être interdits par l'administrateur du portail via un paramètre de filtrage par liste blanche/liste noire dans la section sécurité de l'administration.

Pour une meilleure lisibilité par les apprenants, nous recommandons de téléverser des fichiers qu'un navigateur peut afficher ou ouvrir sans outils supplémentaires. Cela rend votre cours plus portable et, de ce fait, plus accessible aux appareils mobiles et plus lisible pour les personnes ayant des besoins spécifiques.

## Créer du contenu

Outre le téléversement de fichiers, vous pouvez créer du contenu directement dans Chamilo :

### Pages web

1. Cliquez sur **Nouveau document**
2. Utilisez l'éditeur de texte enrichi pour rédiger votre contenu avec mise en forme, images, tableaux et liens
3. Saisissez un **titre** pour la page
4. Enregistrez

L'éditeur de texte enrichi (TinyMCE) offre des fonctionnalités de type traitement de texte, notamment :

* Mise en forme du texte (gras, italique, titres, listes)
* Tableaux
* Images (téléversement ou lien vers des images existantes)
* Vidéos et audio intégrés
* Liens vers d'autres ressources
* Édition de la source HTML pour les utilisateurs avancés

### Génération de médias par IA

Lorsque les assistants IA sont activés sur la plateforme, vous pouvez demander à l'IA de générer une **image** ou une **vidéo courte** pour illustrer un paragraphe du document que vous éditez. Sélectionnez un paragraphe, ouvrez la boîte de dialogue **Générer un média IA**, et l'IA produira un élément multimédia que vous pourrez examiner et insérer. La boîte de dialogue respecte les permissions au niveau du cours et n'apparaît que dans les cours où la génération de médias par IA est autorisée.

### Enregistrement audio

Si votre navigateur le prend en charge, vous pouvez enregistrer de l'audio directement dans l'outil documents — utile pour créer des consignes audio ou du contenu d'apprentissage des langues. Cela nécessite une configuration HTTPS pour Chamilo, car l'enregistrement audio utilise une technologie que le navigateur n'autorise que si la connexion est sécurisée.

## Organiser avec des dossiers

Gardez votre bibliothèque de documents organisée à l'aide de dossiers :

1. Cliquez sur **Nouveau dossier** 
2. Saisissez un nom de dossier
3. Enregistrez

Vous pouvez créer des dossiers imbriqués pour construire une hiérarchie de contenu logique (par ex. `Module 1 > Week 1 > Readings`).

### Déplacer des fichiers

* Localisez votre fichier dans la liste
* Cliquez sur **Déplacer** 
* Sélectionnez le dossier de destination
* Confirmez

## Gérer les documents

Pour chaque fichier ou dossier, vous pouvez :

| Action          | Icône | Description                                                      |
| --------------- | ----- | ---------------------------------------------------------------- |
| **Modifier**    |       | Renommer le fichier ou modifier son contenu (pour les pages web) |
| **Supprimer**   |       | Retirer le fichier ou le dossier                                 |
| **Télécharger** |       | Télécharger le fichier sur votre ordinateur                      |
| **Visibilité**  |       | Masquer ou afficher le fichier aux apprenants                    |
| **Remplacer**   |       | Remplacer le fichier par une version mise à jour                 |
| **Déplacer**    |       | Déplacer vers un autre dossier                                   |

Le remplacement d'un fichier est une fonctionnalité importante lorsque vous utilisez des documents pour construire des parcours d'apprentissage, car le remplacement du document permet de le actualiser sans que les apprenants ne perdent la progression enregistrée pour ce document.

### Actions groupées

Sélectionnez plusieurs fichiers à l'aide des cases à cocher, puis utilisez la barre d'outils pour supprimer ou télécharger tous les éléments sélectionnés en une seule fois.

## Intégration OnlyOffice

Si votre administrateur a configuré le plugin **OnlyOffice**, vous pouvez modifier des fichiers Word, Excel et PowerPoint (ou LibreOffice) directement dans le navigateur, sans les télécharger. Recherchez l’option **Modifier avec OnlyOffice**  lors de la consultation d’un fichier pris en charge.

Les documents sont stockés dans Chamilo ; OnlyOffice sert uniquement à **consulter** ou à modifier les documents dans le navigateur, sans outil supplémentaire.

## Fichiers dans le cloud

Si vous utilisez un stockage cloud (Azure Blob, AWS S3 ou Google Cloud) pour vos fichiers, ceux-ci sont stockés dans le cloud, mais vous pouvez les lier depuis cet outil. Cela est transparent pour vous et pour vos apprenants — l’outil Documents fonctionne de la même manière, quel que soit le backend de stockage.

## Conseils

* **Organisez tôt** — Créez la structure de dossiers avant de téléverser le contenu afin de ne pas devoir réorganiser plus tard. Si vous avez créé d’autres cours avec la bonne structure, vous pourrez les utiliser comme modèles par la suite
* **Utilisez des noms de fichiers descriptifs** — Aidez les apprenants à trouver ce dont ils ont besoin grâce à des noms clairs et parlants
* **Masquez le travail en cours** — Utilisez le commutateur de visibilité pour masquer les documents que vous préparez encore
* **Liez depuis les parcours d’apprentissage** — Référencez des documents dans vos parcours d’apprentissage pour créer des séquences d’apprentissage guidées
* **Vérifiez le quota disque** — Si votre cours a une limite de stockage, supprimez les fichiers obsolètes pour libérer de l’espace