diff options
author | Norbert Preining <norbert@preining.info> | 2022-01-07 03:01:08 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-01-07 03:01:08 +0000 |
commit | f69513397ac0e1f02c6b4a5f50588d411413271a (patch) | |
tree | bfc0fc24255cb74e53aab1a6e7ac644f2952b9af /info/kaytannollista-latexia/README.md | |
parent | 55032f1ad7128dcf6493e798424f4ade02c923a7 (diff) |
CTAN sync 202201070301
Diffstat (limited to 'info/kaytannollista-latexia/README.md')
-rw-r--r-- | info/kaytannollista-latexia/README.md | 74 |
1 files changed, 34 insertions, 40 deletions
diff --git a/info/kaytannollista-latexia/README.md b/info/kaytannollista-latexia/README.md index 37a7b60035..db39cb7443 100644 --- a/info/kaytannollista-latexia/README.md +++ b/info/kaytannollista-latexia/README.md @@ -20,35 +20,39 @@ perusasiat. Opas sisältää käytännönläheiset ohjeet esimerkiksi dokumentin sivu-, fontti- ja kieliasetusten tekemiseen. Se sisältää teknisiä ohjeita ja typografisia vinkkejä tavallisimpiin tekstidokumentin kirjoittamisen tarpeisiin. Oppaan avulla pitäisi -pärjätä niin hyvin, että makropakettien ohjeita tarvitsee lukea vain +pärjätä niin hyvin, että laajennuspakettien ohjeita tarvitsee lukea vain harvoin. Edellisessä kappaleessa mainostettu nykyaikaisuus tarkoittaa esimerkiksi sitä, että tässä oppaassa keskitytään Open Type -fontteihin, Unicode-merkistöön ja PDF-tiedostoihin. Latexin vanha fonttitekniikka -sivuutetaan, eikä merkistörajoitusten kanssa enää kamppailla. Oppaan -ohjeet siis sopivat nykyaikaiselle tietokoneen käyttäjälle. +sivuutetaan, eikä kummallisten fonttitiedostojen ja merkistörajoitusten +kanssa kamppailla. Oppaan ohjeet siis sopivat nykyaikaiselle tietokoneen +käyttäjälle. Saatavuus --------- -Oppaasta on saatavilla valmiiksi ladottu PDF-tiedosto Githubissa -[julkaisusivulla](https://github.com/tlikonen/latex-opas/releases). Myös -Latex-lähdetiedostot ovat saatavilla Githubissa osoitteessa -<<https://github.com/tlikonen/latex-opas>>. +Oppaan PDF-tiedosto ja lähdetiedostot ovat saatavilla +[CTAN][CTAN]-arkistossa. PDF-tiedosto on myös Githubissa +[julkaisusivulla](https://github.com/tlikonen/latex-opas/releases), ja +lähdetiedostot ovat versionhallintajärjestelmässä [Githubissa][Github]. + +[CTAN]: https://ctan.org/pkg/kaytannollista-latexia +[Github]: https://github.com/tlikonen/latex-opas Versionumerointi ---------------- -Oppaan versionumerot tulevat julkaisuajan vuosiluvusta sekä -mahdollisesti kuukaudesta ja päivästä. Vuoden ensimmäinen tai ainoa -julkaisu saa versionumeronsa pelkästä vuosiluvusta, esimerkiksi versio -”2022”. Jos samana vuonna julkaistaan oppaasta uusi versio, lisätään -versionumeroon kyseisen kuukauden numero, esimerkiksi versio ”2022.4” -(huhtikuu 2022). Saman kuun aikana toinen julkaisu saa versionumeroonsa -vielä päivänkin numeron, esimerkiksi ”2022.4.15” (15. huhtikuuta 2022). +Versionumerot tulevat julkaisuajan vuosiluvusta sekä mahdollisesti +kuukaudesta ja päivästä. Vuoden ensimmäinen tai ainoa julkaisu saa +versionumeronsa pelkästä vuosiluvusta, esimerkiksi versio ”2022”. Jos +samana vuonna julkaistaan oppaasta uusi versio, lisätään versionumeroon +kyseisen kuukauden numero, esimerkiksi versio ”2022.4” (huhtikuu 2022). +Saman kuun aikana toinen julkaisu saa versionumeroonsa vielä päivänkin +numeron, esimerkiksi ”2022.4.15” (15. huhtikuuta 2022). Tekijänoikeus ja lisenssi @@ -80,41 +84,30 @@ tarkoitukseen, myös kaupallisesti. Ehdot ovat seuraavat: Kääntäminen ja asentaminen -------------------------- -Oppaan Latex-lähdetiedostojen kääntäminen eli latominen PDF-dokumentiksi -vaatii useita Latexin makropaketteja ja pari fonttia. Latexin -jakelukokonaisuus [Texlive](https://tug.org/texlive/) sisältää kaiken -tarvittavan. Esimerkiksi [Debian](https://www.debian.org) Linux --käyttöjärjestelmässä asennuspaketti `texlive-full` asentaa koko -Texliven. - -Oppaan voi latoa julkaisupaketin ja asennettujen tiedostojen avulla tai -versionhallinnan tiedostojen pohjalta. - +Latex-lähdetiedostojen kääntäminen eli latominen PDF-dokumentiksi vaatii +useita Latexin makropaketteja ja pari fonttia. Latexin jakelukokonaisuus +[Texlive](https://tug.org/texlive/) sisältää kaiken tarvittavan. +Esimerkiksi [Debian](https://www.debian.org) Linux -käyttöjärjestelmässä +asennuspaketti `texlive-full` asentaa koko Texliven. -### Julkaisupaketti - -Oppaan julkaisupaketin lähdetiedostot voi latoa PDF-tiedostoksi -komennoilla `lualatex` ja `biber`. Komennot täytyy suorittaa seuraavassa -järjestyksessä: +[CTAN][CTAN]-arkistossa julkaistut lähdetiedostot käännetään +PDF-tiedostoksi komennoilla `lualatex` ja `biber` seuraavasti: lualatex -shell-escape kaytannollista-latexia biber kaytannollista-latexia lualatex -shell-escape kaytannollista-latexia lualatex -shell-escape kaytannollista-latexia - -### Versionhallinta (Git) - -Git-versionhallintajärjestelmässä säilytettävä opas sisältää tiedoston -`Makefile`, joka puolestaan sisältää kääntämisohjeet `make`-komennolle. -PDF-tiedoston saa ladottua yhdellä komennolla: +[Git][Github]-versionhallintajärjestelmässä säilytettävä opas sisältää +tiedoston `Makefile`, joka puolestaan sisältää kääntämisohjeet +`make`-komennolle. PDF-tiedoston saa ladottua yhdellä komennolla: make Kääntämisessä syntyneen PDF-tiedoston voi siirtää haluamaansa paikkaan käyttöä varten. Oppaan voi myös asentaa Texin standardiin -hakemistorakenteeseen, josta muut ohjelmat voivat sen löytää. Se tehdään -seuraavalla komennolla: +hakemistorakenteeseen, josta muut ohjelmat voivat sen löytää. Sen voi +tehdä seuraavalla komennolla: make install @@ -122,10 +115,10 @@ Edellisen asennuskomennon voi suorittaa ilman erillistä kääntämisvaihettakin, koska ennen asentamista se varmistaa, että tarvittavat tiedostot on käännetty. Asennuskohde on käyttäjän kotihakemistossa eli polussa `$HOME/texmf`. Kohteeseen asentuu paitsi -oppaan PDF-tiedosto myös Latexin lähdetiedostot ja tämä käsillä oleva +oppaan PDF-tiedosto myös lähdetiedostot ja tämä käsillä oleva `README.md`. Asentamisen jälkeen esimerkiksi Texliveen sisältyvä komento `texdoc` osaa löytää ja avata oppaan, kun komennolle antaa argumentiksi -joitakin oppaan nimen kirjaimia, esimerkiksi `texdoc kaytannoll`. +joitakin oppaan nimen kirjaimia, esimerkiksi `texdoc kaytann`. Asennus poistetaan komennolla `make uninstall`. Komento tosin säilyttää polun `$HOME/texmf`, koska siellä voi edelleen sijaita muita Texiin ja @@ -143,11 +136,12 @@ poistaa kaikki syntyneet tiedostot. Puutteita ja suunnitelmia ------------------------- + - Lisätään biblatex-lukuun päiväysten muuttaminen (mm. urldate). - Lisätään Muuta tekniikkaa -luku, jonka sisällöksi esimerkiksi: päiväykset ja kellonajat (datetime2), textpos-paketti, omien makropakettien ja dokumenttiluokkien tekeminen. - Marginaalihuomautusluvussa voisi mainita `\marginpar`-komennon puutteet ja vaihtoehdon `marginnote`. - - Mahdollisesti käsitellään wrapfig-paketti. + - Mahdollisesti käsitellään wrapfig-paketti (myös wrapfig2). - Uusi `fi-x-school`-tavutuskaava. - Mittojen käsittelyn yhteydessä voisi käsitellä calc-paketin. |