Simulan sa Tagalog

Maligayang pagdating sa Ze — isang programming language na maaari mong isulat sa English, Tagalog, Bisaya, o halo ng tatlo.

1. Mga Kinakailangan

Ang Ze ay ginawa gamit ang Go. Kailangan mong i-install ang Go bago mo ma-build o patakbuhin ang Ze.

I-install ang Go

1. Pumunta sa https://go.dev/dl/
2. I-download ang installer para sa iyong operating system:
   • Windows — i-download ang .msi installer at patakbuhin ito
   • macOS — i-download ang .pkg installer at patakbuhin ito
   • Linux — sundin ang mga instruksyon sa download page
3. Pagkatapos ng installation, buksan ang terminal at suriin kung naka-install na ang Go:

go version

Dapat mong makita ang isang bagay tulad ng go version go1.21.0 .... Anumang bersyon na 1.21 pataas ay gagana.

2. Kunin ang Source Code ng Ze

Opsyon A — Kung mayroon ka nang folder

Buksan ang terminal at pumunta sa folder:

cd landas/patungo/sa/Ze

Opsyon B — I-clone mula sa Git

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

3. I-build ang Ze

Sa loob ng project folder, patakbuhin:

go build -o bin/ze .

Gagawa ito ng isang executable file na tinatawag na bin/ze (o bin/ze.exe sa Windows).

Para masuri kung tama ang pagkaka-build:

./bin/ze -version

4. Patakbuhin ang Iyong Unang Programa

Gumawa ng file na tinatawag na kamusta.ze na may ganitong nilalaman:

itakda pangalan = "Mundo"
ipakita "Kamusta, " + pangalan + "!"

Patakbuhin ito:

./bin/ze kamusta.ze

Output:

Kamusta, Mundo!

5. Subukan ang Interactive REPL

Patakbuhin ang Ze nang walang mga argumento para magsimula ng interactive shell:

./bin/ze

Mag-type ng code at pindutin ang Enter:

>> itakda x = 5
>> ipakita x * 3
15
>> ipakita "Mabuhay!"
Mabuhay!

Pindutin ang Ctrl-C para lumabas.

6. Patakbuhin ang mga Halimbawang File

Ang examples/ folder ay naglalaman ng mga handa nang programa:

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

7. (Opsyonal) Idagdag ang Ze sa Iyong PATH

Para mapatakbo ang Ze mula sa anumang folder nang hindi kailangang mag-type ng ./:

Windows:

1. Ilipat ang Ze.exe sa isang folder na nasa PATH na (hal. a personal tools folder on PATH), o
2. Idagdag ang project folder sa iyong PATH sa pamamagitan ng System Settings -> Environment Variables.

macOS / Linux:

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

Pagkatapos ay maaari mong patakbuhin ang Ze mula sa kahit saan.

8. (Opsyonal) Simulan ang Web Server

Ang Ze ay maaaring mag-serve ng mga .ze file bilang mga web page:

./bin/ze -web -dir examples

Buksan ang iyong browser at bisitahin ang http://localhost:8080.

9. Sumulat ng Sariling Programa

• Ang mga source file ay dapat magtatapos sa .ze
• Ang mga bloke ay binubuksan gamit ang : at ini-indent (tulad ng Python)
• Maaari kang gumamit ng English, Tagalog, o Bisaya na mga keyword — o halo ang tatlo

# aking_programa.ze
itakda edad = 20

kung edad ay hindi bababa sa 18:
    ipakita "Maaari kang bumoto."
kundi:
    ipakita "Masyadong bata para bumoto."

Patakbuhin ito:

./bin/ze aking_programa.ze

10. Matuto Pa

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