
Tervetuloa käyttämään Ionia!

Jos et ole käyttänyt Ionia aiemmin, on hyvin suotiteltavaa, että opiskelet
Ionin ohjesivun ennen kuin jatkat tätä pidemmälle. Se on toistettu alla,
mutta voit aukaista sen myös myöhemmin painamalla <F1> ja <Enter>, tai
suorittamalla 'man ion3' komentoriviltä. (Tämä toimii sillä oletuksella,
että olet asentanut Ionin järjestelmässäsi sellaiseen vakiosijaintin, 
mistä sen työkalut osaavat hakea ohjesivuja.)

Jos olet innokas kokeilemaan Ionia nyt heti ja vastoin suosituksia haluat
jättää ohjesivun lukematta tällä istumalla, sinun tulisi kuitenkin tietää
ainakin seuraavat näppäimet: <F2> käynnistää pääte-emulaattorin (xterm)
ja <F12> näyttää päävalikon.

Jossain vaiheessa, opeteltuasi Ionin peruskäsitteet ja toiminnot, haluat
varmaan muokata sen asetukset itsellesi sopivammiksi. Tähän löydät apua
(englanniksi) Ionin asetus- ja ohjelmointimanuaalista. Se löytyy ainakin
Ionin seittisivulta, johon on linkki alla olevan ohjesivun lopussa.
Huomautettakoon vielä, että Ionin käytön ja peruskäsitteiden opettelu
on hyvin suositeltvaa ennen asetustiedostojen pariin hyppäämistä.

---- Ohjesivu seuraa ----


ION(1)                      General Commands Manual                     ION(1)

NIMI
     Ion - X11 ikkunanhallintaohjelma

SELOSTE
     ion3 [valinnat]

KUVAUS
     Ion on nappaimistokayttajia silmallapitaen suunniteltu laatoitusta ja
     valilehtia hyodyntava ikkunanhallintaohjelma X11:lle.


VALINNAT
     -display kone:palvelin.naytto
            X palvelin, johon ottaa yhteys.

     -conffile asetustiedosto
            Kaytettava asetustiedosto.

     -searchdir dir
            Hakupolkuun lisattava hakemisto, josta loytyy asetus- ja muita
            tiedostoja.

     -oneroot
            Hallitse vain oletusnayttoa X-palvelimilla, joissa on useampi
            perinteinen (ei Xinerama) naytto/juuri-ikkuna. Tama naytto voidaan
            valita -display parametrilla tai DISPLAY ymparistomuuttujalla.

     -session session_name
            Istunnon nimi. Tama vaikuttaa talletustiedostojen sijaintiin.

     -help  Nayta komentorivin ohje.

     -version
            Nayta Ionin versio.

     -about Nayta tietoja Ionista (versio, tekija, lisenssi).


PERUSKASITTEET
     Tama kappale on katsaus erilaisiin niin kutsuttuihin kappaleisiin, joita
     ilmenee Ionin hallitsemalla X-naytolla, ja niiden suhteisiin tavallisessa
     kokoonpanossa. Sinun tarvitse ymmartaa nama suhteet tietaaksesi milloin
     mitkakin alempana kuvattavat nappainsidonnat ovat kaytettavissasi. Jos
     kaipaat viela tarkempaa kuvausta, esimerkiksi tehdaksesi omat
     asetustiedostot, katso Ionin seittisivulta saatavaa yksityiskohtaisempaa
     dokumentaatiota.

     Ylimman tason kappaleista, joilla on merkitysta tassa yhteydessa,
     kutsutaan naytoiksi. Ne vastaavat fyysisia nayttoja. Naytot sisaltavat
     tyopoytia (jotka ovat itse eraanlaisia ryhmia) ja kokoruudun tilassa
     olevia asiakasikkunoita. Nama kappaleet ovat lomitettu siten, etta vain
     yksi voi nakya kerrallaan.

     Tyopoydat voivat vuorostaan sisaltaa laatoituksia seka
     kelluvia/irroitettuja kehyksia. Laatoitukset taasen sisaltavat kehyksia
     laatoitettuna tayttamaan koko nayton, seka mahdollisesti tilapalkin tai
     telakan (dock). Nayttojen tapaan kehykset lomittavat muita kappaleita,
     mutta tassa tapauksessa lahinna asiakasikkunaryhmia.  Kehykset ovat
     suurimman osan ajasta ainut asia, minka naet Ionista. Niilla voi olla
     reunakoristukset, ja lisaksi kehyksissa on valilehti jokaiselle
     lomitetulle kappaleelle.

     Kyselyt ovat nayttojen tai kehysten alaosiin imestyvia laatikoita, jotka
     odottavat sinulta tekstin syottoa jonkin siita riippuvan toiminnon
     suorittamiseksi. Useimmat kyselyt tukevat tab-taydennysta.



