Julkaisijan ohjeet

Photo & Moto -sivuston sisällöntuottajan ja ylläpitäjän käsikirja.

Tämä dokumentti on ainoa virallinen ohje sisällön julkaisemiseen sivustolle. Se kattaa kaksi erillistä järjestelmää: artikkelien kirjoittamisen Sveltia CMS:llä ja vanhojen valokuvien tunnistamisen sekä gallerioiden hallinnan yllapito-sivulla.

Käsikirja sijaitsee repon juuressa (JULKAISIJAN_OHJEET.md) ja näkyy sivustolla osoitteessa /fi/julkaisijan-ohjeet/. Päivitykset tehdään suoraan markdown-tiedostoon — sivu päivittyy itsestään seuraavan julkaisun yhteydessä.

---

Sisältö

1. Yleistä
2. Artikkelien kirjoittaminen — Sveltia CMS
3. Käyttäjätilit ja oikeudet — IAM
4. Tunnistamattomat kuvat — yllapito
5. Galleriat — Hallitse galleriaa
6. Yleisimmät tilanteet
7. Vianetsintä

---

Yleistä

Photo & Moto -sivustolla on kaksi erillistä ylläpitojärjestelmää, koska ne hoitavat aivan eri asioita:

Järjestelmä	Mitä tehdään	Kuka käyttää
Sveltia CMS osoitteessa /admin/	Artikkelien kirjoittaminen ja julkaisu	Sisällöntuottajat (toimittajat)
Ylläpito osoitteessa /fi/yllapito	Vanhojen kuvien tunnistus, gallerioiden hallinta	Ylläpitäjät

Sisällöntuottajat tarvitsevat lähinnä vain Sveltia CMS:n. Ylläpitäjät käyttävät molempia. Tämä käsikirja kuvaa molemmat — voit hyppiä omaan osioosi.

Tärkeintä tietää

• Tallennus menee ensin esikatseluun, ei suoraan tuotantoon. Sveltia- tallennus vie artikkelin dev-haaraan, josta se näkyy esikatselusivustolla (photoandmoto-staging.pages.dev) noin parissa minuutissa. Tuotantoon (www.photoandmoto.fi) artikkeli julkaistaan erikseen Julkaise- välilehdeltä (ks. Tallentaminen ja julkaisu).
• Suomeksi pakollinen, englanniksi vapaaehtoinen. Artikkelin voi julkaista pelkästään suomeksi tai suomeksi + englanniksi (ks. Käännös suomesta englanniksi).
• Esikatselu Sveltian sisällä on luotettava. Näet artikkelin suunnilleen sellaisena kuin se näkyy sivustolla jo ennen tallennusta.
• Poistot ovat lopullisia. Sveltia kysyy varmistuksen ennen poistoa, ja poisto viedään tuotantoon automaattisesti (ks. Artikkelin poistaminen). Palauttaminen vaatii kehittäjän apua (git revert).

---

Artikkelien kirjoittaminen — Sveltia CMS

Kirjautuminen

1. Avaa osoite: https://www.photoandmoto.fi/admin/
2. Klikkaa “Kirjaudu GitHubilla”
3. Käytä omaa GitHub-tunnustasi (sinut on lisättävä etukäteen pääsylistalle)

Käyttöliittymän osat

Sisäänkirjautumisen jälkeen näkyvissä on:

• Vasemmalla: kokoelmien lista
  • Artikkelit — kaikki olemassa olevat artikkelit
  • + Uusi MXGP-juttu — pikalisäys MXGP-aiheelle (kategoria + runko esitäytetty)
  • + Uusi historiallinen tarina — pikalisäys historiakirjoitukselle
  • Kategoriat — artikkelien kategorialista
• Yläpalkki: kun olet muokkaamassa artikkelia, näet Tallenna, Julkaise, Poista artikkeli -painikkeet
• Sisältöalue: vasemmalla muokkauslomake, oikealla esikatselu

