avoimet-oppimateriaalit-ry-arkisto / oppikirjamaraton-maa1 Goto Github PK

Nyt sisältö-hakemisto on kahdesti. Luultavasti ääkköset kahdella eri merkistökoodauksella tms. Ääkkösten käyttö tiedostonimissä on huono idea ylipäätään. Yhä.

Näinden -> Näiden
aapo@dc93fb2

Kuvia puuttuu vielä paljon. Piirretään ja lisätään.

Luvun 2 (Kokonaisluvut) lukujat ovat hiukan vaikeaselkoisia ja niissä on vääränlaisia plus- ja miinusmerkkejä.

Lukujanoja voisi selkeyttää tekemällä jokaiselle luvulle oman lukujanan.

Esim. 5-(-8):
Lukujanat luvuille 5, -8, -(-8) ja 5-(-8)

aapo@053884e

Poistaa tämän varoituksen:

LaTeX Warning: You have requested package `config/oppikirjamaraton',
           but the package provides `oppikirjamaraton'.

Kuinka latex tiedostoista leivotaan pdf-kirja? Mitä pitää olla asennettuna ensin?
Jotakin: asenna git ja latex

Tässä Ubuntua varten mitä pitää olla asennettuna:

#Tämän hetkisessä Ubuntu 12.04-versiossa on liian vanha tex (siitä puuttuu mdframed.sty)
#Ota Ubuntu 12.04:ään käyttöön (Lokakuussa 2012 tulevan) Ubuntu 12.10:n tex.
sudo add-apt-repository ppa:texlive-backports/ppa
sudo apt-get update

#Tarvittavien ohjelmien asennus Ubuntuun:
sudo apt-get install git texlive-latex-base texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended texlive-lang-finnish

(texlive-latex-recommended tarvitaan ntgclass:in takia.
texlive-latex-extra tarvitaan blindext.sty:a varten
texlive-fonts-recommended tarvitaan eurosym.sty varten
texlive-lang-finnish tarvitaan suomen kielen tavutuksia varten )

Lisäksi cmbright fontin takia pitää asentaa sudo apt-get install texlive-fonts-extra cm-super (yhteensä yli 500MB).

Kirjan latominen:

git clone https://github.com/linjaaho/oppikirjamaraton-maa1.git
cd oppikirjamaraton-maa1/sisalto/
pdflatex kirja.tex
pdflatex kirja.tex

(pdflatex ajetaan kahteen kertaan, jotta menee sisäiset viitteet varmasti oikein)

Alun lukujärjestelmissä ei ollut lainkaan soveltavaa osuutta. Oliko tarkoitus vain kerrata vai keksiä tehtäviäkin? En ole ihan kärryillä ykköskurssin osaamistavoitteista.

Eniveis, itse tykkään lasketuttaa esimerkkejä 8-kantajärjestelmässä ja perustella sen sillä, että melkein kaikilla piirroshahmoilla on 4 sormea/käsi --> Ankkalinnassa ja muualla käytetään selkeästi 8-kantajärjestelmää.

Vaikka yksittäiset tehtävät eivät ylitä teoskynnystä, on hyvän kirjallisen tavan mukaista ilmoittaa kirja lähdeluettelossa, jos kirjasta on otettu yksikin tehtävä (kaikki eivät näin tee, mutta pyritään silti olemaan kilttejä).

Täysin väritön versio mustavalkotulostusta varten.

Kommentti oli odottamassa footnoteen menoa: aapo@4f82135

Lähdekoodissa näyttäisi olevan käytetty paljon käskyä \frac. Kannattaisiko nuo vaihtaa \dfraceihin ja \tfraceihin tapauskohtaisesti?

Pitäisikö muista kirjoista kopioituihin tehtäviin laittaa viitteet kirjoihin, joista tehtävät ovat peräisin? Esimerkiksi tehtävänannon loppuun "(Pyramidi I, s. 48)" tms. Tästä olisi ainakin kolme hyötyä:

i) Lisääntynyt "läpinäkyvyys". Käsittääkseni ylivoimainen enemmistö kirjan tehtävistä on omia, mutta tällä hetkellä se ei välttämättä välity lukijalle, joka tietää vain, että ainakin jokin osa tehtävistä (saattaa) olla kopioituja.

ii) Mahdollisuus kopioitujen tehtävien korvaamiseen omilla. Kopioiduista tehtävistä voitaisiin näin päästä hiljalleen eroon, jos halutaan.

