Skip to content

Latest commit

 

History

History
146 lines (97 loc) · 6.05 KB

MELAYU.md

File metadata and controls

146 lines (97 loc) · 6.05 KB

README

Jadual Darab - Latihan Pengiraan Mental

Sebuah program untuk membantu anda dengan pengiraan mental

Projek ini adalah aplikasi untuk membantu semua orang berlatih pengiraan mental. Ia mempunyai mod untuk berlatih dan bermain serta pelbagai ciri. Selain itu, ia adalah percuma sepenuhnya dan sumber terbuka.

Isi Kandungan

Gambaran Projek

Ini adalah versi ke-4 program ini dan yang pertama kali kami menggunakan JavaScript dan webview. Versi sebelumnya dibangunkan menggunakan Python dan memerlukan pelaksanaan melalui terminal. Dengan versi baru ini, kami telah meningkatkan antara muka pengguna dan menambah beberapa ciri baru. Matlamat kami adalah untuk membantu semua orang meningkatkan kemahiran pengiraan mental mereka. Kami telah menambah mod untuk berlatih dan mod untuk bermain. Mod latihan akan membantu anda berlatih dengan cara yang disesuaikan dengan keperluan anda, manakala mod bermain akan mencabar anda dengan beberapa operasi sekaligus.

Ciri-ciri

  • Mod Latihan: Mod untuk berlatih pengiraan mental dengan cara yang disesuaikan mengikut keperluan anda.
  • Mod Permainan: Mod untuk mencabar anda dengan beberapa operasi sekaligus.
  • Antara Muka Pengguna: Antara muka pengguna yang dipertingkatkan untuk menjadikan aplikasi lebih mudah diakses dan mesra pengguna berbanding dengan versi sebelumnya.
  • JavaScript dan Webview: Aplikasi ini dibangunkan menggunakan JavaScript dan webview, memberikan pengalaman yang lebih moden dan interaktif.
  • Percuma dan Sumber Terbuka: Aplikasi ini adalah sepenuhnya percuma dan sumber terbuka, membolehkan sesiapa sahaja untuk menyumbang dan mengubah kod.
  • Sokongan Pelbagai Operasi: Aplikasi ini menyokong pelbagai operasi termasuk penambahan, penolakan, pendaraban, dan pembahagian.

Pemasangan

  1. Langkah 1: Klon repositori dari GitHub.
  2. Langkah 2: Unzip folder dan akses folder v4 di dalamnya.
  3. Langkah 3: Buka fail index.html di penyemak imbas anda (dengan klik dua kali pada fail tersebut).
  4. Langkah 4: Anda boleh menambah pautan ke fail ini di tempat lain di komputer anda untuk memudahkan akses dari sana.

Cara Penggunaan

Memulakan

  1. Langkah 1: Jalankan projek ini.
  2. Langkah 2: Ikuti arahan yang dipaparkan.

Sumbangan

Garis Panduan

Ini adalah projek sumber terbuka dan kami menggalakkan anda untuk menyumbang. Sila ikuti garis panduan di bawah dan jangan lupa untuk mematuhi Kod Etika kami.

Langkah 1: Fork Repositori

Fork repositori dengan mengklik butang "Fork" di sudut kanan atas halaman repositori. Ini akan membuat salinan repositori di akaun GitHub anda.

Langkah 2: Klon Repositori

Klon repositori ke mesin tempatan anda menggunakan arahan:

git clone https://github.com/your-username/tdm.git

Langkah 3: Buat Cawangan Baru

Buat cawangan baru untuk bekerja pada sumbangan anda menggunakan arahan:

git checkout -b your-branch-name

Langkah 4: Lakukan Perubahan

Lakukan perubahan yang diperlukan pada kod atau dokumentasi. Pastikan untuk mengikuti piawaian pengkodan dan garis panduan projek.

Langkah 5: Commit Perubahan

Commit perubahan anda menggunakan arahan:

git add .
git commit -m "Mesej commit anda"

Langkah 6: Hantar Perubahan

Hantar perubahan anda ke repositori fork anda menggunakan arahan:

git push origin your-branch-name

Langkah 7: Buat Pull Request

Buat pull request untuk menggabungkan perubahan anda dengan repositori utama. Untuk melakukannya, pergi ke halaman repositori dan klik butang "New pull request". Pilih cawangan yang anda ingin gabungkan dan isi penerangan pull request.

Langkah 8: Semakan dan Penggabungan

Penyelenggara projek akan menyemak pull request anda dan menggabungkannya ke repositori utama jika ia dianggap sesuai.

Garis Panduan untuk Sumbangan

  • Pastikan untuk mengikuti piawaian pengkodan dan garis panduan projek.
  • Pastikan sumbangan anda ringkas dan fokus pada satu masalah atau ciri sahaja.
  • Gunakan mesej commit yang jelas dan deskriptif.
  • Gunakan tajuk dan penerangan pull request yang jelas dan deskriptif.
  • Pastikan untuk menguji perubahan anda sebelum menghantar pull request.

Melaporkan Masalah

Jika anda menemui masalah dengan projek ini, sila laporkannya menggunakan pengesan masalah. Untuk melaporkan masalah, ikuti langkah-langkah berikut:

  1. Pergi ke halaman Issue Tracker.
  2. Klik pada butang "New issue".
  3. Isikan tajuk dan penerangan masalah dengan sejelas mungkin.
  4. Pilih label yang berkaitan untuk masalah tersebut (contohnya bug, feature, enhancement).
  5. Tugaskan masalah tersebut kepada individu atau pasukan yang berkaitan, jika perlu.
  6. Klik butang "Submit new issue".

Nota: Sebelum melaporkan masalah, pastikan anda memeriksa jika masalah yang serupa sudah ada dalam repositori.

Menambah Masalah Baru

Untuk menambah masalah baru dalam repositori, ikuti langkah-langkah berikut:

  1. Pergi ke halaman Issue Tracker.
  2. Klik pada butang "New issue".
  3. Isikan tajuk dan penerangan masalah atau ciri baru dengan sejelas mungkin.
  4. Pilih label yang berkaitan untuk masalah tersebut (contohnya bug, feature, enhancement).
  5. Tugaskan masalah tersebut kepada individu atau pasukan yang berkaitan, jika perlu.
  6. Klik butang "Submit new issue".

Nota: Sebelum menambah masalah baru, pastikan anda memeriksa jika masalah yang serupa sudah ada dalam repositori.

Lesen

Projek ini dilesenkan di bawah MIT License.

* Perhatian: Semua terjemahan ke dalam bahasa selain Bahasa Inggeris, Sepanyol, Catalan, dan Jerman dihasilkan secara automatik dan mungkin mengandungi ralat. Pemilik projek tidak menjamin ketepatan terjemahan dan tidak bertanggungjawab terhadapnya.