Uuden artikkelin luominen

Pikalisäys-pohjat (suositeltu tapa)

Pikalisäys-pohjat säästävät aikaa, koska kategoria, tagit ja sisältörunko on valmiiksi täytetty.

MXGP-jutun pohja sisältää:

• Kategoria: MXGP (esitäytetty, ei muokattavissa pikalisäyksen kautta)
• Tagi: MXGP
• Sisältörunko: avauskappale, kilpailun kulku, tulostaulukko, yhteenveto

Historiallisen tarinan pohja sisältää:

• Kategoria: Historical
• Tagi: historia
• Sisältörunko: avauskappale, tausta, tarina, perintö

Klikkaa vasemmalla + Uusi MXGP-juttu tai + Uusi historiallinen tarina. Uusi luonnos avautuu valmiilla pohjalla.

Tyhjästä (Artikkelit-kokoelma)

Klikkaa vasemmalla Artikkelit, sitten oikealla New Artikkeli (oikeassa yläkulmassa). Tämä on tyhjä lomake — sopii mihin tahansa muuhun kuin MXGP- tai historiajuttuun.

Kenttien selitykset

Kenttä	Mitä siihen tulee
Otsikko	Artikkelin otsikko (näkyy sivustolla ja hakukoneissa)
Alaotsikko	Lyhyt selitys (valinnainen, näkyy otsikon alla)
Kirjoittaja	Oletus: “Photo & Moto”
Päivämäärä	Julkaisupäivä (näkyy artikkelilistassa, vaikuttaa järjestykseen)
Kategoria	Pakollinen. Valitse pudotusvalikosta.
Avainsanat	Tagit hakua ja kategorisointia varten
Pääkuva (hero)	Iso kuva otsikon yläpuolella
Korttikuva	Pieni kuva listausnäkymässä (jos eri kuin pääkuva)
Näytä pääkuva otsikon yläpuolella	Yleensä päällä — laita pois, jos haluat pelkän tekstin
Pääkuvan kuvateksti	Pienellä pääkuvan alle
Piilota sivustolta	Luonnostila — artikkeli ei näy julkisesti
SEO-kuvaus	Hakukoneille (maks. 160 merkkiä)
Sisältö	Itse artikkelin teksti markdown-muodossa
Lähteet	Valinnainen lista — yksi lähde per rivi, URL-osoitteet muuttuvat linkeiksi

Käännös suomesta englanniksi

Photo & Moto on kaksikielinen — useimmista artikkeleista on hyvä olla sekä suomen- että englanninkielinen versio. Käännös tehdään käsin Sveltian editorissa; automaattista käännöstä ei enää ole.

Miten se toimii

Sveltiassa artikkelin suomen- (FI) ja englanninkielinen (EN) versio ovat muokattavissa rinnakkain — vaihdat kielten välillä editorin yläosan kielivalinnasta. Et täytä molempia kerralla: kirjoitat ensin suomenkielisen version ja luot englanninkielisen erikseen.

Käytännön työnkulku

Uuden artikkelin kääntäminen:

1. Kirjoita ja tallenna artikkeli suomeksi (FI)
2. Vaihda EN-kieleen editorin yläosasta
3. Käännä teksti Geminin avulla: kopioi suomenkielinen sisältö Geminiin, pyydä käännös englanniksi, ja liitä tulos vastaaviin EN-kenttiin (otsikko, alaotsikko, SEO-kuvaus, kuvateksti, sisältö)
4. Lue käännös läpi ja korjaa mahdolliset kömpelyydet
5. Tallenna

Englanninkielinen versio tallentuu omaan tiedostoonsa (src/content/articles/en/<slug>.md). Suomenkielisen artikkelin myöhemmät muokkaukset eivät kosketa englanninkielistä versiota — jos haluat käännöksen pysyvän ajan tasalla, päivitä EN-versio itse samalla tavalla.

Kun artikkeli halutaan vain suomeksi

