Støtteside og full guide

Denne siden er laget som en praktisk opplæring i hvordan du skriver kode i Norscode. Her får du en komplett oversikt over funksjoner, variabler, betingelser, løkker, lister, standardbibliotek, GUI og hvordan du kjører og tester prosjekter.

Hva du lærer

Hvordan du skriver funksjoner, bruker variabler, bygger logikk og setter sammen små og store prosjekter i Norscode.

Målgruppe

For deg som vil lære språket fra bunnen av, eller som vil ha en tydelig guide til funksjoner, struktur og arbeidsflyt.

Verktøy

CLI, Studio, standardbibliotek, test-runner, standalone binary og web-startmaler.

Resultat

Et språk som er enkelt å lese, enkelt å teste og enkelt å bygge videre på.

Start her Les funksjoner og variabler først, gå videre til betingelser og løkker, og bruk deretter lister, GUI og web for å bygge små prosjekter.

Kapittel	Hva det handler om
1. Funksjoner	Gjenbrukbar logikk og tydelige blokker.
2. Variabler og typer	Data, typer og enkle byggesteiner.
3. Betingelser	Valg med `hvis` og `ellers`.
4. Løkker	Gjenta med `for` og `mens`.
5. Lister	Samle og bearbeide flere verdier.
6. GUI og web	Lag små apper og statiske sider.

Kjapp vei

Hvis du vil bygge noe raskt, start med en funksjon som skriver tekst, legg til en variabel, og bygg så på med en betingelse.

Les mønstre

Se etter navngiving, små funksjoner og tydelig returverdier. Det er den raskeste måten å lære å lese Norscode på.

Prøv selv

Kopier ikke bare eksempler. Skriv dem om med egne navn og egne data.

1. Funksjoner

Funksjoner samler oppgaver i egne blokker. Du bruker dem til å bygge klar og gjenbrukbar kode. En funksjon kan ta inn verdier, gjøre arbeid og returnere noe tilbake.

Eksempel

funksjon si_hei(navn: tekst) -> tekst {
    returner "Hei, " + navn + "!"
}

funksjon start() -> heltall {
    skriv_ut(si_hei("Nora"))
    returner 0
}

Tips

Gi funksjoner navn som beskriver hva de gjør. Bruk små funksjoner for små oppgaver, og kombiner dem heller enn å skrive alt i én stor blokk.

En funksjon bør være lett å lese uten å hoppe rundt i filen. Det gjør vedlikehold mye enklere.

2. Variabler og typer

Variabler holder på data. I Norscode bruker vi tydelige typer når det er nyttig, og vi prøver å holde variabelnavn korte, men forståelige.

Variabler

la antall: heltall = 3
la navn: tekst = "Norscode"
la aktiv: boolsk = sann

Typevalg

Bruk heltall for tall uten desimaler, tekst for tekst, boolsk for sann/usann, og lister når du vil samle flere verdier i én struktur.

3. Betingelser

Bruk hvis når koden skal velge mellom to eller flere veier. Dette er kjernen i logikk, valg og kontrollflyt.

Eksempel

hvis antall > 2 {
    skriv_ut("Vi har nok eksempler")
} ellers {
    skriv_ut("Legg til mer innhold")
}

Slik tenker du

Start med å spørre: Hva er betingelsen? Hva skjer hvis den er sann? Hva skjer hvis den er usann? Da blir koden mye lettere å lese og teste.

4. Løkker

Løkker brukes når du vil gjøre noe flere ganger. Du kan bruke både for og mens avhengig av om du vet hvor mange runder du trenger.

For og mens

for tall i tall_liste {
    skriv_ut(tall)
}

mens aktiv {
    skriv_ut("Kjøring pågår")
    aktiv = usann
}

Praktisk bruk

Bruk for når du vil gå gjennom en liste eller en rekke tall. Bruk mens når du vil fortsette helt til en tilstand endrer seg.

5. Lister og samlinger

Lister er nyttige når du vil jobbe med mange verdier i en ryddig struktur. De passer godt til navn, tall, oppgaver og resultater.

Eksempel

la navn_liste: liste[tekst] = ["Ada", "Linus", "Nora"]
sett_inn(navn_liste, "Sindre")
skriv_ut(hent(navn_liste, 0))

Tips

Bruk lister når du skal iterere, filtrere eller vise data. Det gjør koden mer strukturert enn mange enkeltvariabler.

6. Tekst og små hjelpefunksjoner