iii) Krediitin antaminen tehtävän alkuperäiselle laatijalle, vaikkei laki tähän velvoitakaan.

Tällä hetkellä ainakin osaan kopioiduista tehtävistä on tehtävän yhteyteen LaTeX-koodin kommenttiin merkitty, mistä tehtävä on peräisin, mutta en tiedä, onko kaikkiin. Muutosta voi siis olla käytännössä hieman hankalaa toteuttaa.

Ei varmaan iso juttu -> korjataan.

Lause "Kokonaisluku erotetaan loppuosasta desimaalierottimella, joka on Suomessa
pilkku (,)." olisi hyvä muuttaa muotoon

"Kokonaisluku erotetaan loppuosasta desimaalierottimella, joka on suomen kielessä
pilkku (,).", koska Suomessa käytetään myös vaikkapa C++:aa, jossa erotin on piste.

Luvun 8 ensimmäisessä kuvassa on käytetty desimaalipistettä.

Luvun 8 ensimmäisessä kuvassa on käytetty desimaalipistettä, vaikka pitäisi olla pilkku. Lauri, ehditkö?

Työstä on kiva saada palkka muodossa tai toisessa. Näin informaatio-ajan aikakaudella ansaintamallit ovat heittäneet häränpyllyä, vanhat eivät enää toimi.

Esimerkki, miten open source-maailmassa voidaan järjestää tuloja työn raskaan raatajille: https://www.gittip.com/

Eli ihmiset voivat säätää lahjoituksia hyviksi katsomilleen ohjelmoijille. Samantyylinen järjestelmä voisi toimia myös avoimen oppikirjan toteuttamisessa.

Gittipin ongelma on kuitenkin se, että maksut toimivat vain jenkeissä. Olen ajatellut kehittää vastaavan toimimaan Bitcoin-maksuilla. Löytyykö tällaiseen kiinnostusta?

Kaksoispisteet poistettu tehtävänantojen lopusta.
aapo@c275d58

Tällaisia oli muutamia. Huomattavasti yleisempi linjaus oli pelkkä piste.

"Sievennä:" => "Sievennä."
jne

"Selailin kirjan versiota 0.9 ja hienolta näyttää! Yhden virheen/typon taisin bongata eli luvussa 15 tutkitaan funktiota f(x) = \frac{1}{x-1}. Arvojoukoksi väitetään koko reaalilukujen joukkoa, kun taitaa olla R \setminus { 0 } eli nolla ei kuulu arvojoukkoon." Kiitos Jani

luotevaa => luontevaa.
aapo@5c6cce7

Lauseessa on silti jotain hassua vielä.

Näitä on tekstissä jonkin verran:

"ei ole jaollinen 5:llä"
VS
"ei ole jaollinen luvulla 5"

Onhan tiimi sitä mieltä, että alempi on parempi?

Löytyvätten:

egrep ':lla|:llä|:sta|:stä|:hen|:tä' */*.tex

toteutaa => toteuttaa
aapo@bc593b2

Joku voisi tehda ylimaaraisen liitteen kirjalle (esim. lisatehtavat.tex samalla kappalejaolla), jota ei kaanneta samaan PDF-tiedostoon (kirja alkaa olla jo suht paksu sivumaaraltaan). Tyypillisesti lukion kirjoissa on harvoin kovin haastavia tehtavia lahjakkaimmille opiskelijoille, joten olisi hyva saada naita oppikirjaan.

Minulta ei loydy skandein varustettua nappaimmistoa, joten on vaikea itse kirjoittaa mitaan suomeksi. Keraisin toisaalta mielellani haastavia tehtavia jokaista kappaletta varten, jotka joku voisi suomeksi kaantaa. Loistava lahde on amerikkalaisten AMC10-12 seka AIME matematiikkakilpailut, joiden kaikki tehtavat loytyvat joko netista tai yliopistoni kirjastosta.

Keraisin siis mielellani naita kasaan, koska vaatii jonkun verran vaivaa selvitella mitka ovat ratkaisumenetelmiltaan taman kurssin kannalta oleellisia. Joku muu voisi taas hoitaa naiden kaantamisen suomeksi jahka saan kasaan listan naista tehtavista. Varmaan MAOL:n kilpailuista loytyisi myos loistavia kandidaatteja.

Loytyyko tata varten kiinnostusta?

Kappaleesta 01-luvut/06-juuret.tex löytyy tämmöinen

\laatikko{
{\bf $n$:s juuri}

Luvun $a$ $n$:s juuri on epänegatiivinen luku, jonka $n$:s potenssi on $a$. Tämä voidaan ilmaista myös $
(\sqrt[n]{a})^n=a$.}

Luvun a n:s juuri ei kyllä aina ole epänegatiivinen, kuten laatikkoa edeltävä kappale selittää. Kenties koko laatikon voi poistaa?

Jos tietää mitä aritmetiikan peruslause sanoo, niin 'kertolaskun järjestyksen' ymmärtää. Mutta 'kerrottavien termien järjestystähän' siinä haetaan: aapo@658e3c8

Saako sanaa 'termi' käyttää jo tässä vaiheessa? (01-luvut/02-kokonaisluvut)

Vai olisiko parempi jotenkin "kertolaskujen järjestysten..."?

Bugi kirjassa: Lainausmerkin jälkeinen välilyönti puuttuu. Selitys: Lainausmerkki on erikoismerkki: http://www.cs.tut.fi/~jkorpela/softa/latex.html

Korjaus: aapo@3dee209

Virheelliset löytyi tällä:

grep \" ./*/*.tex