Jätä englanninkielinen versio yksinkertaisesti luomatta. Tällöin artikkeli ei näy /en/aikakone/-listassa.

Kuvien lisääminen tekstiin

Kuvat lisätään markdown-sisältöön kahdella tavalla:

1. Mediakirjasto — klikkaa kuvaikkonia muokkauspalkissa → valitse olemassa oleva kuva tai lataa uusi
2. Suora upload — vedä kuva sisällöksi suoraan, järjestelmä lataa sen

Kuvat tallennetaan automaattisesti public/images/-kansioon ja ne pakkautuvat (GitHub Action tekee sen taustalla noin minuutissa).

Tärkeää kuvista:

• Suositeltu koko: leveys 1200–1600px, JPEG, ≤ 500 KB
• Liian isot kuvat pakkautuvat automaattisesti — älä huoli ylikoosta
• Kuvateksti markdownissa: ![Kuvateksti](/images/tiedosto.jpg)

Tallentaminen ja julkaisu

Julkaiseminen on kaksivaiheinen: tallenna Sveltiassa → vie esikatseluun → julkaise tuotantoon.

1. Tallenna Sveltiassa. Sveltiassa ei ole erillistä julkaise-nappia — Tallenna riittää. Tallennus commitoi muutoksen dev-haaraan. Muutos ei vielä näy tuotannossa (www.photoandmoto.fi).

2. Vie esikatseluun ja tarkista. Avaa /fi/yllapito ja sen Julkaise- välilehti:

• Julkaise esikatseluun — rakentaa esikatselusivuston. Odota ~2 minuuttia.
• Esikatsele — avaa photoandmoto-staging.pages.dev ja tarkista, että artikkeli näyttää oikealta.

3. Julkaise tuotantoon. Kun esikatselu on kunnossa, paina Julkaise tuotantoon ja vahvista. Sisältö ilmestyy www.photoandmoto.fi-sivulle noin 2–3 minuutissa.

⏱ Paina Julkaise-painikkeita vasta noin 2 minuuttia Sveltia-tallennuksen jälkeen, jotta tallennus on ehtinyt mennä perille.

Voit tarkistaa tilan:

• GitHub Actions: https://github.com/photoandmoto/photoandmoto/actions (vihreä rasti = taustatyöt, esim. kuvien pakkaus, onnistuivat)
• Cloudflare deployments: näet uusimman julkaisun statuksen sivuston rakentamisen ajan

Artikkelin muokkaaminen

1. Avaa Artikkelit vasemmalla
2. Klikkaa artikkelia listasta
3. Tee muutokset
4. Tallenna

Muutokset tallentuvat dev-haaraan ja näkyvät esikatselussa; vie ne tuotantoon Julkaise-välilehdeltä kuten yllä. Jos haluat tehdä useita muutoksia peräkkäin ilman että jokainen tallennus laukaisee esikatselubuildin, voit valita Piilota sivustolta -ruudun, tehdä muutokset, ja poistaa valinnan kun olet valmis.

Artikkelin poistaminen

1. Avaa artikkeli muokattavaksi
2. Klikkaa yläpalkista Poista artikkeli
3. Vahvista poisto (“Haluatko varmasti poistaa tämän julkaistun artikkelin?”)
4. Klikkaa OK

Poisto tallentuu dev-haaraan, ja artikkelin poisto viedään tuotantoon automaattisesti — erillinen GitHub Action huomaa poiston ja vie sen main- haaraan, joten poistolle ei tarvita Julkaise tuotantoon -painiketta. Artikkeli häviää www.photoandmoto.fi-sivulta noin 2–3 minuutissa, sekä suomen- että englanninkielinen versio kerralla.

⚠️ Poisto on lopullinen. Palautus on mahdollinen vain git revert -komennolla, joka vaatii kehittäjän apua. Tarkista kahdesti ennen poistoa.

---

Käyttäjätilit ja oikeudet — IAM

