diff --git a/GettingStarted.ms.md b/GettingStarted.ms.md new file mode 100644 index 0000000..49e2fe8 --- /dev/null +++ b/GettingStarted.ms.md @@ -0,0 +1,42 @@ + + +> Ini ialah terjemahan [`GettingStarted`](GettingStarted). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya. + +[English](GettingStarted) | [Dansk](GettingStarted.da) | Bahasa Melayu + +# Bermula + +## Keperluan + +| Alat | Digunakan untuk | +| --- | --- | +| bash 4.4 atau lebih baharu | skrip (macOS dibekalkan dengan 3.2: pasang bash yang lebih baharu dahulu) | +| `git` | projek tempatan dan submodul framework | +| `curl` | API GitHub dan Gitea | +| `ssh` (pilihan) | semakan SSH; tanpanya langkah framework dilangkau | +| `jq` (pilihan) | penghuraian JSON; tanpanya pembaca terbina dalam yang kecil digunakan | + +## Pemasangan + +```bash +git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git +cd repo-foundry +src/create-project.sh --help +``` + +Tiada apa-apa dipasang pada seluruh sistem: skrip berjalan dari checkout. + +## Konfigurasi + +Salin `config.env.example` ke `config.env` dan `.env.example` ke `.env`, kemudian tetapkan alamat perkhidmatan dan token (lihat [SSH dan token](SshAndTokens.ms)). `.env` mengandungi kelayakan (credentials) dan tidak pernah di-commit. + +## Larian + +Mulakan skrip dari folder yang akan menyimpan projek baharu: + +```bash +src/create-project.sh # larian percubaan: membaca dari hos, tidak mencipta apa-apa +src/create-project.sh --apply # mencipta semuanya selepas ya terakhir +``` + +Tiada commit dibuat dalam projek baharu. Bekerja pada branch di sana: hook framework menolak commit pada `main`.