Sugdi sa Bisaya

Maayong pag-abot sa Ze — usa ka programming language nga mahimo nimong isulat sa English, Tagalog, Bisaya, o sagol sa tanan.

1. Mga Kinahanglanon

Ang Ze gihimo gamit ang Go. Kinahanglan nimong i-install ang Go sa imong computer sa wala pa nimo ma-build o mapadagan ang Ze.

I-install ang Go

1. Adto sa https://go.dev/dl/
2. I-download ang installer alang sa imong operating system:
   • Windows — i-download ang .msi installer ug padagana kini
   • macOS — i-download ang .pkg installer ug padagana kini
   • Linux — sundon ang mga instruksyon sa download page
3. Human sa pag-install, ablihi ang terminal ug susihon kung na-install na ang Go:

go version

Kinahanglan nimong makita ang usa ka butang sama sa go version go1.21.0 .... Bisan unsang bersyon nga 1.21 o mas bag-o molihok.

2. Kuhaon ang Source Code sa Ze

Opsyon A — Kung naay folder ka na

Ablihi ang terminal ug adto sa folder:

cd dalan/paingon/sa/Ze

Opsyon B — I-clone gikan sa Git

git clone https://github.com/Berlindraft/Ze.git
cd Ze

3. I-build ang Ze

Sulod sa project folder, padagana:

go build -o bin/ze .

Maghimo kini ug usa ka executable file nga ginganlan ug bin/ze (o bin/ze.exe sa Windows).

Aron masusi kung husto ang pag-build:

./bin/ze -version

4. Padagana ang Imong Unang Programa

Buhata ug file nga ginganlan ug kumusta.ze nga adunay niini nga sulod:

ibutang ngalan = "Kalibutan"
ipakita "Kumusta, " + ngalan + "!"

Padagana kini:

./bin/ze kumusta.ze

Output:

Kumusta, Kalibutan!

5. Sulayi ang Interactive REPL

Padagana ang Ze nga walay mga argumento aron magsugod ug interactive shell:

./bin/ze

Mag-type ug code ug pinduta ang Enter:

>> ibutang x = 5
>> ipakita x * 3
15
>> ipakita "Padayon!"
Padayon!

Pinduta ang Ctrl-C aron mobiya.

6. Padagana ang mga Pananglitan nga File

Ang examples/ folder adunay mga andam na programa:

./bin/ze examples/hello.ze
./bin/ze examples/counter.ze

7. (Opsyonal) Idugang ang Ze sa Imong PATH

Aron mapadagan ang Ze gikan sa bisan unsang folder nga dili kinahanglan mag-type ug ./:

Windows:

1. Ibalhin ang Ze.exe sa usa ka folder nga anaa na sa PATH (pananglitan a personal tools folder on PATH), o
2. Idugang ang project folder sa imong PATH pinaagi sa System Settings -> Environment Variables.

macOS / Linux:

sudo mv ./bin/ze /usr/local/bin/Ze

Human niana mahimo nimong padagana ang Ze gikan sa bisan diin.

8. (Opsyonal) Sugdan ang Web Server

Ang Ze mahimo mag-serve ug mga .ze file ingon nga mga web page:

./bin/ze -web -dir examples

Ablihi ang imong browser ug bisitaha ang http://localhost:8080.

9. Sulat sa Imong Kaugalingong Programa

• Ang mga source file kinahanglan magtapos sa .ze
• Ang mga bloke giablihan gamit ang : ug gi-indent (sama sa Python)
• Mahimo kang mogamit ug English, Tagalog, o Bisaya nga mga keyword — o sagola ang tanan

# akong_programa.ze
ibutang edad = 20

kung edad dili moubos sa 18:
    ipakita "Pwede ka moboto."
kung_dili:
    ipakita "Bata pa kaayo para moboto."

Padagana kini:

./bin/ze akong_programa.ze

10. Pagkat-on Pa

For Windows builds, use go build -o bin/ze.exe . and .\bin\ze.exe when running commands.