Tämä osio koskee yllapito-työkaluja (Tunnista kuva, Hallitse galleriaa, Käyttäjät). Sveltia CMS käyttää erillistä GitHub-pohjaista kirjautumista — ks. yllä oleva Artikkelien kirjoittaminen.

Photo & Moton ylläpitojohtoinen autentikointi perustuu henkilökohtaisiin käyttäjätileihin. Jokaisella työkaluja käyttävällä on oma sähköpostiosoite + salasana, ja ylläpitotyökalujen välilehdet näkyvät yksilöllisten oikeuksien mukaan. Vanha jaettu salasana on poistettu käytöstä.

Kirjautuminen

1. Avaa osoite: https://www.photoandmoto.fi/fi/yllapito
2. Syötä sähköposti ja salasana
3. Kirjaudu sisään — näet vain ne välilehdet joihin sinulla on oikeudet

Istunto pysyy voimassa 30 päivää selaimen evästeen kautta. Voit kirjautua ulos yläpalkin Kirjaudu ulos -painikkeesta milloin tahansa.

Salasanan unohtaminen

Jos olet unohtanut salasanasi, käytä Unohditko salasanan? -linkkiä kirjautumissivulla, tai mene suoraan osoitteeseen /fi/palauta-salasana/.

Palautusprosessi:

1. Syötä sähköpostiosoitteesi
2. Vastaa 3 turvakysymyksestä vähintään 2 oikein (kysymykset olet itse asettanut tiliä ottaessa)
3. Aseta uusi salasana
4. Kirjaudu sisään uudella salasanalla

Jos et muista turvakysymystesi vastauksia, työkalun ylläpitäjä voi luoda sinulle uuden provisiointilinkin, jolla pääset asettamaan salasanan ja turvakysymykset uudelleen.

Huom! Palautusyrityksistä jää jälki ylläpidon Palautuslokiin — sekä onnistuneet että epäonnistuneet yritykset, IP-osoitteineen. Tämä estää väärinkäyttöä: jos näet lokissa yrittämistä joita et tehnyt itse, ota yhteyttä ylläpitäjään.

Oikeudet

Jokaisella käyttäjällä on rooli (Editor tai Admin) ja viisi erillistä oikeutta, jotka määrittelevät mitä työkaluja hän näkee. Oikeudet ovat riippumattomia roolista — admin voi olla luonteeltaan rajoitettu ja editor voi saada laajat oikeudet.

Tunnus	Oikeus	Mitä mahdollistaa
T	Tarkista	Yhteisön ehdotusten tarkistus ja kuvien tunnistaminen (Tarkista-välilehti)
L	Lähetä kuva	Uusien tunnistettavien kuvien lataaminen (Lähetä kuva -välilehti)
G	Hallitse galleriaa	Julkaistujen gallerioiden hallinta: kuvatekstit, siirrot, poistot, gallerian uudelleennimeäminen (Hallitse galleriaa -välilehti)
A	Hallitse artikkeleita	Pääsy Sveltia CMS:ään (Hallitse artikkeleita ↗ -linkki avaa erillisen GitHub-kirjautumisen)
I	Hallitse käyttäjiä	Tämän IAM-paneelin käyttö: uusien käyttäjien luonti, oikeuksien muokkaus, deaktivointi (Käyttäjät-välilehti)

Tunnukset T/L/G/A/I näkyvät väribadgeina Käyttäjät-listassa.

Käyttäjien hallinta

Tämä osio koskee vain käyttäjiä, joilla on I (Hallitse käyttäjiä) -oikeus.

Käyttäjät-välilehti näkyy työkalun oikealla puolella, eroteltuna muista välilehdistä. Siellä näet taulukon kaikista käyttäjistä: nimi, sähköposti, rooli, oikeudet badgeina, aktiivisuusstatus, viimeisin kirjautumisaika sekä toiminnot.

Uuden käyttäjän luominen

