Eduskuntaseuranta

Oma datasivu ilman koodaustaitoa, vain puhelimella

Tämä opas näyttää, miten teet oman datasivun, joka päivittyy itsestään. Tarvitset vain puhelimen. Esimerkkiprojektina on yksi pieni sivu: pörssisähkön hinta nyt.

Tässä ei rakenneta mitään jättimäistä. Tarkoitus on, että ymmärrät koko ketjun yhdellä pienellä esimerkillä: mistä data tulee, miten se päätyy sivulle ja miten sivu pysyy ajan tasalla ilman, että teet mitään käsin.

Mitä saat valmiiksi

Opas on kuusi lyhyttä osaa

  1. 1. Mitä tarvitsetIlmainen. Luet tässä.
  2. 2. Idea ja yksi datalähdeIlmainen. Luet tässä.
  3. 3. Sivu verkkoonEnsimmäinen sivu verkkoon omalla osoitteella: ilmainen, luet tässä. Automaattinen julkaisu on PDF-oppaassa.
  4. 4. Data sivulleDatan tuonti sivulle ja sen näyttäminen selkeästi. PDF-oppaassa.
  5. 5. Päivitys automaattiseksiSivu päivittyy itsestään, ilman että avaat mitään. PDF-oppaassa.
  6. 6. Mihin tämä kasvaa ja miten datasta tulee asiakkaitaMiten pieni sivu muuttuu isommaksi, ja miten sillä ansaitaan. PDF-oppaassa.

Osa 1. Mitä tarvitset

Tavoite: sinulla on kaikki valmiina ennen kuin aloitat.

Rahaa et tarvitse. Koodaustaitoa et tarvitse.

GitHub-tilin teko

GitHub on paikka, jossa sivusi tiedostot säilytetään ja josta sivu julkaistaan. Se on ilmainen.

  1. Avaa puhelimen selaimella github.com.
  2. Paina Sign up.
  3. Anna sähköpostiosoite, keksi salasana ja käyttäjänimi. Käyttäjänimi tulee näkyviin sivusi osoitteeseen, joten valitse sellainen, jonka kehtaat näyttää muille.
  4. Vahvista sähköpostisi. GitHub lähettää koodin tai linkin.
  5. Kirjaudu sisään ja tarkista, että näet GitHubin etusivun.
Vinkki: kirjoita salasana ylös turvalliseen paikkaan. Älä kerro sitä kenellekään, älä myöskään keskusteluissa tai kommenteissa.

Tarkistuslista:

Osa 2. Idea ja yksi datalähde

Tavoite: valitset aiheen ja löydät datan, jota voit käyttää.

Hyvä idea on kysymys, jonka ihmiset oikeasti esittävät

Älä aloita "mitä dataa on?" vaan "mitä ihmiset haluavat tietää?" Esimerkiksi:

Hyvässä ideassa kysymykseen vastaus muuttuu ajan myötä, joten ihmiset palaavat sivulle uudelleen.

Neljä testiä datalähteelle

Ennen kuin rakennat mitään, tarkista nämä:

  1. Avoin: data aukeaa ilman kirjautumista.
  2. Koneluettava: sille on osoite, josta saa tiedoston (yleensä JSON tai CSV), ei vain sivu, jota luetaan silmillä.
  3. Päivittyy: lähde saa uutta dataa säännöllisesti.
  4. Lupa: lähteen ehdot sallivat käytön. Katso sivulta "käyttöehdot" tai "lisenssi". Moni julkinen aineisto on CC BY 4.0 -lisenssillä, jolloin lähde pitää mainita.

Mistä dataa löytyy

Esimerkki: pörssisähkön hinta

Esimerkkiprojektimme data tulee osoitteesta:

https://api.porssisahko.net/v1/latest-prices.json

  1. Kopioi osoite ja avaa se puhelimen selaimessa.
  2. Näet pitkän listan. Se näyttää sekavalta, mutta jokainen rivi on yksi hintajakso.
  3. Kustakin jaksosta näet alkamisajan, päättymisajan ja hinnan.

Se on koko dataa. Seuraavissa osissa tämä lista muutetaan siistiksi sivuksi.

Tarkista aina yksikkö: lue lähteen oma kuvaus siitä, onko hinta sentteinä vai euroina ja sisältääkö se arvonlisäveron. Älä arvaa, koska väärä yksikkö tekee koko sivusta virheellisen.

Tarkistuslista:

Osa 3. Ensimmäinen sivu verkkoon

Tavoite: sinulla on oma sivu, joka näkyy internetissä omalla osoitteella. Tämä vie noin kymmenen minuuttia.

Alla näet, millainen esimerkkisivu on valmiina. Luvut ovat esimerkkejä, ja omalla sivullasi on oikea data.

Esimerkki: Pörssisähkön hinta nyt
4,2 c/kWh
Normaali hinta
klo 211,3
klo 223,1
klo 236,0

1. Tee repositorio

  1. Kirjaudu GitHubiin ja paina oikeassa yläkulmassa +-merkkiä, sitten New repository.
  2. Nimeksi oma-datasivu.
  3. Valitse Public (julkinen). Julkisen repositorion sivu on ilmainen.
  4. Rastita Add a README file ja paina Create repository.

2. Tee ensimmäinen sivu

  1. Paina Add file, sitten Create new file.
  2. Tiedoston nimeksi index.html.
  3. Liitä kenttään tämä koodi:
<!doctype html>
<html lang="fi">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Oma datasivu</title>
</head>
<body style="font:20px system-ui;padding:24px">
<h1>Moi, tämä on minun sivuni</h1>
<p>Tämä sivu on nyt verkossa.</p>
</body>
</html>
  1. Paina Commit changes ja vielä kerran Commit changes.

3. Julkaise

  1. Avaa repositoriossa Settings (jos et näe sitä, avaa ensin ylävalikko).
  2. Paina vasemmasta valikosta Pages.
  3. Kohdassa Build and deployment valitse Source-kohtaan Deploy from a branch. Valitse haaraksi main ja kansioksi / (root), ja paina Save.
  4. Odota 1–3 minuuttia. Sivusi osoite on https://KÄYTTÄJÄNIMI.github.io/oma-datasivu/ (vaihda KÄYTTÄJÄNIMI omaksesi). Se näkyy myös Pages-asetuksissa.

Tarkistuslista:

Mitä tästä puuttuu? Sivulla ei ole vielä dataa, eikä se päivity itsestään. PDF-oppaassa vaihdat julkaisun automaatioon, tuot sivulle oikean pörssisähkön hinnan ja saat sivun päivittymään kolmen tunnin välein ilman, että teet mitään.

Seuraavaksi: osat 4–6 (PDF)

Täysi opas PDF:näOsissa 3–6 viimeistelet julkaisun automaatioksi, tuot datan sivulle, teet päivityksestä automaattisen ja pohdit, miten pienestä sivusta kasvaa tuote. PDF sisältää valmiit kopioitavat koodit, tarkistuslistat ja koko esimerkin askel askeleelta, myös viimeisen osan, joka säästää sinulta suurimman osan työstä.

PDF ei ole vielä myynnissä. Jos haluat tietää, kun se on valmis, kommentoi videolle OPETA tai lähetä viesti osoitteeseen miika@eduskuntaseuranta.fi.