Kirjassa on selkeasti esilla kaikki tarkeimmat laskusaannot, mutta pedagogisesti voisi olla ihan hyva myos kerata selvasti nakyviin bokseihin tavallisimmat virheet, kuten

(a+b)/(a+c) != b/c

Tama kaytanto on esim. Art of Problem Solvingin tuottamissa amerikkalaisissa oppikirjoissa kaytossa ja voi olla ihan jarkevaa tuoda tammoiset asiat myos selkeasti esille.

Näyttää kirjoitusvirheeltä.
Lisäsin sille myös kursivoinnin (emph).
Ja heti perään toinen termi, joka tuntui myös kaipaavan kursivointia.
Ja juuri kahdeksan riviä aiemmin on jo sanottu

 kutsutaan \emph{kymmenjärjestelmäksi} 

Yhdistin toisiinsa:
aapo@fd8f5ec

Voi sotkea liikaa (tästä keskusteltiin paikan päällä). Vältetään uusia hankalan kuuloisia termejä ainakin ykköskurssilla.

"Taulutelevision kooksi (halkaisijaksi) ..."
Television koko ilmoitetaan lävistäjän pituudella (joka selvinnee myös tehtävää tekemällä). Voiko suorakaiteen lävistäjää kutsua halkaisijaksi?

Suorakaiteen halkaisijaksi sopisi kaiketi mikä tahansa jana joka kulkee suorakaiteen keskipisteen kautta.

Siistissä versiossa siis todot ja muut turhat piilossa, kaikki muutenkin paikallaan. Oikolukuversiossa todot näkyvillä, vastaukset heti tehtävien jälkeen jne.

Good job everyone!

Can we get an english translation started?