1. Klikkaa + Lisää uusi käyttäjä -painiketta
2. Täytä etunimi, sukunimi, sähköpostiosoite
3. Valitse rooli (Editor on yleensä oikea valinta uusille toimittajille)
4. Valitse oikeudet ruksaamalla kohdat. Oletukset uudelle editorille:
   • ☑ Tarkista
   • ☑ Lähetä kuva
   • ☑ Hallitse artikkeleita
   • ☐ Hallitse galleriaa (anna vain kokeneille)
   • ☐ Hallitse käyttäjiä (admin-tasoinen oikeus)
5. Klikkaa Luo ja tee linkki
6. Kopioi näyttöön ilmestyvä provisiointilinkki ja lähetä se käyttäjälle (sähköpostilla, viestillä, miten vain)

Huom! Linkki näytetään vain kerran. Jos suljet ikkunan ennen kopioimista, sinun on luotava uusi linkki Uusi linkki -painikkeella käyttäjän riviltä.

Provisiointilinkit

Provisiointilinkki on kertakäyttöinen, 7 päivää voimassa oleva URL, jolla käyttäjä aktivoi tilinsä. Linkin muoto:

https://www.photoandmoto.fi/fi/aseta-salasana?token=<satunnaisesti-luotu-tunnus>

Kun käyttäjä avaa linkin:

1. Hän näkee aseta-salasana-sivun jossa hän asettaa:
   • Vahvan salasanan (vähintään 12 merkkiä, sekä isoja että pieniä kirjaimia, numeroita ja erikoismerkkejä)
   • 3 turvakysymystä ja vastaukset niihin (käytetään salasanan palauttamisessa)
2. Vahvistaa asetukset
3. Saa onnistumisilmoituksen ja voi kirjautua sisään

Linkki katoaa käytöstä heti kun käyttäjä vahvistaa asetuksensa. Jos linkki ehtii vanheta (7 päivää) tai käyttäjä hukkaa sen, luo uusi:

Uuden linkin luominen olemassa olevalle käyttäjälle

Käyttäjät-taulukosta klikkaa kyseisen rivin Uusi linkki -painiketta. Vahvistus-ikkuna kertoo selvästi, että käyttäjän nykyinen salasana ja turvakysymykset poistetaan — hänen on asetettava ne uudelleen avatessaan linkin. Tämä on tarkoituksellinen turvatoimenpide: linkin uudelleenluonti voidaan tehdä myös tilanteissa, joissa epäillään tilin väärinkäyttöä.

Deaktivoidulle käyttäjälle uuden linkin luominen toimii samalla tavalla, mutta se myös reaktivoi tilin automaattisesti.

Käyttäjän tietojen muokkaaminen

Klikkaa Muokkaa-painiketta käyttäjän riviltä. Voit muuttaa:

• Etunimi, sukunimi
• Rooli
• Oikeudet (T/L/G/A/I)

Sähköpostiosoitetta ei voi muuttaa jälkikäteen — jos käyttäjällä vaihtuu sähköposti, deaktivoi vanha tili ja luo uusi.

Käyttäjän deaktivointi

Klikkaa Poista-painiketta käyttäjän riviltä. “Poista” on hieman harhaanjohtava nimi — tili deaktivoidaan, ei poisteta tietokannasta:

• Käyttäjän istunto lopetetaan välittömästi
• Hän ei voi enää kirjautua sisään
• Historia (esim. kenen lisäämä mikäkin kuva on) säilyy
• Reaktivointi on mahdollista luomalla uusi provisiointilinkki Uusi linkki -painikkeesta (sama painike toimii myös deaktivoiduille käyttäjille)

Viimeisen aktiivisen admin-IAM-käyttäjän deaktivointi on estetty — muuten ylläpitojärjestelmä lukittuisi.

Palautusloki

Käyttäjät-välilehden alaosassa on kokoontaitettava Palautusloki (viimeisimmät 50 yritystä) -osio. Se kirjaa kaikki salasanan palautusyritykset:

