> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fi/luokkatiedostot/02-overleaf-and-tex-live.md). # Luettelo paketeista ja luokkatiedostoista Tässä artikkelissa esitellään TeX Live ja kuvataan sen käyttöä Overleafin LaTeX-pohjaisessa taittopalvelussa. ## Johdatus TeX Liveen [TeX Live](https://www.tug.org/texlive/) on ilmainen ohjelmistojakelupaketti, jonka julkaisee vuosittain [TeX Users Group](https://www.tug.org/). Se tarjoaa LaTeX-paketit, fontit, TeX-moottorit ja lukuisat ohjelmistotyökalut, joita tarvitaan LaTeX-pohjaisen taiton tukemiseen kaikissa tavallisissa käyttöjärjestelmissä. TeX Live on tärkeä osa Overleafia, koska palvelimemme käyttävät sitä LaTeX-koodisi kokoamiseen ja reaaliaikaisen PDF-esikatselun luomiseen. Se tarjoaa myös Overleafin käyttäjille helpon pääsyn yli 5 000 LaTeX-pakettiin, jotka sisältyvät kuhunkin TeX Live -julkaisuun. Et ole rajoittunut käyttämään TeX Liven uusinta versiota projektiesi kokoamiseen, koska Overleafin palvelimet tarjoavat pääsyn aiempiin TeX Live -julkaisuihin. Projekteja voidaan helposti [vaihtaa käyttämään TeX Liven aiempaa versiota](#how-do-i-change-a-projects-tex-live-version)—esimerkiksi pakettien yhteensopivuusongelmien vuoksi. ## Mitä LaTeX-paketteja Overleaf tukee? Koska Overleaf käyttää TeX Livea, voit käyttää yli 5 000 pakettia, mukaan lukien: * Kuvat käyttäen [pstricks](https://ctan.org/pkg/pstricks-base?lang=en) ja [TikZ](https://en.wikipedia.org/wiki/PGF/TikZ). Tässä on joitakin [TikZ-esimerkkejä](https://www.overleaf.com/latex/examples/tagged/tikz). * Lähdeluettelot käyttäen [BibTeX](https://www.bibtex.org/) ja [BibLaTeX](https://ctan.org/pkg/biblatex?lang=en). Tässä on [muutamia esimerkkejä](https://www.overleaf.com/gallery/tagged/bibliography). * Paketit, kuten [fontspec](https://ctan.org/pkg/fontspec) jotka XeLaTeX ja LuaLaTeX vaativat OpenType-fonttitukea varten. Voit selata TeX- ja LaTeX-pakettien luetteloa CTANin alasivulla [CTAN: Paketit](https://ctan.org/pkg/). ## Mitä TeX Live -versiota projektini käyttää? Kun luot uuden Overleaf-projektin tai kopioit olemassa olevan, uusi (tai kopioitu) projekti kootaan oletusarvoisesti palvelimillemme asennetun TeX Liven uusimmalla versiolla. Kun tarjoamme käyttäjillemme uuden TeX Live -version, emme päivitä olemassa olevia projekteja automaattisesti. Tämän tekeminen automaattisesti voisi aiheuttaa virheitä tai varoituksia olemassa olevissa projekteissasi TeX Live -versioiden erojen vuoksi. ### Lisähuomioita TeX Livestä ja Overleaf-projektistasi * Jakamattoman projektin kokoamiseen käytettävää TeX Live -versiota hallitsee kyseisen projektin omistaja. Jos kuitenkin jaetun projektin yhteistyökumppani vaihtaa TeX Live -version, se vaikuttaa kaikkiin, jotka osallistuvat kyseiseen projektiin. * TeX Live -versio on projektikohtainen asetus: sen muuttaminen tietylle projektille ei vaikuta muihin Overleaf-työtilasi projekteihin eikä muuta mitään sen projektin lähdekoodissa, jonka TeX Live -versiota vaihdetaan. * Kun olet valinnut tietyn TeX Live -version, kaikki projektisi käyttämät paketit ovat tietenkin kyseisessä TeX Live -julkaisussa saatavilla ja julkaistuja versioita. * Siirtyminen toiseen TeX Live -asetukseen voi muuttaa pakettien toimintaa, kuten niiden tarjoamissa komennoissa tapahtuvia muutoksia. * Projektin TeX Live -version vaihtaminen ei ole pysyvää; voit palauttaa sen aiempaan versioon milloin tahansa tarvittaessa. Muista aina, että eri TeX Live -julkaisuissa voi olla päivityksiä ja muutoksia, jotka voivat vaikuttaa siihen, pystyykö projektisi kokoamaan tietyn TeX Live -julkaisun avulla. ## Miten vaihdan projektin TeX Live -version? Toimi seuraavasti vaihtaaksesi projektin TeX Live -version — TeX Live -asetus on *kohtainen jokaiselle projektille* eikä vaikuta muihin projekteihin, joita sinulla saattaa olla: 1. Valitse Overleaf-valikkopainike (![Overleaf menu button](/files/39f5cf29ed7dac9874c87d6d31aecff87509ef26)) ja etsi valikkokohta nimeltä **Asetukset**. 2. Sisällä **Asetukset**, valitse alasvetoluettelo nimeltä **TeX Live -versio**. 3. Valitse projektisi tarvitsema TeX Live -versio ja sulje sitten valikko napsauttamalla mitä tahansa valikkoluettelon ulkopuolella. 4. Käännä projektisi uudelleen testataksesi yhteensopivuuden valitun TeX Live -version kanssa. Seuraava kuva tiivistää nämä vaiheet — selkeyden vuoksi useimmat valikon kohteet on jätetty pois: ![Kuva, joka näyttää, miten TeX Live -versio valitaan Overleafissa](/files/d8f3fa489807230386d8881f89fed81bd442f91b) ### Miksi vaihtaa projektin TeX Live -versio? TeX Live on suuri ja monimutkainen ohjelmistojakelupaketti, joten ei ole yllättävää, että uudet julkaisut tuovat toisinaan muutoksia, jotka estävät muutaman dokumentin onnistuneen kokoamisen. Tämä johtuu tavallisesti pakettikomentoihin vaikuttavista muutoksista, odottamattomista bugeista ja pakettien yhteensopimattomuuksista (tai “ristiriidoista”). Tässä on joitakin yleisiä syitä vaihtaa projektisi kokoamiseen käytettävää TeX Live -versiota. * **Saatat haluta uudempaa TeX Live -versiota johonkin olemassa olevaan projektiisi**. Voit siirtää projektissasi käytettävän TeX Live -version uudempaan versioon, joka tarjoaa paketin, komennon tai kieliominaisuuden, jota haluat käyttää. Ennen tätä suosittelemme kuitenkin, että projektisi kokoaminen onnistuu ilman virheitä ja että ymmärrät kaikki kääntäjän antamat jäljellä olevat varoitukset. * **Saatat haluta, että kopioitu projekti käyttää samaa TeX Live -versiota kuin alkuperäinen**. Joskus, kun teet kopion vanhasta projektista, uusia virheitä voi ilmetä TeX Livessä tapahtuneiden muutosten vuoksi. Kun näin käy, voit joko muokata projektiasi yhteensopivaksi TeX Liven uusimman version kanssa tai asettaa uuden kopiosi TeX Live -version vastaamaan sen alkuperäisen projektin versiota, josta se kopioitiin. * **Saatat tarvita Overleaf-projektissasi käytettävän TeX Live -version vastaamaan paikallisella koneellasi käyttämääsi versiota**. Jos käännät projektisi sekä paikallisesti että Overleafissa, yhdenmukaisten tulosten saamiseksi saatat haluta säätää Overleafin käyttämän TeX Live -version yhteensopivaksi paikallisesti käyttämäsi LaTeX-version kanssa. * **Saatat lähettää lehteen tai repositorioon, joka kokoaa tietyn TeX Live -version**. Jos lähetät lehteen tai repositorioon, joka käyttää tiettyä LaTeX-versiota, kokoaminen samalla tai yhteensopivalla TeX Live -versiolla Overleafissa voi auttaa välttämään virheitä lähetyshetkellä. ### TeX Liven “perinteiset” versiot Yllä olevassa kuvakaappauksessa näkyvässä TeX Live -version alasvetovalikossa vanhemmat TeX Live -versiot luokitellaan “Legacy”-versioiksi. Nämä versiot ovat saatavilla yhteensopivuuden varmistamiseksi ja vanhempien mallipohjien sekä niiden edellyttämien projektien onnistuneen kokoamisen turvaamiseksi. Tässä on joitakin lisähuomioita, jotka kannattaa ottaa huomioon harkittaessa vanhempien TeX Live -versioiden käyttöä: * Aloittaessasi uutta projektia on suositeltavaa käyttää TeX Liven uusinta versiota, elleivät tietyt yhteensopivuusongelmat tee vanhemman version käytöstä välttämätöntä. Tämä varmistaa, että hyödyt uusimmista päivityksistä ja ominaisuuksista. * Vaikka Overleaf ei ole vielä määritellyt aikataulua vanhimpien TeX Live -versioiden käytöstä poistamiselle, nämä versiot voidaan lopulta poistaa käytöstä ja ne voivat muuttua saatavuutta vailla oleviksi. * Mikäli mahdollista, olemassa olevat projektisi tulisi päivittää uusimpaan yhteensopivaan TeX Live -versioon. ## Kuinka usein TeX Live päivitetään Overleafissa? Overleafin käännöspalvelimet päivitetään TeX Liven uusimpaan julkaisuun pian sen jälkeen, kun se tulee saataville. Testauksen ja päivityksen valmistumisen jälkeen Overleaf julkaisee blogikirjoituksen, jossa kerrotaan merkittävistä TeX Live -päivityksistä sekä pakettikohtaisista huomautuksista ja ohjeista testiemme tulosten perusteella. TeX Liven “julkaisutiedot” löytyvät blogistamme käyttämällä `tex live` tunnistetta: . ### Tietoa Overleafin päivitysprosessista Ennen kuin päivitämme TeX Live -asennuksemme, kokoamme uudelleen laajan testidokumenttien joukon, mukaan lukien noin 5 000 dokumenttia mallipohjien, esimerkkien ja artikkeleiden galleriastamme, tarkistaaksemme rikkovat muutokset — mukaan lukien virheet ja kaikki merkittävät visuaaliset muutokset käännettyyn tulosteeseen. Mittaamme myös dokumenttien renderöintiin kuluvan ajan vertailun vuoksi. Tunnistamme huomattavasti hitaammat renderöinnit ja yritämme nopeuttaa niitä. Näiden testien tuloksena päivitämme tuottamiamme mallipohjia — siksi TeX Liven päivityksessä kestää joskus hetken! Toivottavasti tuloksena on kuitenkin käyttäjillemme vakaampi käyttökokemus. Testauksestamme huolimatta TeX Livessä tapahtuvat LaTeXin, TeX-moottorien tai tarvittavien fonttien ja pakettien päivitykset voivat joskus tuoda mukanaan yhteensopimattomuuksia, rikkovia muutoksia ja vanhentumisia, jotka eivät ole hallinnassamme. TeX Liven laajuuden sekä sen tarjoamien pakettien ja työkalujen runsauden vuoksi emme voi sulkea pois rikkovia muutoksia, mutta teemme parhaamme minimoidaksemme niiden vaikutuksen käyttäjiimme. ### Paketin muutokset TeX Live -julkaisujen välillä TeX-yhteisö jatkaa innovointia vuosittaisten TeX Live -julkaisujen välillä. Uusia tai päivitettyjä LaTeX-paketteja, fontteja ja TeXiin liittyvää ohjelmistoa lahjoitetaan säännöllisesti Comprehensive TeX Archive Networkiin, jota kutsutaan TeX-yhteisössä nimellä CTAN. CTAN tarjoaa keskusvaraston TeX- ja LaTeX-ohjelmistolle, joka on valmis sisällytettäväksi seuraavaan TeX Live -julkaisuun. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fi/luokkatiedostot/02-overleaf-and-tex-live.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.