﻿NANOWIN 1.0 - NANO-TYYLINEN WINDOWS-TEKSTIEDITORI
================================================
Sepon käyttöön tehty oma sovellus. Tämä ei ole GNU nano, GNU-projektin tuote
eikä sen virallinen Windows-porttaus. Se käyttää nanosta tuttuja perinteisiä
näppäinkomentoja omassa Windows-ikkunassa. Koko GNU nanon toiminnallisuutta,
lisäosia, syntaksiväritystä tai päätekäyttöliittymää ei ole toteutettu.

KÄYNNISTYS
1. Pura ZIP kokonaan omaksi kansiokseen.
2. Kaksoisnapsauta Kaynnista-NanoWin.bat.
3. Kirjoita tekstiä. Ctrl+O avaa tallennusikkunan ja Ctrl+X sulkee.

Tarkoitettu Windows 10/11 -työpöydälle, jossa on Windows PowerShell 5.1 ja
Windowsin .NET Framework / Windows Forms. Pythonia, Wineä, WSL:ää, Linuxia,
verkkoyhteyttä tai erillisiä ohjelmakirjastoja ei tarvita tavalliseen käyttöön.
Ensikäynnistys kääntää mukana olevan C#-lähdekoodin muistiin.
BAT-tiedoston avaama pääte voi jäädä taustalle; älä sulje sitä kesken käytön.

HALUATKO TAVALLISEN EXE-TIEDOSTON?
Kaksoisnapsauta Luo-EXE.bat. Se kääntää samasta lähdekoodista NanoWin.exe:n
sinun Windows-koneellasi. Käännös ei tarvitse Internetiä eikä Visual Studiota.
Kun käännös ilmoittaa onnistumisesta, käynnistä NanoWin.exe suoraan.
Voit tehdä EXE-tiedostosta työpöydälle pikakuvakkeen. EXE toimii itsenäisesti
ilman lähdekooditiedostoja mutta tarvitsee Windowsin .NET Frameworkin.
Paketti ei sisällä valmiiksi käännettyä EXEä.

Windows voi varoittaa ladatuista BAT-, PS1- tai allekirjoittamattomista
EXE-tiedostoista. Käynnistysskripti käyttää ExecutionPolicy Bypass -asetusta
vain kyseiselle PowerShell-prosessille; se ei muuta koneen pysyvää asetusta.
Organisaation sovellusrajoitukset voivat estää käännöksen tai käynnistyksen.
Ohjelma ei tarvitse ylläpitäjän oikeuksia eikä lähetä tekstiä verkkoon.

NÄPPÄIMET
^ tarkoittaa Ctrl-näppäintä, esimerkiksi ^O = Ctrl+O.
Ctrl+O          Tallenna nimellä (näyttää nimen ja kansion)
Ctrl+S          Pikatallennus nykyiseen tiedostoon
Ctrl+X          Sulje; kysyy tallentamattomista muutoksista
Ctrl+N          Uusi tiedosto
Ctrl+Shift+O    Avaa tiedosto muokattavaksi
Ctrl+R          Lisää toisen tiedoston sisältö kohdistimeen / valinnan tilalle
Ctrl+W          Etsi tekstiä (kirjainkoko ohitetaan)
F3              Etsi seuraava; haku kiertää tiedoston alkuun
Ctrl+H          Korvaa kaikki (täsmällinen kirjainkoko; kysyy vahvistuksen)
Ctrl+K          Leikkaa valittu teksti tai kokonainen nykyinen rivi
Ctrl+U          Liitä viimeksi Ctrl+K:lla leikattu teksti
Ctrl+Shift+C    Kopioi valittu teksti Windowsin leikepöydälle
Ctrl+V          Liitä Windowsin leikepöydältä pelkkänä tekstinä
Ctrl+A          Valitse kaikki
Ctrl+C          Näytä rivin ja sarakkeen sijainti
Alt+G           Siirry riville
Alt+W           Vaihda rivin visuaalinen rivitys päälle/pois
Alt+U / Ctrl+Z  Kumoa tekstimuutos
Alt+E / Ctrl+Y  Tee tekstimuutos uudelleen
Ctrl+G / F1     Ohje

Huomaa: Ctrl+X SULKEE ohjelman, ei leikkaa kuten monessa Windows-ohjelmassa.
Ctrl+C näyttää sijainnin; kopioi Ctrl+Shift+C:llä. Valinnan voi tehdä hiirellä
 tai Shift+nuolinäppäimillä. Alareunan näppäinvihjeet ovat myös painikkeita.