Tekst er en stor del av Norscode-arbeid, både i CLI, Studio og web-generering. Derfor er tekstverktøy viktige i standardbiblioteket.

En liten hjelpefunksjon

funksjon gjenta(tekstverdi: tekst, antall: heltall) -> tekst {
    la resultat: tekst = ""
    for i i rekke(antall) {
        resultat = resultat + tekstverdi
    }
    returner resultat
}

Hva du bør huske

La funksjoner gjøre én ting. Hvis de både beregner, skriver til skjerm og endrer filer, blir de vanskeligere å teste og vedlikeholde.

7. Standardbibliotek og GUI

Norscode bruker standardbiblioteket til GUI, web, tekst og verktøy som gjør språket nyttig i praksis. GUI-delen brukes av Studio og andre lokale programmer.

GUI

bruk std.gui som gui

funksjon start() -> heltall {
    la vindu = gui.vindu("Norscode Demo")
    la knapp = gui.knapp("Kjør")
    gui.vis(vindu)
    returner 0
}

Web

bruk std.web som web

funksjon start() -> heltall {
    skriv_fil("docs/index.html", web.bootstrap_html("Norscode"))
    returner 0
}

8. Admin og tilgang i kode

For nettsider og verktøy som trenger innlogging, roller eller et adminområde, bruker du vanlig web- eller appkode rundt Norscode-kjernen. Denne delen av guiden forklarer hvordan du tenker om innlogging, roller, CMS, brukeradministrasjon og rettighetsstyring når du bygger et slikt system.

Innlogging

Lag en tydelig innloggingsflyt, oppbevar en sesjon eller token trygt, og skill mellom offentlig og beskyttet innhold.

Roller

Bruk roller som admin, editor og bruker for å styre hva folk kan se og gjøre.

Admin-dashboard

Bygg en egen adminflate for sider, innhold, brukere og status. Den kan være en webside eller et GUI-vindu.

CMS

Håndter innhold som data, ikke som hardkodede sider. Da kan du liste, redigere og publisere fra en egen administrasjonsflyt.

Brukeradministrasjon

Vis brukere, legg til redaktører, slå av tilgang og vis hvem som er aktiv. Hold brukerdata og innhold adskilt.

Rettighetsstyring

Gi skrive-, lese- og adminrettigheter på en tydelig måte. Sjekk rettigheter før du lar noen endre innhold eller tilgang.

En enkel modell

funksjon kan_redigere(rolle: tekst) -> boolsk {
    hvis rolle == "admin" {
        returner sann
    } ellers hvis rolle == "editor" {
        returner sann
    } ellers {
        returner usann
    }
}

Praktisk råd

Start enkelt: først innlogging, så roller, så et adminpanel. Når det fungerer, kan du bygge et CMS-lag oppå det og utvide med flere rettigheter.

9. Arbeidsflyt i praksis

En god arbeidsflyt gjør koding lettere. Vi bruker Studio til redigering og navigasjon, CLI til kjøring og testing, og binary når vi skal dele eller kjøre uten å tenke på miljøet rundt.

Vanlig rekkefølge

norcode run app.no
norcode check app.no
norcode test
make binary

Bygg en liten app

funksjon start() -> heltall {
    la navn: tekst = les_inn("Ditt navn")
    skriv_ut("Hei, " + navn)
    returner 0
}

10. Hvordan lære raskt

Les kodeLes små eksempler først. Ikke start med de største filene når du lærer språket.

Skriv selvKopier ikke bare eksempler. Skriv dem om med egne navn og egne data.

Test ofteBruk norcode test og små check-kjøringer for å få raske tilbakemeldinger.

Bygg småttLag små funksjoner, små lister og små app-steg før du bygger større systemer.

11. Start med dette

Hvis du er ny, anbefaler vi denne rekkefølgen: funksjoner, variabler, betingelser, løkker, lister, standardbibliotek, og så Studio. Deretter kan du begynne å bygge små verktøy, demoer og GUI-apper.

Først

Lær funksjon, la, hvis, for og mens. Da har du det meste du trenger for å forstå små programmer.

Så

Prøv en liten CLI-app, og flytt den deretter inn i Studio for bedre navigasjon og refaktorering.

Deretter

Bruk GUI- og web-standardbiblioteket for å lage noe konkret som faktisk kan vises og brukes.

Til slutt

Bygg, test og forbedre smått og ofte. Det er slik du lærer både språket og verktøyene best.