WIP: Documentation in Finnish (#837)
* Initial Finnish getting-started.md * Initial Finnish `quick-start.md` * Missing word * Use a different test path name * Initial Finnish `installation.md` * Sync with `installation.md` * WIP Finnish island-architecture.md * Fix some sillyness * Delete island-architecture.md Co-authored-by: Fred K. Schott <fkschott@gmail.com>
This commit is contained in:
parent
5e9a47ffbc
commit
d55fe81d10
3 changed files with 201 additions and 0 deletions
59
docs/src/pages/fi-FI/getting-started.md
Normal file
59
docs/src/pages/fi-FI/getting-started.md
Normal file
|
@ -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 `<Markdown />` ja `<Prism />`.
|
||||
|
||||
### 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.
|
92
docs/src/pages/fi-FI/installation.md
Normal file
92
docs/src/pages/fi-FI/installation.md
Normal file
|
@ -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 <projektin-nimi>
|
||||
cd <projektin-nimi>
|
||||
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 <projektin-nimi>
|
||||
cd <projektin-nimi>
|
||||
# Huomaa: korvaa <projektin-nimi> 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 <projektin-hakemisto>/src/pages/index.astro
|
||||
// 2. Kopioi ja liitä tämä koko tiedosto (sisältäen `-` väliviivat) siihen.
|
||||
---
|
||||
<html lang="fi">
|
||||
<body>
|
||||
<h1>Moi maailma!</h1>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
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).
|
50
docs/src/pages/fi-FI/quick-start.md
Normal file
50
docs/src/pages/fi-FI/quick-start.md
Normal file
|
@ -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.).
|
Loading…
Reference in a new issue