Brython opas - Yleistä

Brython on Python-kielen versio, jossa Python-kielen suoritus tapahtuu selaimessa.

Tämä tarkoittaa, että Brython voidaan suorittaa millä tahansa selaimella ja ohjelmointi-työkaluna voi toimia mikä tahansa tekstieditori.

Nettisivun html-koodin rakenne

Html-koodi on tarkoitettu nettisivun rakentamiseen. Tätä rakennetta noudattaa kaikki nettisivut, niin Facebookin jokainen näkyvä sivu, kuin Wikipediankin sivut.

Sivu rakentuu aina niin kutsuttujen tagien varaan, jotka merkitään < ja > merkkien väliin. Välissä oleva sana ilmoittaa selaimelle tiedon siitä, mitä haluamme selaimen tekevän tai mistä alkaa mikäkin osio nettisivulla.

• Alla olevassa esimerkissä ensimmäinen rivi ilmoittaa selaimelle, että tämä on html-dokumentti.
• Rivilla 2 aloitaan html-koodi, joka loppuu rivillä 15 (huomaa lopetusmerkki /html).
• Itse html sivu rakentuu kahdesta osiosta: head ja body. Head-osio on määritelty rivien 4 ja 6 väliin.
• Head-osioon tulee yleensä esimerkiksi ohjelmakoodia, sivulle tulevia tyylimäärityksiä ja sivulle tilattavia ohjelmia muualta netistä.
• Body osioon, joka on määritetty rivien 8 ja 13 väliin, kirjoitetaan kaikki nettiselaimen ikkunassa näkyvät asiat. Selaimen ikkunassa näkyviä asioita voidaan sitten muunnella, poistaa, lisätä ohjelmakoodeilla.

Huomaa! Mitkään muut muotoilut kuin välilyönnit eivät välity nettiselaimelle. Kaikki muut muotoilut täytyy käskeä tageilla. Muotoiluista enemmän löytyy https://www.matikki.fi/html/yleista.html

Ensimmäinen ohjelma

Mitä koodissa tapahtuu (rivi ilmoitettu R-alulla, esim. rivi 1 on R1):

• R1 ilmoitetaan selaimelle, että tämä on html-koodi
• R2 ilmoitetaan selaimelle html-koodin alkavan
• R3 html-koodin head-osio alkaa
• R5 haetaan src-parametrin osoitteesta Brythonin suorittava koodi
• R6 html-koodin head-osio loppuu
• R8 ilmoitetaan, että tästä alkaa Python-koodi
• R10 tuodaan browser-kirjastosta document-olio, jota voidaan sitten käyttää hyväksi koodissa
• R12 ensimmäinen varsinainen käsky, joka vie nettisivun dokumenttiin (document) tekstin "Hei maailma". Käsky päätetään puolipisteeseen (;)
• R14 ilmoitetaan Python-koodin loppumisesta
• R16 varsinainen nettisivulla oleva dokumentti alkaa,
  samalla rivilla oleva onload-ilmaisu tarkoittaa, että sivun ladattua itsensä selaimeen, suorita brython(), eli yllä oleva script-osiossa olevat käskyt
• R18 nettisivulla oleva dokumentti loppuu
• R19 ilmoitetaan selaimelle, että html-koodi loppuu

Kommentointi ohjelmassa

Kommentointi on ohjelmoinnin tehokkaimpia keinoja. Oman ohjelman kommentointi selkeyttää ohjelmakoodia ja muistuttaa ohjelmoijalle, miten ohjelma on rakennettu. Usean viikon tai vuoden päästä voi olla hyvin vaikea muuten päätellä, miten olet rakentanut ohjelman toiminnan.

Kommentointia tarvitaan kertomaan myös muille ohjelmoijille, miten ohjelma toimii ja miten sitä voisi kehittää. Nykyään tämä on vielä korostunut entisestään ohjelmoijien laittaessa koodin tai ohjelman pätkiä muiden ohjelmoijien ulottuville nettiin.

Kommentointi tehdään merkillä # rivin alussa. # merkillä aloitettua riviä ei siis suoriteta ohjelmaa ajettaessa.

Samoin, jos laitat käskyriville # merkin, sen jälkeistä ei suoriteta ohjelmaa ajettaessa. Älä tällöin käytä kuitenkaan tab-nappia saadaksesi kommentin reunemmaksi.

Edellinen esimerkki kommentoituna:

Tehtävä:

• Muuta edellistä esimerkkiä siten, että siinä on kaksi käskyä. Ensimmäinen käsky tulostaa "Minun nimeni on: " ja toinen sinun oman nimesi.
• Kokeile tehdä sama asia print("Jokin teksti"); käskyllä

Suorita tehtävävät Editorilla ja tallenna työsi Tiedostona.