diff --git a/docs/src/pages/fi-FI/getting-started.md b/docs/src/pages/fi-FI/getting-started.md new file mode 100644 index 000000000..d057ef1b0 --- /dev/null +++ b/docs/src/pages/fi-FI/getting-started.md @@ -0,0 +1,59 @@ +--- +layout: ~/layouts/Main.astro +title: Aloittaminen +--- + +Astro on moderni työkalu staattisten sivustojen luomiseen. Voit löytää lisätietoa Astrosta englanniksi [kotisivultamme](https://astro.build/) tai [julkistusviestistämme](https://astro.build/blog/introducing-astro). Tämä sivu on yleiskatsaus Astron dokumentaatioon ja liittyviin sisältöihin. + +Haluatko nähdä nopean yleiskatsauksen siitä mikä Astro on? [Tutustu kotisivuumme.](https://astro.build) + +## Kokeile Astroa + +Helpoin tapa kokeilla Astroa on suorittaa `npm init astro` uudessa hakemistossa omalla koneellasi. Tämä CLI-komento käy lävitse tarvittavat vaiheet uuden Astro-projektin alkuunsaattamiseksi. + +[Asennusoppaastamme](/installation) löydät täyden läpikäynnin Astron saamiseksi käyttökuntoon. + +### Netin leikkikentät + +Sikäli jos sinua kiinnostaa kokeilla Astroa selaimessa, voit käyttää leikkikenttää netissä. Kokeile Hello World -templaattia [CodeSandboxissa](https://codesandbox.io/s/astro-template-hugb3). + +_Huomaa: jotkin toiminnallisuudet (mm. nopea päivitys) ovat toistaiseksi rajallisia CodeSandboxissa._ + +## Astron oppiminen + +Ihmisillä on monenlaisia taustoja ja erilaisia oppimistyylejä. Toivomme sinun saavan irti tästä osiosta riippumatta siitä oletko enemmän teoriatason vaiko käytännön tason oppija. + +- Jos suosit **oppimista tekemällä**, kokeile aloittaa [esimerkkikirjastostamme](https://github.com/snowpackjs/astro/tree/main/examples). +- Jos suosit **konseptien oppimista vaihe vaiheelta**, kokeile aloittaa [peruskonsepteista ja oppaista](/core-concepts/project-structure). + +Astrolla on oma oppimiskäyränsä kuten millä tahansa ennestään tuntemattomalla teknologialla. Harjoittelulla ja kärsivällisyydellä _tulet_ pääsemään asioista kärryille. + +### `.astro`-syntaksin oppiminen + +Aloittaessasi Astrolla tulet kohtaamaan monia `.astro`-päätteellisiä tiedostoja. Nämä sisältävät **Astro-komponenttien syntaksia**, joka on erityistä HTML:n kaltaista templaattikieltä, jota Astro käyttää. Se on suunniteltu olemaan tuttu kenelle tahansa, jolla on kokemusta HTML:stä tai JSX:stä. + +Oppaamme [Astron komponenteista](/core-concepts/astro-components) esittelee uuden syntaksin ja on paras paikka sen opiskelulle. + +### API-luettelo + +Tämä dokumentaation osa on hyödyllisin halutessasi oppia yksityiskohtia tietystä Astron rajapinnasta. Muun muassa [asetusluettelo](/reference/configuration-reference) listaa kaikki mahdolliset asetusvaihtoehdot. [Ydinkomponenttien luettelo](/reference/builtin-components) listaa kaikki käytössä olevat Astron mukana tulevat komponentit kuten `` ja ``. + +### Dokumentaation versioinnista + +Tämä dokumentaatio edustaa aina Astron viimeisintä vakaata versiota. Saavutettuamme v1.0 virstanpylvään tulemme lisäämään mahdollisuuden tarkastella versioitua dokumentaatiota. + +## Pysyminen ajantasalla + +Twitterin [@astrodotbuild](https://twitter.com/astrodotbuild)-tunnus on virallinen lähde Astro-tiimin päivityksille. + +Tulemme kertomaan julkaisuista myös [Discord-yhteisössä](https://astro.build/chat) kanavalla #announcements. + +Kaikki Astro-julkaisut eivät tule olemaan oman blogikirjoituksensa arvoisia, mutta löydät yksityiskohtaisen muutoslokin jokaiselle julkaisulle [`CHANGELOG.md`-tiedostosta Astron repossa](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md). + +## Puuttuuko jotakin? + +Mikäli havaitset puutteita dokumentaatiossa tai että osa siitä ovat hämmentäviä, jätäthän [ilmoituksen dokumentaation ongelmasta](https://github.com/snowpackjs/astro/issues/new/choose) sisältäen ehdotuksesi sen parantamiseksi, tai twiittaa [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-tunnukselle. Otamme palautetta vastaan mielellämme! + +## Kiitokset + +Tämä aloittamisen opas perustui alkujaan [Reactin](https://reactjs.org/) vastaavaan oppaaseen. diff --git a/docs/src/pages/fi-FI/installation.md b/docs/src/pages/fi-FI/installation.md new file mode 100644 index 000000000..ed003bbe5 --- /dev/null +++ b/docs/src/pages/fi-FI/installation.md @@ -0,0 +1,92 @@ +--- +layout: ~/layouts/Main.astro +title: Asennus +--- + +Astron voi asentaa parilla eri tavalla uuteen projektiin. + +## Vaatimukset + +- **Node.js** - `v12.20.0`, `v14.13.1`, `v16.0.0` tai uudempi. +- **Tekstieditori** - Suosittelemme [VS Codea](https://code.visualstudio.com/) yhdessä [Astro-laajennoksen](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) kanssa. +- **Terminaali** - Astroa käytetään pääasiassa komentorivin kautta. + +## Suositeltu asennus + +`npm init astro` on helpoin tapa lisätä Astro uuteen projektiin. Komennon suorittaminen terminaalissa aloittaa `create-astro`-asennusvelhon, joka käy lävitse uuden projektin aloituksen. + +```bash +mkdir +cd +npm init astro +``` + +Seuraa CLI-ohjelman ohjeistusta asentaaksesi Astron käyttäen yhtä virallisista aloitustemplaateista. + +Tämän jälkeen voit siirtyä [pika-aloitusoppaaseen](/quick-start#start-your-project) saadaksesi 30:n sekunnin yhteenvedon siitä, kuinka käynnistää uusi projekti kehittämistä varten, ja kuinka luoda siitä lopullinen sivusto! + +## Asentaminen itse + +### Projektin valmistelu + +Luo uusi tyhjä hakemisto jolla on projektisi nimi ja siirry siihen: + +```bash +mkdir +cd +# Huomaa: korvaa projektisi nimellä. +``` + +Luo uusi `package.json`-tiedosto projektille. Astro on suunniteltu toimimaan npm-ympäristössä, jota hallinnoidaan `package.json` sisältämien sääntöjen kautta. Mikäli `package.json` ei ole ennestään tuttu, niin suosittelemme tutustumaan [npm:n dokumentaatioon](https://docs.npmjs.com/creating-a-package-json-file). + +```bash +# Tämä komento luo uuden package.json-tiedoston sisältäen muutaman peruskentän +npm init --yes +``` + +### Asenna Astro + +Sinulla tulisi olla nyt hakemisto, josta löytyy yksittäinen `package.json`-tiedosto kun aiemmin mainitut toimet on tehty. Astron lisääminen projektiin on nyt mahdollista. + +Käytämme `npm`:ää esimerkeissämme, mutta vaihtoehtoisesti voit myös käyttää `yarn`:ia tai `pnpm`:ää. Sikäli jos kumpikaan `yarn` tahi `pnpm` ei ole tuttu, niin suosittelemme pitäytymistä `npm`:ssä. + +```bash +npm install astro +``` + +Voit nyt vaihtaa oletuksena toimivan "scripts"-osion `npm init`in luomassa `package.json`:ssa seuraavasti: + +```diff + "scripts": { +- "test": "echo \"Error: no test specified\" && exit 1" ++ "start": "astro dev", ++ "build": "astro build" + }, +} +``` + +### Lisää ensimmäinen sivu + +Avaa tekstieditori ja luo uusi tiedosto projektiin: + +```astro +--- +// 1. Luo uusi tiedosto /src/pages/index.astro +// 2. Kopioi ja liitä tämä koko tiedosto (sisältäen `-` väliviivat) siihen. +--- + + +

Moi maailma!

+ + +``` + +Voit nyt lisätä uusia sivuja `src/pages`-hakemistoon Astron käyttäessä ennettua tiedostonimeä luodakseen uusia sivuja sivustolle. Jos esimerkiksi luot uuden tiedoston nimellä `src/pages/about.astro` (käyttäen edellistä koodia), niin Astro luo uuden sivun osoitteeseen `/about`. + +### Seuraavat vaiheet + +Näin se hoituu! Olet nyt valmis aloittamaan kehittämisen! Siirry [pika-aloitusoppaaseen](/quick-start#start-your-project) saadaksesi 30:n sekunnin läpikäynnin Astron käynnistämisestä ja projektin luomisesta sivustoksi! + +📚 Opi lisää Astron projektien rakenteesta [projektin rakenneoppaassa](/core-concepts/project-structure). +📚 Opi lisää Astron komponenttien syntaksista [Astro-komponenttien oppaassa](/core-concepts/astro-components). +📚 Opi lisää Astron tiedostoihin pohjautuvasta reitityksestä [reititysoppaassa](core-concepts/astro-pages). diff --git a/docs/src/pages/fi-FI/quick-start.md b/docs/src/pages/fi-FI/quick-start.md new file mode 100644 index 000000000..a17284855 --- /dev/null +++ b/docs/src/pages/fi-FI/quick-start.md @@ -0,0 +1,50 @@ +--- +layout: ~/layouts/Main.astro +title: Pika-aloitus +--- + +```shell +# vaatimukset: varmista että Node.js on vähintään versiota 12.20.0+, 14.13.1+ tai 16+ +node --version + +# luo uuden projektin hakemisto ja siirry siihen +mkdir astrokokeilu && cd "$_" + +# valmistaudu laukaisuun... +npm init astro + +# asenna riippuvuudet +npm install + +# aloita kehittäminen! +npm start + +# kun olet valmis: luo oma staattinen sivustosi hakemistoon `dist/` +npm run build +``` + +Astro-sivuston käyttöönotto tuotannossa vaatii `/dist`-hakemiston (joka luodaan suorittamalla `npm run build`) sisällön siirtämisen haluamallesi palveluntarjoajalle. + +[Luo lisää tästä Astron julkaisuoppaassa.](/guides/deploy) + +## Projektin käynnistäminen + +Siirry takaisin komentoriville ja suorita tämä komento projektin hakemistossa: + +```bash +npm start +``` + +Tämän jälkeen ohjelma on käynnissä osoitteessa [http://localhost:3000](http://localhost:3000). Avaa tämä URL selaimessa nähdäksesi viestin "Moi maailma!", jonka kopioimme edellisessä vaiheessa. + +Astro seuraa muutoksia `src/`-hakemiston sisällä, joten ohjelmaa ei tarvitse käynnistää uudelleen tehdessäsi muutoksia siihen koodatessasi. + +## Sivuston luominen + +Palaa takaisin komentoriville ja suorita tämä komento projektin hakemistossa: + +```bash +npm run build +``` + +Tämä muodostaa projektista valmiit sivuston tiedostot ja kirjoittaa ne `dist/`-hakemistoon. Astro-sivustot ovat staattisia, joten ne voi julkaista mille tahansa palveluntarjoajalle (Vercel, Netlify, S3 bucket, jne.).