# Documentos

A ferramenta de documentos é o repositório de arquivos do seu curso. Você pode fazer upload de arquivos, criar documentos em formato HTML, organizar conteúdo em pastas e fornecer aos alunos acesso a todos os materiais necessários.

## Acessando a Ferramenta de Documentos

Abra a ferramenta **Documentos** <img src="/files/jl7Ag5XIafr5YfgDCUcW" alt="Documentos" data-size="line"> na página inicial do curso. Você verá um navegador de arquivos exibindo a pasta raiz da biblioteca de documentos do seu curso.

![O navegador de arquivos de documentos mostrando pastas e arquivos com ícones de ação](/files/r0CEVK6lt03Vf14v1um6)

## Fazendo Upload de Arquivos

1. Clique no botão **Upload** <img src="/files/1u463kY5pW2askVYGncW" alt="Upload" data-size="line">
2. Selecione um ou mais arquivos do seu computador (você pode arrastar e soltar arquivos na área de upload)
3. Os arquivos são enviados e aparecem na pasta atual

O Chamilo suporta a maioria dos tipos de arquivo comuns: PDF, documentos de escritório (.docx, .odt), apresentações (.pptx, .odp), planilhas (.xlsx, .ods), imagens (PNG, JPG, SVG, GIF), arquivos de áudio, arquivos de vídeo (incluindo WEBM), arquivos HTML e mais.

Alguns formatos podem ser proibidos pelo administrador do portal por meio de configurações de filtro de lista branca/negra na seção de segurança da administração.

Para melhor legibilidade pelos alunos, recomendamos fazer upload de arquivos que um navegador possa visualizar ou abrir sem ferramentas adicionais. Isso torna seu curso mais portátil e, consequentemente, mais acessível a dispositivos móveis e mais legível para pessoas com necessidades especiais.

## Criando Conteúdo

Além de fazer upload de arquivos, você pode criar conteúdo diretamente no Chamilo:

### Páginas Web

1. Clique em **Novo documento**
2. Use o editor de texto rico para escrever seu conteúdo com formatação, imagens, tabelas e links
3. Insira um **título** para a página
4. Salve

O editor de texto rico (TinyMCE) oferece recursos semelhantes a um processador de texto, incluindo:

* Formatação de texto (negrito, itálico, títulos, listas)
* Tabelas
* Imagens (fazer upload ou vincular a imagens existentes)
* Vídeos e áudios incorporados
* Links para outros recursos
* Edição de código-fonte HTML para usuários avançados

### Geração de Mídia por IA

Quando os assistentes de IA estão habilitados na plataforma, você pode solicitar à IA que gere uma **imagem** ou um **vídeo curto** para ilustrar um parágrafo no documento que está editando. Selecione um parágrafo, abra o diálogo **Gerar mídia por IA**, e a IA produzirá um item de mídia que você pode revisar e inserir. O diálogo respeita as permissões no nível do curso e só aparece em cursos onde a geração de mídia por IA é permitida.

### Gravação de Áudio

Se o seu navegador suportar, você pode gravar áudio diretamente na ferramenta de documentos — útil para criar instruções em áudio ou conteúdo para aprendizado de idiomas. Isso requer uma configuração HTTPS para o Chamilo, pois a gravação de áudio utiliza tecnologia que o navegador só permite se a conexão for segura.

## Organizando com Pastas

Mantenha sua biblioteca de documentos organizada usando pastas:

1. Clique em **Nova pasta** <img src="/files/HKNk0qgy6eVSoGbO7nDI" alt="Nova pasta" data-size="line">
2. Insira um nome para a pasta
3. Salve

Você pode criar pastas aninhadas para construir uma hierarquia lógica de conteúdo (por exemplo, `Módulo 1 > Semana 1 > Leituras`).

### Movendo Arquivos

* Localize seu arquivo na lista
* Clique em **Mover** <img src="/files/QPSpbeOeujcQ21kTwoLA" alt="Mover" data-size="line">
* Selecione a pasta de destino
* Confirme

## Gerenciando Documentos

Para cada arquivo ou pasta, você pode:

| Ação             | Ícone                                                                       | Descrição                                                    |
| ---------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------ |
| **Editar**       | <img src="/files/mnGpZGTr1yqbnyDu5yOP" alt="Editar" data-size="line">       | Renomear o arquivo ou editar seu conteúdo (para páginas web) |
| **Excluir**      | <img src="/files/PEpbkPfXtCEIW5Tew9lA" alt="Excluir" data-size="line">      | Remover o arquivo ou pasta                                   |
| **Baixar**       | <img src="/files/gJyOoO70sQOACoLGI51r" alt="Baixar" data-size="line">       | Baixar o arquivo para o seu computador                       |
| **Visibilidade** | <img src="/files/NUm8Lf9UfdAzT5hmQOpf" alt="Visibilidade" data-size="line"> | Ocultar ou mostrar o arquivo para os alunos                  |
| **Substituir**   | <img src="/files/BlrJ9hyeSiBOlzSf1YHe" alt="Substituir" data-size="line">   | Substituir o arquivo por uma versão atualizada               |
| **Mover**        | <img src="/files/QPSpbeOeujcQ21kTwoLA" alt="Mover" data-size="line">        | Mover para uma pasta diferente                               |

Substituir um arquivo é um recurso importante quando você usa documentos para construir caminhos de aprendizado, pois substituir o documento permitirá que ele seja atualizado sem que os alunos percam o progresso salvo para esse documento.

### Ações em Massa

Selecione vários arquivos usando caixas de seleção, então use a barra de ferramentas para excluir ou baixar todos os itens selecionados de uma só vez.

***

## Integração com OnlyOffice

Se o seu administrador configurou o plugin **OnlyOffice**, você pode editar arquivos do Word, Excel e PowerPoint (ou LibreOffice) diretamente no navegador sem precisar baixá-los. Procure pela opção **Editar com OnlyOffice** <img src="/files/9Hl6hSoxWptsEm9O4Omq" alt="OnlyOffice" data-size="line"> ao visualizar um arquivo compatível.

Os documentos são armazenados no Chamilo, o OnlyOffice é usado apenas para **visualizar** ou editar os documentos no navegador, sem a necessidade de ferramentas adicionais.

## Arquivos na Nuvem

Se você utiliza armazenamento em nuvem (Azure Blob, AWS S3 ou Google Cloud) para seus arquivos, eles são armazenados na nuvem, mas você pode vinculá-los a partir daqui. Isso é transparente para você e seus alunos — a ferramenta de documentos funciona da mesma forma, independentemente do backend de armazenamento.

## Dicas

* **Organize desde o início** — Crie a estrutura de pastas antes de fazer upload de conteúdo para evitar reorganizar depois. Se você já criou outros cursos com a estrutura correta, pode usá-los como modelo posteriormente
* **Use nomes de arquivo descritivos** — Ajude os alunos a encontrar o que precisam com nomes claros e significativos
* **Oculte trabalhos em andamento** — Use o alternador de visibilidade para esconder documentos que ainda está preparando
* **Vincule a partir de trilhas de aprendizagem** — Referencie documentos dentro de suas trilhas de aprendizagem para criar sequências de aprendizado guiadas
* **Verifique a cota de disco** — Se o seu curso tiver um limite de armazenamento, remova arquivos desatualizados para liberar espaço


---

# 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-pt/guia-do-professor/teacher-guide/adding-content/documents.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.