• ✓ (vihreä) = onnistunut palautus
• ✗ (punainen) = epäonnistunut yritys (väärät turvakysymysvastaukset, vanhentunut tunnus tms.)

Jokaisesta merkinnästä näkyy sähköpostiosoite (jos syötetty), IP-osoite ja yrityksen ajankohta. Mikäli näet tunnistamattomia yrityksiä tai paljon epäonnistuneita peräkkäin — etenkin osoitteille jotka eivät kuulu omille käyttäjillesi — tämä voi olla merkki kohdistuneesta hyökkäyksestä. Ota yhteyttä kehittäjään tilanteessa, jossa lokissa näkyy epäilyttävää toimintaa.

---

Tunnistamattomat kuvat — yllapito

Tämä osio koskee ylläpitäjiä — sisällöntuottajat voivat ohittaa tämän. Kirjautuminen ja oikeudet on kuvattu yllä osiossa Käyttäjätilit ja oikeudet — tässä keskitytään työkalun välilehtien käyttöön.

Näkyvät välilehdet oikeuksien mukaan:

• Tarkista (oikeus T) — yhteisön ehdotusten tarkistus ja kuvien tunnistus
• Lähetä kuva (oikeus L) — uuden tunnistamattoman kuvan lähettäminen
• Hallitse galleriaa (oikeus G) — julkaistujen gallerioiden hallinta
• Käyttäjät (oikeus I) — IAM-paneeli (ks. yllä)
• Hallitse artikkeleita ↗ (oikeus A) — linkki Sveltia CMS:ään

Uuden tunnistamattoman kuvan lähettäminen

1. Mene Lähetä kuva -välilehdelle
2. Valitse kuvatiedosto (JPEG suositeltu)
3. Täytä alustavat tiedot, jos tiedät jotain:
   • Vuosi (arvio) — esim. “1985” tai “1980-luvun alku”
   • Henkilöt — keitä kuvassa on
   • Paikka — missä kuva on otettu
   • Muu tieto — vapaata tekstiä
4. Klikkaa Lähetä

Kuva ilmestyy heti Tunnista-välilehdelle ja landing-pagen “APUA TARVITAAN” -blokkiin (jos kuvalle on luotu pikkukuva).

Kuvan tunnistaminen yhteisön avulla

Yhteisön jäsenet voivat ehdottaa tietoja kuvalle osoitteessa /fi/tunnistamatta. Ylläpitäjänä tarkistat ehdotukset ja kirjaat lopullisen, oikean tiedon.

Tarkista-välilehden työnkulku

1. Klikkaa kuvaa listasta → modaali avautuu
2. Lue yhteisön ehdotukset alaosassa (jos niitä on)
3. Kirjoita viralliset tiedot lomakekenttiin:
   • Vuosi
   • Henkilöt
   • Paikka
   • Muu tieto
4. Klikkaa Tallenna

Status päivittyy automaattisesti:

Tilanne	Status
Mitään ei ole vielä tunnistettu	Uusi
Osa tiedoista täytetty	Osittain tunnistettu
Vuosi + henkilöt + paikka kaikki täytetty	Tunnistettu

Tunnistetut kuvat voidaan siirtää galleriaan (seuraava kohta).

Julkaiseminen galleriaan

Kun kuvalla on status Tunnistettu, se voidaan julkaista pysyvään galleriaan.

Olemassa olevaan galleriaan

1. Avaa tunnistettu kuva (klikkaa kuvaa Tarkista-välilehdellä)
2. Klikkaa Julkaise Galleriaan
3. Valitse galleria pudotusvalikosta (lista päivittyy automaattisesti)
4. Tarkista kuvateksti (vakiomuoto: henkilöt paikka vuosi) — muokkaa tarvittaessa
5. Klikkaa Julkaise

Kuva siirtyy galleriaan noin 2 minuutissa:

• Julkaisuputki (publish.js) commitoi alkuperäisen kuvan GitHubiin
• GitHub Action luo pikkukuvan ja vesileimatun näyttöversion
• Cloudflare rakentaa sivuston uudelleen
• Kuva ilmestyy galleriaan, häviää tunnistamattomat-listalta

Uuteen galleriaan

1. Klikkaa Julkaise Galleriaan
2. Valitse pudotusvalikosta ➕ Luo uusi galleria…
3. Syötä gallerian nimi (esim. “Suomi 90s”)
4. Tarkista kuvateksti
5. Klikkaa Julkaise

Uusi galleria luodaan automaattisesti, kategorisoidaan slugin perusteella (suomi-90s → kategoria “finland”), ja ensimmäinen kuva lisätään siihen.

---

Galleriat — Hallitse galleriaa

Tämä osio koskee ylläpitäjiä.

Hallitse galleriaa -välilehdellä voit:

• Muokata kuvatekstiä — klikkaa kuvaa, muokkaa kuvatekstiä, tallenna
• Poistaa kuvan galleriasta — klikkaa kuvaa, valitse Poista, vahvista
• Siirtää kuvan toiseen galleriaan — toistaiseksi tehtävä manuaalisesti (Phase D backlogissa, ks. README)

Muutokset (kuvatekstien muokkaukset, poistot) tallentuvat samalla tavalla kuin julkaisut — Git-commit + Cloudflare-build, ~2 minuuttia.

Mitä Hallitse galleriaa ei vielä osaa

Backlogissa olevia, vielä toteuttamattomia ominaisuuksia (Phase D):

• Kuvien uudelleenjärjestäminen galleriassa
• Kokonaisen gallerian poistaminen

Nämä vaativat toistaiseksi manuaalista git-työtä — ota yhteyttä kehittäjään.

---

Yleisimmät tilanteet

”Haluan kirjoittaa uuden MXGP-jutun”

1. https://www.photoandmoto.fi/admin/ → kirjaudu GitHubilla
2. Vasemmalla + Uusi MXGP-juttu
3. Täytä otsikko, alaotsikko, päivämäärä (tämän päivän)
4. Pohja on jo valmiina — täytä omat tiedot
5. Lisää pääkuva (vedä kuva pääkuva-kenttään tai valitse mediakirjastosta)
6. Tallenna
7. Vaihda EN-kieleen ja käännä teksti Geminin avulla (ks. Käännös suomesta englanniksi)
8. Lue käännös läpi ja korjaa kömpelyydet
9. Tallenna

”Haluan että artikkeli näkyy vain suomeksi”

Jätä englanninkielinen versio luomatta. Englanninkielistä tiedostoa ei synny eikä artikkeli näy /en/aikakone/-listassa.

Jos englanninkielinen versio on jo luotu ja haluat poistaa sen — avaa artikkeli, vaihda EN-kieleen, klikkaa Poista artikkeli.

”Haluan korjata vain englanninkielistä versiota”

1. Avaa artikkeli muokattavaksi
2. Vaihda EN-kieleen
3. Tee muutokset
4. Tallenna

Englanninkielinen versio on oma tiedostonsa, joten muutokset koskevat vain sitä. Suomenkielinen versio säilyy ennallaan.

”En pääse kirjautumaan — olen unohtanut salasanan”

Käytä /fi/palauta-salasana/ ja vastaa turvakysymyksiisi (2 / 3 riittää oikein). Jos et muista vastauksiakaan, pyydä ylläpitäjää luomaan sinulle uusi provisiointilinkki Käyttäjät-taulukon Uusi linkki -painikkeella. Tämä nollaa tilisi salasanan ja turvakysymykset; asetat ne uudelleen linkin avatessa.

”Joku väärä kirjautui sisään minun tililläni”

Vaihda salasana välittömästi (palauta-salasana-linkki tai pyydä admin-IAM -oikeuksilla varustettua kollegaa luomaan uusi provisiointilinkki). Ilmoita kehittäjälle, jolloin hän voi tarkistaa Palautuslokin ja istunnot.