En edes ota kantaa kumpi on oikeampia pizza vai pitsa, mutta voisi valita noista vain toisen.
(https://fi.wiktionary.org/wiki/pizza "pitsa on kielitoimiston suosittelema kirjoitusasu"
toisaalta https://fi.wikipedia.org/wiki/Pitsa -> https://fi.wikipedia.org/wiki/Pizza )

pitsa=8, pizza=2

egrep 'pizza|pitsa' 01-luvut/* -n
01-luvut/03-rationaaliluvut.tex:113:        Salamipitsa jaetaan kuuteen ja tonnikalapitsa neljään yhtä suureen
01-luvut/03-rationaaliluvut.tex:114:        siivuun. Vesa saa kaksi siivua salamipitsaa ja yhden siivun tonnikalapitsaa.
01-luvut/03-rationaaliluvut.tex:115:        Minttu saa kaksi siivua tonnikalapitsaa. Kumpi saa enemmän pitsaa, jos
01-luvut/03-rationaaliluvut.tex:116:        molemmat pitsat ovat saman kokoisia?
01-luvut/03-rationaaliluvut.tex:123:        pitsan kokonaismäärän laskemista varten laventaa niin, että
01-luvut/03-rationaaliluvut.tex:125:        Vesan saama määrä pizzaa on
01-luvut/03-rationaaliluvut.tex:133:        Mintun saama määrä pizzaa on

Ultimaalinen ajatukseni (utopiani) on, että valmiin kirjan voi vetää automaattiselle kielen tarkistusohjelmalle, joka menee puhtaasti läpi.
Helpoin on kirjoitusvirheiden tarkistus, mutta kielioppikin voisi olla mahdollinen.

Tein wikiin ohjeen (työkalujen asennus ubuntu-specifisesti):
https://github.com/linjaaho/oppikirjamaraton-maa1/wiki/Ohjeita-tietokoneavusteiseen-oikolukuun

Tarvitsee kaksi aputiedostoa:
aapo@a79f557

Vaiheet:

1. pdf muutetaan tekstiksi
2. teksti pilkotaan yksi sana per rivi (välimerkit poistaen)
3. voikko tarkistaa sanalistan. otetaan hälyttävät sanat talteen
4. poistetaan hälytyksistä tunnetut nimet+englanti+ruotsi+latina+jne

Lopullisen listan pitäisi olla tyhjä (nyt se on 112 sanaa). Jokaiselle sanalle pitää valita:

• korjaa kirjoitusvirhe (valillä)
• mieti voikon tietokantaan lisäämistä (tekijöihinjako) [ http://joukahainen.puimula.org/ehdotasanoja ]
• lisätä tunnettujen poikkeusten joukkoon (Oppikirjamaraton-tiimi)
• kaavojen perässä olevat "llä" jne [ https://github.com/linjaaho/oppikirjamaraton-maa1/issues/57 ]

pythagoraan -> Pythagoraan
aapo@4dc775f

Kuvien 'lähdekoodi' löytyy siis geogebra-formaatissa (ggb) sekä Latex-tikz -muodossa (txt) hakemiston kuvia/oppikirjamaraton/ alta. Näistä on valmiiksi genereoitu pdf-tiedostot. 1) en kuitenkaan saa aivan samannäköisiä pdf-tiedostoja aikaiseksi pelkällä pdflatexilla, kuinka ne on tehty?

Lisäksi joistakin kuvista löytyy -cropped versio, esim sisalto/01-luvut/kuvia/5plusmiinus8onmiinus3-crop.pdf (tämä on se tiedosto jonka 01-luvut/02-kokonaisluvut.tex includoi). 2) onko cropped tehty käsin? Kuinka sen voisi tehdä ohjelmallisesti?

3. Onko latominen liian hidasta, jos includoisi noita tikz-tiedostoja, eikä valmiita pdfiä?
4. Voisiko olla scripti (tai ihan oikea Makefile) joka tekisi tikz-tiedostoista pdft (ja suorittaisi mahdolliset cropit)?

Muutama esigeneroitu kuva-pdf on rikki. Aiheuttavat varoituksen latoessa, ja tuottavat ainakin joltain osin rikkinäisen lopputuloksen (esim pdftotext huomauttaa).
Virhe näyttää tältä:

<01-luvut/kuvia/5miinusplus8onmiinus3-crop.pdf, id=80, 614.295pt x 794.97pt>
<use 01-luvut/kuvia/5miinusplus8onmiinus3-crop.pdf>
Underfull \vbox (badness 5548) has occurred while \output is active [16 <./01-luvut/kuvia/5plus8on13-crop.pdfError (15575):
Illegal character ')'
Error (15575): Missing 'endstream'

Nämä lienevät virheelliset tiedostot:

\includegraphics[scale=0.5]{01-luvut/kuvia/5plus8on13-crop.pdf}
\includegraphics[scale=0.5]{01-luvut/kuvia/5plusplus8on13-crop.pdf}
\includegraphics[scale=0.5]{01-luvut/kuvia/5plusmiinus8onmiinus3-crop.pdf}
\includegraphics[scale=0.5]{01-luvut/kuvia/5miinusmiinus8on13-crop.pdf}

Ettei yhden tehtävän lisääminen heitä koko kirjan numerointia eteenpäin.

Katso näyttääkö paremmalta/kannattaako ottaa käyttöön.

Kannattaisiko kirjassa määritellä laskutoimitus? Suurin yllätykseni yliopistossa algebran kurssilla, että laskutoimitus on tarkasti määritelty matemaattinen termi ja vaikkapa reaalilukujen jakolasku tai neliöjuuri ei ole laskutoimitus.

luku 7:

• Esmerkiksi -> Esimerkiksi
• "Potenssin potenssin kaavaa on luotevaa myös ajatella käyttäen, että esimerkiksi" ... kaksi potenssia ja luotevaa. Lause tuntuu muutenkin oudolta, mutta en keksi parempaakaan.
• Näinden -> Näiden
  -määrittelyst

luku 8:

• toistuvua -> toistuvia

luku 10:

• yhtäöesimerkkejä -> yhtälöesimerkkejä
• "joku ihan kehari esimerkki tuntemattomista" .. kehari? Vaikka onkin kyse ilmeisesti TODO kommentista, niin tuota lausetta voisi parantaa. Esimerkiksi minä en ymmärrä mitä kehari tarkoittaa tuossa yhteydessä.

luku 17:

• määärä -> määrä

luku 22.

• otetan -> oteta
• lopullinenosuus -> lopullinen osuus

"Merkitään" on matemaattisempi ilmaus:
aapo@0e29174

Kirjoitusvirheet:
Luku 1:

• merkkittävä -> merkittävä
• kirjoitaa -> kirjoittaa
• erilaisa -> erilaisia

Nämä näin malliksi. Olisi hyvä ehkä jonkun katsoa koko teksti oikolukuohjelmalla läpi. Vapaa sellainen (mikä nämäkin virheet löysi) löytyy osoitteesta:
http://voikko.sourceforge.net/

Lisäksi luvussa kahdeksan on lause, mikä vaikuttaa oudolta:
"Pelkästään yhteen- ja vähennyslaskua sisältävässä lausekkeessa laskujärjes-
tystä voi vaihtaa vapaasi, kun ajattelee miinusmerkin liikkuvan kuuluvan sitä
seuraavaan lukuun ja liikkuvan sen mukana." ... liikkuvan kuuluvan?

käyttettäessä -> käytettäessä

Lisäksi puuttuu yksi 'ei'.

--- a/sisalto/01-luvut/07-murtopotenssi.tex
+++ b/sisalto/01-luvut/07-murtopotenssi.tex
@@ -38,7 +38,7 @@ laskusäännöt ovat sellaisenaan voimassa myös niille. Esimerkiksi kaavat
 \[ a^q\cdot a^q = a^{p+q}, \quad (a^p)^q = a^{pq}, \quad (ab)^q=a^qb^q \]
 pätevät kaikille rationaaliluvuille $p$ ja $q$.  Näiden kaavojen todistukset on esitetty liitteessä \ref{pot_todistukset}.

-{\bf Huomautus määrittelyjoukosta}. Murtopotenssimerkintää käyttettäessä vaaditaan, että $a\geq 0$ myös silloin, kun $n$ on pariton. Syy tähän on seuraava. Esimerkiksi $\sqrt[3]{-1}=-1$, koska $(-1)^3=-1$, mutta lauseketta $(-1)^\frac{1}{3}$ ole tällöin määritelty. Murtopotenssimerkinnän määrittelystä voi tällöin seurata yllättäviä ongelmia:
+{\bf Huomautus määrittelyjoukosta}. Murtopotenssimerkintää käytettäessä vaaditaan, että $a\geq 0$ myös silloin, kun $n$ on pariton. Syy tähän on seuraava. Esimerkiksi $\sqrt[3]{-1}=-1$, koska $(-1)^3=-1$, mutta lauseketta $(-1)^\frac{1}{3}$ ei ole tällöin määritelty. Murtopotenssimerkinnän määrittelystä voi tällöin seurata yllättäviä ongelmia:
 \[
  -1 = \sqrt[3]{-1} = (-1)^\frac{1}{3} = (-1)^\frac{2}{6}
 = ((-1)^2)^\frac{1}{6} = 1^\frac{1}{6} = \sqrt[6]{1} = 1.

Funktio maaritellaan kirjassa seuraavasti:

"Funktio f(x) liittaa muuttujaan x arvon f(x)."

Tama on niita asioita, joita 1. vuoden matikan opiskelijoille toitotetaan, ts. itse funktiota merkitaan vain kirjaimella f, kun taas funktion arvoa pisteessa x merkitaan f(x):lla. En tieda onko tassa tarkoitus olla laiska, kun kyseessa on lukiotasoinen oppikirja ja lukiossa muistan opettajani aina kirjoittaneen "f(x)"

Myohemmassa esimerkissa kaytetaan kuitenkin kirjoitusasua:

"Maaritellaan funktio f lausekkeella f(x)=1/(x-1)"

Saman esimerkin ratkaisu kuitenkin alkaa taas:

"Funktio f(x) on maaritelty..."

Eli tassa pitaisi tehda valinta sen suhteen kuinka funktiota kuuluisi merkita... Tyypillisesti matemaatikot vain kirjoittavat "f".

Testattava, että toimii paperilla, tykillä ja näytöllä eikä haaskaa liikaa väriä.

Kirjoitusvirhe, puuttuva a-kirjain:
aapo@dba9672

Ks. otsikko.