> 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/fi/opettajan-opas/teacher-guide/adding-content/documents.md).

# Dokumentit

Dokumentit-työkalu on kurssisi tiedostovarasto. Voit ladata tiedostoja, luoda HTML-muotoisia dokumentteja, järjestää sisältöä kansioihin ja antaa oppijoille pääsyn kaikkiin tarvitsemiinsa materiaaleihin.

## Dokumentit-työkalun avaaminen

Avaa **Dokumentit**-työkalu  kurssin etusivulta. Näet tiedostoselaimen, joka näyttää kurssin dokumenttikirjaston juurikansion.

## Tiedostojen lataaminen

1. Napsauta **Lataa**-painiketta 
2. Valitse tietokoneeltasi yksi tai useampi tiedosto (voit vetää ja pudottaa tiedostoja latausalueelle)
3. Tiedostot ladataan ja ne näkyvät nykyisessä kansiossa

Chamilo tukee useimpia yleisiä tiedostotyyppejä: PDF, toimistotiedostot (.docx, .odt), esitykset (.pptx, .odp), taulukkolaskennat (.xlsx, .ods), kuvat (PNG, JPG, SVG, GIF), äänitiedostot, videotiedostot (mukaan lukien WEBM), HTML-tiedostot ja muita.

Jotkin muodot voivat olla kiellettyjä portaalin ylläpitäjän toimesta sallittujen/kiellettyjen luetteloiden suodatusasetuksella hallinnan suojausosiossa.

Oppijoiden luettavuuden parantamiseksi suosittelemme lataamaan tiedostoja, jotka selain voi näyttää tai avata ilman lisätyökaluja. Tämä tekee kurssistasi siirrettävämmän ja siten saavutettavamman mobiililaitteilla sekä luettavamman erityistarpeisille henkilöille.

## Sisällön luominen

Tiedostojen lataamisen lisäksi voit luoda sisältöä suoraan Chamilossa:

### Verkkosivut

1. Napsauta **Uusi dokumentti**
2. Käytä rich-text-editoria sisällön kirjoittamiseen muotoiluineen, kuvineen, taulukoineen ja linkkeineen
3. Anna sivulle **otsikko**
4. Tallenna

Rich-text-editori (TinyMCE) tarjoaa tekstinkäsittelyohjelmaa muistuttavia ominaisuuksia, muun muassa:

* Tekstin muotoilu (lihavointi, kursivointi, otsikot, luettelot)
* Taulukot
* Kuvat (lataa tai linkitä olemassa oleviin kuviin)
* Upotetut videot ja ääni
* Linkit muihin resursseihin
* HTML-lähdekoodin muokkaus edistyneille käyttäjille

### Tekoälyn mediagenerointi

Kun tekoälyavustajat ovat käytössä alustalla, voit pyytää tekoälyä tuottamaan **kuvan** tai **lyhyen videon** havainnollistamaan kappaletta muokkaamassasi dokumentissa. Valitse kappale, avaa **Luo tekoälymedia** -valintaikkuna, ja tekoäly tuottaa mediasisällön, jonka voit tarkistaa ja lisätä. Valintaikkuna noudattaa kurssitason käyttöoikeuksia ja näkyy vain kursseilla, joissa tekoälyn mediagenerointi on sallittu.

### Äänitallennus

Jos selaimesi tukee sitä, voit tallentaa ääntä suoraan dokumentit-työkalussa — hyödyllistä ääniohjeiden tai kieltenoppimissisällön luomiseen. Tämä edellyttää Chamilolle HTTPS-määritystä, koska äänitallennus käyttää teknologiaa, jonka selain sallii vain suojatussa yhteydessä.

## Järjestäminen kansioilla

Pidä dokumenttikirjastosi järjestyksessä kansioiden avulla:

1. Napsauta **Uusi kansio** 
2. Anna kansion nimi
3. Tallenna

Voit luoda sisäkkäisiä kansioita loogisen sisältöhierarkian rakentamiseksi (esim. `Module 1 > Week 1 > Readings`).

### Tiedostojen siirtäminen

* Etsi tiedosto luettelosta
* Napsauta **Siirrä** 
* Valitse kohdekansio
* Vahvista

## Dokumenttien hallinta

Jokaiselle tiedostolle tai kansiolle voit:

| Toiminto     | Kuvake | Kuvaus                                                             |
| ------------ | ------ | ------------------------------------------------------------------ |
| **Muokkaa**  |        | Nimeä tiedosto uudelleen tai muokkaa sen sisältöä (verkkosivuille) |
| **Poista**   |        | Poista tiedosto tai kansio                                         |
| **Lataa**    |        | Lataa tiedosto tietokoneellesi                                     |
| **Näkyvyys** |        | Piilota tai näytä tiedosto oppijoille                              |
| **Korvaa**   |        | Korvaa tiedosto päivitetyllä versiolla                             |
| **Siirrä**   |        | Siirrä toiseen kansioon                                            |

Tiedoston korvaaminen on tärkeä ominaisuus, kun käytät dokumentteja oppimispolkujen rakentamiseen, sillä dokumentin korvaaminen mahdollistaa sen päivittämisen ilman, että oppijat menettävät kyseiseen dokumenttiin tallennettua edistymistä.

### Joukkotoiminnot

Valitse useita tiedostoja valintaruuduilla ja käytä sitten työkalupalkkia kaikkien valittujen kohteiden poistamiseen tai lataamiseen kerralla.

## OnlyOffice-integraatio

Jos ylläpitäjäsi on määrittänyt **OnlyOffice**-lisäosan, voit muokata Word-, Excel- ja PowerPoint-tiedostoja (tai LibreOffice-tiedostoja) suoraan selaimessa lataamatta niitä. Etsi tuettua tiedostoa tarkastellessasi vaihtoehto **Muokkaa OnlyOfficella** .

Asiakirjat tallennetaan Chamiloon; OnlyOfficea käytetään vain asiakirjojen **tarkasteluun** tai muokkaamiseen selaimessa ilman lisätyökaluja.

## Pilvitiedostot

Jos käytät tiedostoillesi pilvitallennusta (Azure Blob, AWS S3 tai Google Cloud), ne tallennetaan pilveen, mutta voit linkittää ne täältä. Tämä on sinulle ja oppijoillesi läpinäkyvää — asiakirjatyökalu toimii samalla tavalla tallennustaustasta riippumatta.

## Vinkkejä

* **Järjestä ajoissa** — Luo kansiorakenne ennen sisällön lataamista, jotta sinun ei tarvitse järjestellä myöhemmin. Jos olet luonut muita kursseja oikealla rakenteella, voit käyttää niitä myöhemmin mallina
* **Käytä kuvaavia tiedostonimiä** — Auta oppijoita löytämään tarvitsemansa selkeillä, merkityksellisillä nimillä
* **Piilota keskeneräinen työ** — Käytä näkyvyyskytkintä piilottaaksesi asiakirjat, joita vielä valmistelet
* **Linkitä oppimispoluista** — Viittaa asiakirjoihin oppimispoluissasi luodaksesi ohjattuja oppimisjaksoja
* **Tarkista levykiintiö** — Jos kurssillasi on tallennusraja, poista vanhentuneet tiedostot vapauttaaksesi tilaa