Ctrl+K korvaa sisäisen leikkeen joka kerta; peräkkäiset leikkaukset eivät
kerry yhteen kuten GNU nanon joissakin tilanteissa. Tämä sisäinen leike ei
muuta Windowsin leikepöytää. Avaa erillinen ikkuna käynnistämällä ohjelma uudelleen.

TIEDOSTOT JA MERKISTÖT
Sopii tavallisiin tekstitiedostoihin, esimerkiksi TXT, LOG, INI, CSV, HTML,
CSS, Python ja .desktop. Ohjelma ei suorita muokattavaa koodia.
Ei DOCX-, PDF-, musiikki- tai muiden binaaritiedostojen muokkaamiseen.

Uuden tiedoston oletus: UTF-8 ilman BOM-tunnistetta ja Windowsin CRLF-rivit.
Linux-tiedostoa varten valitse Muoto > Rivinvaihto: Linux LF.
Valikko tarjoaa myös UTF-8:n BOM-tunnisteella tai ilman sitä.
BOM on tiedoston alussa oleva merkistön tunniste, ei näkyvä tekstimerkki.

Avattaessa tunnistetaan BOM-tunnisteellinen UTF-8/UTF-16/UTF-32 sekä
kelvollinen UTF-8 ilman tunnistetta. Virheellisestä UTF-8:sta kysytään,
avataanko Windows-1252-merkistöllä. Se ei ole yleispätevä merkistötunnistus:
jos kirjaimet näyttävät vääriltä, älä tallenna alkuperäisen päälle.
Tunnistettu merkistö ja rivinvaihdot säilytetään tallennuksessa.
Sekoittuneista rivinvaihdoista ilmoitetaan ennen avaamista; tallennus
normalisoi ne valittuun tyyliin. Rivitys-valinta vain muuttaa näyttöä.
Ohjelma ei lisää automaattisesti ylimääräistä rivinvaihtoa tiedoston loppuun.
Rivi/sarake perustuu tekstiin, joten sarkain ja emoji eivät aina vastaa
näytöllä näkyvien merkkipaikkojen määrää. Koko tiedosto pidetään muistissa;
editori on tarkoitettu tavallisiin pieniin ja keskikokoisiin teksteihin.

TALLENNUS
Ikkunan * ja [MUUTETTU] osoittavat tallentamattomia muutoksia.
Uusi, Avaa ja Sulje kysyvät tallennuksesta ennen tekstin hylkäämistä.
Jos sama tiedosto on muuttunut levyllä avaamisen jälkeen, tallennus kysyy
vahvistuksen ennen korvaamista. Uusi ja alkuperäinen tiedosto kannattaa
pitää erillisinä, kun kokeilet editoria ensimmäisen kerran.

Tallennus kirjoittaa ensin väliaikaisen tiedoston samaan kansioon ja korvaa
vasta sitten kohteen. Jos levy ei tue korvausoperaatiota tai oikeudet eivät
riitä, tallennus voi epäonnistua; virhe näytetään ja teksti säilyy editorissa.
Tallenna silloin nimellä uuteen tiedostoon tai omaan Asiakirjat-kansioon.
Ohjelmassa ei ole automaattitallennusta tai kaatumisen jälkeistä palautusta.

AVAA TIEDOSTO KÄYNNISTETTÄESSÄ
Voit vetää tekstitiedoston Kaynnista-NanoWin.bat- tai NanoWin.exe-kuvakkeen
päälle, tai antaa EXElle tiedostopolun ensimmäisenä argumenttina:
NanoWin.exe "C:\Users\Seppo\Documents\muistio.txt"

PIKAKOKEILU
1. Kirjoita kaksi riviä, joissa on ä- ja ö-kirjaimia.
2. Tallenna Ctrl+O:lla nimellä koe.txt.
3. Hae sana Ctrl+W:llä ja kokeile rivin leikkausta Ctrl+K / liittämistä Ctrl+U.
4. Kumoa Alt+U:lla ja tallenna Ctrl+S:llä.
5. Sulje ja avaa koe.txt uudelleen. Kokeile myös LF-muotoa Linuxia varten.

TARKISTUKSET JA LÄHDE
Paketin rakenne ja lähdekoodin keskeiset toteutuspolut on tarkistettu.
Windows-käännöstä ja käyttöliittymää ei ole voitu ajaa valmisteluympäristössä.
Perinteisten nano-näppäinten viite:
https://www.nano-editor.org/dist/latest/cheatsheet.html