SIDONNAT
     Nama ovat oletusarvoiset nappain- ja osoitinsidonnat. Nappainmuunninta
     (Mod1) vastaava nappain riippuu jarjestelmastasi. PC-tietokoneilla,
     joissa on XFree86 se on todennakoisesti vasen Alt-nappain (Alt_L).
     Suneilla se on luultavasti sidottu timanttinappaimiin. Kayta komentoa
     xmodmap(1x) selvittaaksesi asian tarkemmin.

     Otsikkojen perassa hakasuluissa oleva merkkijono ilmoittaa moduulin,
     jonka asetustiedosto maarittelee alla olevat sidonnat.


   Yleisesti saatavilla olevat sidonnat
     Mod1+1, Mod1+2, Mod1+3, Mod1+4, Mod1+5, Mod1+6, Mod1+7, Mod1+8, Mod1+9,
     Mod1+0 Siirry n:teen tamanhetkisen nayton lomittamaan kappaleeseen
            (tyopoyta, kokoruudun asiakasikkuna).

     Mod1+comma, Mod1+period
            Siirry seuraavaan/edelliseen tamanhetkisen nayton lomittamaan
            kappaleeseen.

     Mod1+K K
            Mene ensimmaiseen huomiota vaativaan alueeseen, tai edelliseen
            aktiiviseen.

     Mod1+K T
            Poista kaikki merkinnat.

     Mod1+Shift+1, Mod1+Shift+2
            Siirry naytolle n usean nayton jarjestelmassa.

     Mod1+Shift+comma, Mod1+Shift+period
            Mene seuraavalle/edelliselle naytolle usean nayton jarjestelmassa.

     Mod1+F9
            Luo uusi tyopoyta ennalta asetettua tyyppia.

     F12, Button3 painallus
            Nayta paavalikko.

     Button2 painallus
            Nayta ikkunavalikko.

     Mod1+Tab
            Kierrata fokusta eteenpain.

     Mod1+K Tab
            Kierrata fokusta taaksepain

     Mod1+K R
            Nosta aktiivista kappaletta, jos mahdollista.



   Naytoilla ja kaikissa kehyksissa toimivat sidonnat
     Mod1+C Sulje aktiivinen kappale.



   Kaikissa kehyksissa toimivat sidonnat
     Mod1+K H, Mod1+K V
            Maksimoi kehys vaaka/pystysuunnassa.

     Button3 painallus
            Nayta kontekstivalikko.

     Mod1+R Aloita siirto ja koonmuutostila.

     Button1 napsautus osassa tab, Button2 napsautus osassa tab
            Vaihda kehys nayttamaan valilehden ilmoittama kappale.

     Button1 raahaus osassa border, Mod1+Button3 raahaus
            Muuta kehyksen kokoa.

     Mod1+Button1 raahaus
            Siirra kehysta.

     Button1 raahaus osassa tab, Button2 raahaus osassa tab
            Siirra kappaletta kehysten valilla raahaamalla ja pudottamalla
            valilehti.



   Naytoilla ja ylimman tason kehyksissa (ei ns. transientit) toimivat
     sidonnat
     Mod1+T Merkitse aktiivinen kappale.

     F1     Kysy ohjesivua naytettavaksi.

     Mod1+F1
            Nayta Ionin ohjesivu.

     F2     Kaynnista paate-emulaattori.

     F3     Kysy komentorivia suoritettavaksi.

     Mod1+F3
            Kysy Lua-koodia ajettavaksi.

     F4     Ota SSH-yhteys kyseltavaan koneeseen.

     F5     Kysy tiedostoa muokattavaksi.

     F6     Kysy tiedostoa naytettavaksi.

     F9     Kysy tyopoytaa jolle siirtya, tai luo uusi.

     Mod1+G Kysy asiakasikkunaa, johon siirtya.

     Mod1+M Nayta kontekstivalikko.

     Mod1+K D
            Irroita (kelluta) tai uudelleenliita kappale sen edelliseen
            sijaintiin.



   Ylimman tason kehyksissa (ei ns. transientit) toimivat sidonnat
     Mod1+A Kysy liitettavaa asiakasikkunaa.

     Mod1+K 1, Mod1+K 2, Mod1+K 3, Mod1+K 4, Mod1+K 5, Mod1+K 6, Mod1+K 7,
     Mod1+K 8, Mod1+K 9, Mod1+K 0
            Siirry n:teen kehyksen jakavaan kappaleeseen.

     Mod1+K N, Mod1+K P
            Siirry seuraavaan/edelliseen kehyksen jakavaan kappaleeseen.

     Mod1+K comma, Mod1+K period
            Siirra kehyksessa talla hetkella naytettavaa kappaletta
            vasemmalle/oikealle.

     Mod1+K H, Mod1+K V
            Maksimoi kehys vaaka/pystysuunnassa.

     Mod1+K A
            Liita merkityt kappaleet tahan kehykseen.



   Kelluvissa/irroitetuissa kehyksissa toimivat sidonnat
     Button1 kaksoisnapsautus osassa tab
            Kytke litistys paalle/pois.

     Button1 painallus osassa tab, Button1 painallus osassa border,
     Mod1+Button1 napsautus
            Nosta kehys.

     Mod1+Button3 napsautus
            Alenna kehysta.

     Button1 raahaus osassa tab
            Siirra kehysta.

     Mod1+K B
            Laatoita kehys, jos tyopoydalla ei ole kehysta



   Laatoituksien ja laatoitettujen kehysten sidonnat [mod_tiling]
     Mod1+S Halkaise tamanhetkinen kehys pystysuunnassa.

     Mod1+P, Mod1+N, Mod1+Tab, Mod1+K Tab
            Siirry tamanhetkisen kehyksen ylla/alla/vasemmalle/oikealla
            olevaan kehykseen.

     Mod1+K S
            Halkaise tamanhetkinen kehys vaakasuunnassa.

     Mod1+K X
            Tuhoa tamanhetkinen kehys.



   Asiakasikkunoiden sidonnat
     Mod1+L Tonaise aktiivista asiakasikkunaa. Tama saattaa auttaa joidenkin
            ohjelmien koko-ongelmien kanssa.

     Mod1+K C
            Tapa aktiivisen asiakasikkunan omistava ohjelma.

     Mod1+K Q
            Laheta seuraava nappainpainallus aktiiviselle asiakasikkunalle.
            Kaikki ohjelmat eivat valttamatta salli tata oletuksena.


     Mod1+Return
            Muuta asiakasikkunaryhman kokoruudun tilaa



   Siirto- ja koonmuutostilan sidonnat
     Escape Peruuta tilasta.

     Return Siirry tilasta pois.

     Left, Right, Up, Down, F, B, P, N
            Kasvata vastaavaan suuntaan.

     Shift+Left, Shift+Right, Shift+Up, Shift+Down, Shift+F, Shift+B, Shift+P,
     Shift+N
            Kutista vastaavaan suuntaan.

     Mod1+Left, Mod1+Right, Mod1+Up, Mod1+Down, Mod1+F, Mod1+B, Mod1+P, Mod1+N
            Liiku vastaavaan suuntaan.



   Viestilaatikoiden ja kyselyiden sidonnat [mod_query]
     Escape, Control+G, Control+C
            Sulje kysely/viesti suorittamatta sidottuja toimintoja.

     Control+U, Control+V, Page_Up, Page_Down
            Vierita viestia tai taydennyksia ylos/alas.



   Tekstinmuokkaussidonnat kyselyihin [mod_query]
     Nama nappainsidonnat vastaavat tekstieditorin joe(1) sidontoja.  Leikkaus
     ja liimaus toimii kuitenkin tavanomaisemmin, joskin nappaimet ovat
     vastaavat.


     Control+F, Control+B, Right, Left
            Siirry yksi merkki eteen/taakse.

     Control+E, Control+A, End, Home
            Mene rivin alkuun/loppuun.

     Control+X, Control+Z
            Ohita yksi sana eteen/taaksepain

     Control+D, Delete
            Poista seuraava merkki.

     BackSpace, Control+H
            Tuhoa edellinen merkki.

     Control+W, Control+O
            Tuhoa yksi sana eteen/taakse.

     Control+J
            Tuhoa merkit rivin loppuun saakka.

     Control+Y
            Tuhoa koko rivi.

     Control+T
            Transponoi merkit.

     Control+P, Control+N, Up, Down, Control+Up, Control+Down
            Nayta seuraava/edellinen vastaus muistista.

     Button2 napsautus, Control+K C
            Liimaa teksti leikelaudalta.

     Control+K B
            Aloita tekstin valinta.

     Control+K Y
            Leikkaa valittu teksti.

     Control+K K
            Kopioi valittu teksti.

     Control+K G
            Lopeta tekstin valinta.

     Tab, Shift+Tab, Control+Tab
            Yrita taydentaa syotetty teksti tai selaa taydennyksia.

     Control+R, Control+S
            Taydenna historiasta

     Control+M, Return, KP_Enter
            Sulje kysely ja suorita sidottu toiminta.



   Valikoiden sidonnat [mod_menu]
     Escape, Control+G, Control+C, Left
            Sulje valikko.

     Return, KP_Enter, Control+M, Right
            Suorita valinta.

     Control+N, Control+P, Up, Down
            Siirry seuraavaan/edelliseen valintaan.

     BackSpace
            Tyhjaa valikon hakupuskuri.




TIEDOSTOT JA HAKEMISTOT
     /usr/local/share/examples/ion3/cfg_ion.lua
            Jarjestelman oletusarvoinen paaasetustiedosto.

     /usr/local/share/examples/ion3/cfg_*.lua
            Muita asetustiedostoja.

     /usr/local/share/examples/ion3/look_*.lua
            Ulkonaon asetustiedostoja.

     ~/.ion3/
            Kayttajan asetustiedostot.

     ~/.ion3/cfg_ion.lua
            Kayttajan oletusarvoinen paaasetustiedosto.


KATSO MYOS
     Ionin kotisivu, http://iki.fi/tuomov/ion/ (englanniksi).

     Dokumentti "Configuring and extending Ion3 with Lua" (englanniksi)
     nahtavissa Ionin kotisivulla.

     /usr/local/share/doc/ion3/

     X(7x), pwm3(1), joe(1)


TEKIJA
     Ionin on kirjoittanut Tuomo Valkonen <tuomov at iki.fi>.

                                                                        ION(1)
