Vad du ska göra (superenkelt)
Du ska göra tre saker:
- Installera Node.js
- Ladda ner AstroPaper som en vanlig mapp på din dator
- Öppna ett kommandofönster, skriva två kommandon och sedan öppna webbläsaren
Du behöver inte Visual Studio Code. Du kan öppna filer i Anteckningar (Notepad) om du vill ändra text.
Kort ordlista (vad sakerna betyder)
- Astro: Ett verktyg/ramverk för att bygga webbplatser. Astro skapar sidor som blir snabba att ladda och passar bra för bloggar och innehåll.
- AstroPaper: En färdig webbplats-mall byggd med Astro. Den innehåller struktur, design och exempel-innehåll så att du snabbt kan komma igång.
- Node.js: Ett program som gör att din dator kan köra JavaScript-verktyg lokalt. AstroPaper behöver Node.js för att kunna installeras och startas.
- PowerShell: Ett kommandofönster i Windows där du kan skriva kommandon, till exempel för att gå till rätt mapp och starta sajten.
- ZIP: En ”paketerad” fil (komprimerad) som innehåller en hel mapp med filer. När du laddar ner som ZIP behöver du packa upp den för att få en vanlig mapp.
- Git: Ett verktyg för versionshantering (”spara historik” och spåra ändringar i filer). Det används ofta av utvecklare.
- Repo (repository): Själva projektet – en mapp med alla filer som hör ihop. På GitHub kallas ett projekt ofta för ett ”repo”.
- GitHub: En webbplats där projekt (repo) kan ligga online. AstroPaper ligger på GitHub.
- Markdown (MD): Ett enkelt textformat där du skriver med lättlästa tecken (t.ex. # för rubriker) och som sedan automatiskt omvandlas till formaterad text på webben.
I den här guiden använder vi inte Git aktivt – vi laddar ner AstroPaper som ZIP för att göra det så enkelt som möjligt.
Steg 1: Installera Node.js
AstroPaper behöver Node.js för att kunna starta lokalt.
- Öppna webbläsaren
- Gå till Node.js: https://nodejs.org
- Ladda ner LTS och installera (nästa, nästa, nästa fungerar bra)
Efter installationen är du redo.
Steg 2: Ladda ner AstroPaper (utan Git)
Det här är enklaste sättet om du är ny.
- Öppna webbläsaren
- Gå till AstroPaper på GitHub: https://github.com/satnaing/astro-paper
- Klicka på Code
- Välj Download ZIP
- Packa upp zip-filen till en plats du hittar lätt
Exempel på en enkel plats:
C:\solopreneur\astro-paper
Viktigt: “solopreneur” i exemplet är bara ett mappnamn jag valde på min dator. Tänk på det som ”din projektmapp”. Du kan lika gärna använda t.ex.:
C:\mina-sajter\astro-paper
D:\projekt\astro-paper
Välj en sökväg du själv tycker är enkel att hitta.
När du är klar ska du ha en mapp som innehåller filer som heter till exempel package.json och en mapp som heter src.
Steg 3: Öppna PowerShell
Du ska nu öppna ett fönster där man kan skriva kommandon.
- Klicka på Start-menyn
- Skriv: PowerShell
- Öppna Windows PowerShell
Ett blått eller svart fönster öppnas.
Steg 4: Gå till rätt mapp (viktigast)
Först måste du stå i rätt katalog (mapp) innan du startar sidan.
Skriv detta i PowerShell och tryck Enter:
cd C:\solopreneur\astro-paper
Viktigt: Byt ut sökvägen ovan mot din egen. Om du valde en annan mapp i Steg 2, ska cd-kommandot peka på den mappen.
Kontrollera att du står rätt genom att skriva:
dir
Du ska nu se en lista med filer. Leta efter:
package.json
src
public
Om du inte ser dem så står du i fel mapp.
Om du står i fel mapp
Gå upp en nivå:
cd ..
Gå in i en mapp (exempel):
cd astro-paper
Kör sedan dir igen tills du ser package.json.
Steg 5: Första gången: förbered projektet
Det här gör du bara första gången i en ny AstroPaper-mapp.
Skriv:
npm install
Det kan ta en stund. När den är klar får du tillbaka en ny rad där du kan skriva igen.
Steg 6: Starta sidan lokalt
Skriv:
npm run dev
Efter några sekunder kommer PowerShell skriva ut en adress som börjar med http://localhost.
Vanligt är:
http://localhost:4321
Steg 7: Öppna sidan i webbläsaren
- Öppna Chrome (eller valfri webbläsare)
- Skriv exakt adressen som stod i PowerShell
Exempel:
http://localhost:4321
Nu ska du se AstroPaper-sidan lokalt på din dator.
Steg 8: Stoppa sidan
Gå tillbaka till PowerShell-fönstret och tryck:
Ctrl + C
Så ser en enkel filstruktur ut (vad som är vad)
När du tittar i mappen (i Utforskaren) ser du ungefär detta:
astro-paper/
public/
src/
pages/
data/
blog/
package.json
astro.config.mjs
Det du behöver veta som nybörjare:
src/data/blog/ → innehåller inlägg i Markdown
public/ → innehåller bilder och andra statiska filer
Gör en enkel ändring (utan utvecklarverktyg)
Låt sidan fortsätta vara igång (npm run dev ska fortfarande rulla i PowerShell).
- Öppna Utforskaren och gå till
src/data/blog/ - Högerklicka på en
.md-fil - Välj Öppna med
- Välj Anteckningar (Notepad)
- Ändra en rad text och spara
- Gå till webbläsaren och uppdatera sidan
Om du ser ändringen är allt korrekt uppsatt.
Så gjorde jag när jag startade Solopreneur
Jag började exakt så här: först få upp defaultsidan lokalt, sedan göra en liten textändring för att bevisa att allt fungerade. Efter det började jag byta ut innehåll, lägga in egna guider och bygga vidare steg för steg.