”Vahingossa poistin artikkelin — voiko palauttaa?”

Kyllä, mutta se vaatii kehittäjän apua. Sano hänelle:

• Artikkelin slug (URL:n viimeinen osa, esim. mxgp-2026-argentina)
• Suunnilleen mihin aikaan poisto tapahtui

Hän palauttaa artikkelin git revert <commit-sha> -komennolla — noin 30 sekunnin työ.

”Tarvitsen lisätä uuden kategorian”

1. Avaa Kategoriat vasemmalla
2. Klikkaa New Kategoria
3. Täytä:
   • Tunniste (englanniksi, esim. Speedway) — tämä tallennetaan artikkelien tiedostoihin
   • Näytettävä nimi (suomeksi, esim. Speedway) — tämä näkyy pudotusvalikossa
4. Tallenna

⚠️ Älä koskaan muuta olemassa olevan kategorian tunnistetta. Kaikki sitä käyttävät artikkelit lakkaavat näkymästä. Näytettävän nimen voit muuttaa milloin tahansa.

---

Vianetsintä

Sveltia ei lataudu

• Hard-refresh selaimessa: Ctrl+Shift+R
• Tarkista että GitHub-tunnuksellasi on pääsy photoandmoto-organisaatioon
• Jos virhe jää, kerro kehittäjälle tarkalleen mitä näytöllä lukee

Kirjautuminen epäonnistuu

• Yleisin syy: GitHub-tunnuksesi ei ole vielä lisätty pääsylistalle. Pyydä kehittäjää lisäämään.
• Toinen syy: selain estää OAuth-uudelleenohjauksen — kokeile toista selainta tai poista evästeet domainilta

”Tallensin artikkelin mutta se ei näy sivustolla”

Tarkista vaiheittain:

1. Cloudflare deployment — onko build käynnissä tai epäonnistuiko se? https://dash.cloudflare.com → Workers & Pages → photoandmoto → Deployments
2. Onko Piilota sivustolta valittu? — tarkista artikkelin lomakkeesta
3. Mene osoitteeseen suoraan — https://www.photoandmoto.fi/fi/aikakone/<slug>/
4. Selaimen välimuisti — Ctrl+Shift+R refreshaa kovaa

”Englanninkielistä versiota ei ole”

Käännös tehdään käsin — automaattista käännöstä ei enää ole. Jos englanninkielistä versiota ei näy, sitä ei ole vielä luotu. Avaa artikkeli, vaihda EN-kieleen ja käännä teksti Geminin avulla (ks. Käännös suomesta englanniksi), ja tallenna.

”Kuva on liian iso (yli 5 MB)”

Mediakirjasto saattaa hylätä kuvan. Tee jokin näistä:

• Pakkaa kuva ennen latausta (esim. https://squoosh.app)
• Mene Mediakirjastoon, lataa pienempi versio
• Kerro kehittäjälle — automaattipakkausta voidaan virittää

Jokin muu menee pieleen

Kerro kehittäjälle:

1. Mitä yritit tehdä
2. Mitä näytöllä lukee (kuvakaappaus on paras)
3. Suunnilleen mihin aikaan ongelma alkoi

---

Päivitykset tähän käsikirjaan

Tämä dokumentti on JULKAISIJAN_OHJEET.md repon juuressa. Päivittäminen:

1. Muokkaa tiedostoa joko paikallisesti tai GitHubin web-editorissa
2. Commitoi muutos
3. Sivun /fi/julkaisijan-ohjeet/ sisältö päivittyy automaattisesti seuraavan buildin yhteydessä (~2 min)

Jos näet käsikirjassa vanhentunutta tietoa tai puutteita, päivitä se itse tai kerro kehittäjälle.

---

Viimeksi päivitetty: kesäkuu 2026 (Sveltia CMS; tallenna → esikatselu → Julkaise tuotantoon; poistot automaattisesti tuotantoon; FI pakollinen, EN vapaaehtoinen)