Läsnäolon voima -kirjan harjoitukset. Eräänlaiset muistiinpanot Tekijä: Juhapekka ”naula” Tolvanen Dokumentin kotisivu: http://iki.fi/juhtolv/tolleharj/ Tekijän kotisivu: http://iki.fi/juhtolv Sähköposti: juhtolv (at) iki (dot) fi ########################################################################### Etkö saa tolkkua kaikista näistä tiedostoista? Kerronpa tärkeimmistä tiedostoista, mitä tässä hakemistossa on: juhtolv_tolle_harjoitukset.html avautuu suoraan WWW-selaimeesi, eli se on WWW-sivu. juhtolv_tolle_harjoitukset.epub on EPUB-formaatissa (versio 2.*) ja se sopii monille e-kirjojen lukulaitteille, mutta ei Amazon Kindlelle. juhtolv_tolle_harjoitukset.epub3.epub on muuten sama kuin juhtolv_tolle_harjoitukset.epub , mutta se on EPUB-formaatin version 3 mukainen. juhtolv_tolle_harjoitukset.mobi sopii mille tahansa Amazon Kindlelle. juhtolv_tolle_harjoitukset.azw3 sopii uudemmille Amazon Kindle -malleille. juhtolv_tolle_harjoitukset.plain.txt on pelkkä tekstitiedosto, jonka merkistö on Unicode ja sen koodaus on UTF-8. juhtolv_tolle_harjoitukset.plain40.txt on muuten sama kuin juhtolv_tolle_harjoitukset.plain.txt, mutta se on niin kapea, että se sopii luettavaksi jopa näytöllä, johon mahtuu leveyssuunnassa vain 40 merkkiä. Itse haluan käyttää sitä Nintendo DS Liten homebrew-ohjelmassa nimeltä Moonshell, mutta saattahan se olla luettavissa jopa jollain älypuhelimilla. juhtolv_tolle_harjoitukset.pdf on PDF-tiedosto, joka sopii printattavaksi. Sen fonttikoko on 10 pistettä. juhtolv_tolle_harjoitukset.12pt.pdf on muuten sama kuin juhtolv_tolle_harjoitukset.pdf , mutta siinä on fonttikoko 12 pistettä. juhtolv_tolle_harjoitukset.twoside.pdf on PDF-tiedosto, joka sopii printattavaksi kaksipuoleisella tulostuksella. Sen fonttikoko on 10 pistettä. juhtolv_tolle_harjoitukset.twoside.12pt.pdf on muuten sama kuin juhtolv_tolle_harjoitukset.twoside.pdf , mutta siinä on fonttikoko 12 pistettä. juhtolv_tolle_harjoitukset.landscape.pdf on PDF-tiedosto, joka sopii luettavaksi näytöltä (landscape-moodissa ja zoomausasetuksella ”Sovita koko sivu” tms.), mutta suosittelen siihen tarkoitukseen mieluummin jotain tiedostoformaattia, joka voidaan vapaasti rivittää uudestaan ja jossa voi fontin ja fonttikoon valita katseluohjelmassa tai -laitteessa, kuten HTML:ää tai sähköisten kirjojen formaatteja, kuten EPUB- tai MOBI-formaattia. Sen luettavuus on kokeilemalla varmistettu sähköisten kirjojen lukulaitteella nimeltä Bookeen Cybook Opus, jonka resoluutio 200 dpi ja jonka näytössä on 600×800 pikseliä. Tässä PDF-tiedostossa sivumäärä on kaikkein suurin. juhtolv_tolle_harjoitukset.woodeneye.pdf on muuten samanlainen kuin juhtolv_tolle_harjoitukset.landscape.pdf , mutta sitä on tarkoitus katsella vieläkin hankalammissa olosuhteissa ja ympäristöissä kuin tiedostoa nimeltä juhtolv_tolle_harjoitukset.landscape.pdf : Se on tehty portrait -moodissa ja sitä on tarkoitus katsella zoomausasetuksella ”Sovita leveys” tms. ja siinä on fonttien peruskoko todella iso. Fontitkin on valittu sellaisiksi, että heikkonäköisempikin saa niistä selkoa. Mutta jos suinkin vaan voit, käytä mieluummin jotain tiedostoformaattia, joka voidaan vapaasti rivittää uudestaan ja jossa voi fontin ja fonttikoon valita katseluohjelmassa tai -laitteessa, kuten HTML:ää tai sähköisten kirjojen formaatteja, kuten EPUB- tai MOBI-formaattia. ########################################################################### Nämä tiedostopäätteet tarkoittavat, että kyseiset tiedostot on pakattu jollain pakkausohjelmalla: - .7z - .bz2 - .gz - .lz - .xz - .zip Kaikista niistä löytyy lisätietoa Wikipediasta. Sieltä löytyy myös tietoa ohjelmista, joilla nuo pakatut tiedostot saa purettua. https://en.wikipedia.org/wiki/7z https://en.wikipedia.org/wiki/P7zip http://en.wikipedia.org/wiki/Bzip2 http://bzip.org/ https://en.wikipedia.org/wiki/Gzip http://www.gzip.org/ https://www.gnu.org/software/gzip/ https://en.wikipedia.org/wiki/Lzip https://www.nongnu.org/lzip/lzip.html https://en.wikipedia.org/wiki/Xz https://en.wikipedia.org/wiki/XZ_Utils https://en.wikipedia.org/wiki/Zip_%28file_format%29 Tässäpä Windows-käyttäjille kätevä pakkaus- ja purkuohjelma, joka osaa purkaa melkein kaiken: https://en.wikipedia.org/wiki/7-Zip http://www.7-zip.org/ MacOS X-käyttäjille taas suosittelen tätä: http://en.wikipedia.org/wiki/The_Unarchiver http://unarchiver.c3.cx/ Käyttämistäni pakkausformaateista Lzip (tiedostopääte .lz) on ainoa, jolle en ole löytänyt MacOS X:ssä tai Windowsissa toimivaa graafista purkuohjelmaa. Nuo edellämainitut kaksi graafista ohjelmaa osaavat kyllä purkaa kaikkia muita käyttämiäni pakkausformaatteja. Alkuperäistä lzip-komentoriviohjelmaa on toki mahdollista käyttää Windowsissa (jos Cygwin on asennettuna) ja MacOS X:ssä. Ei, en tarjoa RAR:rilla pakattuja tiedostoja, koska ohjelmat joilla voidaan tuottaa tuota pakkausformaattia, ovat epävapaita ja lähdekoodiltaan suljettuja ohjelmia. ########################################################################### Siinä tärkeimmät. Muista tiedostomuodoista löydät tietoa näin: Kaikissa pakkaamattomissa tiedostoissa, joissa tiedostonnimen pääte on ”.sh”, ”.conf” tai ”.sty” on siihen tiedostonnimen perään lisätty ”.txt”. jotta WWW-selaimet voisivat näyttää sen suoraan, aivankuin se olisi mikä tahansa pelkkää tekstiä oleva tiedosto. juhtolv_tolle_harjoitukset.txt on se lähdekooditiedosto, johon itse dokumentti on alunperin kirjoitettu kevytmerkkauskielellä nimeltä ReStructuredText ja tasan yhden ainoan kerran. Kaikki muut tiedostomuodot on siitä tehty kääntämällä tai konvertoimalla – joko suoraan tai välivaiheiden kautta – compileall.sh-skriptillä. Jokaisesta tiedostosta, jonka tiedostonnimen pääte on ”.tex”, syntyy xelatex-komennolla tiedosto, jonka tiedostonnimi on muuten sama, mutta sen pääte onkin ”.pdf”. Tiedosto compileall.sh on Bourne Shell -kielinen shelliskripti. Sen kommenttiriveillä on URL:it WWW-sivuihin, joissa kerrotaan lisätietoa jokaisesta mahdollisesta tiedostoformaatista, jotka se skripti tuottaa ja jokaisesta mahdollisesta ohjelmasta, joita se skripti käyttää tuottaakseen noita tiedostoformaatteja. Kommenttirivejä ovat siis sellaiset rivit, joiden alussa on #-merkki. shellconfigs.rc.sh sisältää kaikki dokumenttikohtaiset ympäristömuuttujat. Muut Bourne Shell -skriptit sisällyttävät sen ajonaikana, joten samat skriptit toimivat muuttamattomina muissakin dokumentaatioprojekteissani, kunhan niille tehdään oma shellconfigs.rc.sh -tiedostonsa. release.sh on Z Shell -kielinen shelliskripti, joka kopioi valmiit tiedostot WWW-hakemistoon julkaistavaksi ja myös pakkaa niitä. cleanall.sh on Bourne Shell -kielinen shelliskripti, joka poistaa kaikki käännös- ja konversioprosessien tuottamat tiedostot – mukaanlukien erilaiset logitiedostot ja väliaikaistiedostot. syncebook.sh on Bourne Shell -kielinen shelliskripti, jolla valmis dokumentti kopioidaan käyttämääni sähköisten kirjojen lukulaitteeseen sen ymmärtämissä muodoissa. synctablet.sh on muuten samanlainen skripti kuin syncebook.sh , mutta sillä kopioin osan syntyneistä tiedoista eräälle muistikortille, jota käytän Android-tabletissani. sivut.sh on Bourne Shell -kielinen shelliskripti, joka tutkii pdfinfo -komennolla, että mikä on PDF-dokumenttien sivumäärä. docutils.conf on python-docutils -ohjelmiston asetustiedosto, jolla säädetään konversiota ReStructuredText-formaatista muihin tiedostoformaatteihin python-docutils -ohjelmiston ohjelmilla. RST_Palatino_OpenSans.sty on LaTeX-makrotiedosto, jolla säädetään LaTeX-muotoon konvertoidun tiedoston juhtolv_tolle_harjoitukset.tex käännösprosessia, joka tapahtuu xelatex-komennolla. Kaikki sen tarvitsemat fontit on luetelty sen kommenttiriveillä, jotka tunnistaa siitä, että niiden alussa on %-merkki. Kommenttiriveillä kerrotaan myös, että mistä ne fontit saa. docutils.twoside.conf on muuten sama kuin docutils.conf, mutta sitä käytetään vain silloin, kun tuotetaan kaksipuoleiseen tulostukseen tarkoitettu LaTeX-tiedosto nimeltä juhtolv_tolle_harjoitukset.twoside.tex. Sitä sitten xelatex-komennolla kääntäessä yhä käytetään LaTeX-makrotiedostoa nimeltä RST_Palatino_OpenSans.sty . docutils.12pt.conf on muuten sama kuin docutils.conf , mutta sitä käytetään vain silloin, kun tuotetaan 12 pisteen fonttikoolla oleva LaTeX-tiedosto nimeltä juhtolv_tolle_harjoitukset.12pt.tex. Sitä sitten xelatex-komennolla kääntäessä käytetäänkin LaTeX-makrotiedostoa nimeltä RST_Palatino_OpenSans_12pt.sty . docutils.twoside.12pt.conf on muuten sama kuin docutils.conf tai docutils.12pt.conf, mutta sitä käytetään vain silloin, kun tuotetaan 12 pisteen fonttikoolla oleva ja kaksipuoleiseen tulostukseen tarkoitettu LaTeX-tiedosto nimeltä LaTeX-tiedosto nimeltä juhtolv_tolle_harjoitukset.twoside.12pt.tex. Sitä sitten xelatex-komennolla kääntäessä käytetäänkin LaTeX-makrotiedostoa nimeltä RST_Palatino_OpenSans_12pt.sty . docutils.landscape.conf on muuten sama kuin docutils.conf, mutta sitä käytetään vain silloin, kun tuotetaan vaakasuntaiseksi tarkoitettu LaTeX-tiedosto nimeltä juhtolv_tolle_harjoitukset.landscape.tex. Sitä sitten xelatex-komennolla kääntäessä käytetäänkin LaTeX-makrotiedostoa nimeltä RST_landscape.sty ja myös siinä on kommenttiriveillä kerrottu tarvitut fontit. Kommenttiriveillä kerrotaan myös, että mistä ne fontit saa. docutils.woodeneye.conf on muuten sama kuin docutils.conf , mutta sitä käytetään vain silloin, kun tuotetaan LaTeX-tiedosto nimeltä juhtolv_tolle_harjoitukset.woodeneye.tex. Sitä sitten xelatex-komennolla kääntäessä käytetäänkin LaTeX-makrotiedostoa nimeltä RST_woodeneye.sty ja myös siinä on kommenttiriveillä kerrottu tarvitut fontit. Kommenttiriveillä kerrotaan myös, että mistä ne fontit saa. Muista tiedostomuodoista löydät tietoa tiedoston compileall.sh kommenttiriveiltä. Enimmäkseen ne ovat toinen toistaan eksoottisempia sähköisten kirjojen formaatteja, joita pandoc ja Calibre osaavat tuottaa konvertoimalla muista formaateista.