summaryrefslogtreecommitdiff
path: root/info/kaytannollista-latexia/README.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-01-07 03:01:08 +0000
committerNorbert Preining <norbert@preining.info>2022-01-07 03:01:08 +0000
commitf69513397ac0e1f02c6b4a5f50588d411413271a (patch)
treebfc0fc24255cb74e53aab1a6e7ac644f2952b9af /info/kaytannollista-latexia/README.md
parent55032f1ad7128dcf6493e798424f4ade02c923a7 (diff)
CTAN sync 202201070301
Diffstat (limited to 'info/kaytannollista-latexia/README.md')
-rw-r--r--info/kaytannollista-latexia/README.md74
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.