mathebuddy

Mathebuddy

Situs web resmi dengan simulator dan taman bermain: https://mathebuddy.github.io/mathebuddy/

Pendanaan

Proyek ini didanai oleh "Freiraum 2022" (Inovasi Stiftung di der Hochschullehre), Jerman.

Info Pengguna dan Pembuat Konten

• Jika Anda hanya suka menggunakan taman bermain atau menguji simulator dengan file contoh, tidak perlu menginstal apa pun. Cukup kunjungi https://mathebuddy.github.io/mathebuddy/

• Jika Anda ingin membuat dan menguji kursus Anda sendiri, kunjungi situs web, pergilah ke simulator dan klik tombol http://localhost:8271 . Kemudian ikuti instruksi yang tercantum.

Info pengembang

Repositori ini mengimplementasikan semua komponen aplikasi matheBuddy .

Struktur file

Jalur	Keterangan
.vscode/	Pengaturan Proyek Kode Visual
Aplikasi/	Implementasi aplikasi dengan flutter
tempat sampah/	Skrip
Docs/	Situs web: https://mathebuddy.github.io/mathebuddy/
DOCS/DOC/	Dokumentasi SMPL, MBL, MBCL
ext/	Komponen eksternal
IMG/	File gambar asli
Lib/	Implementasi Komponen (Matematika-Runtime, ...)
cmd.sh	Skrip Administrasi untuk Pengembang
Web.sh	Mulai server web secara lokal
Mathebuddy.Code-Workspace	Ruang kerja untuk vScode

Pergilah ke file README.md di subdirektori untuk informasi lebih lanjut.

Instalasi

Sistem operasi lain selain Debian dan MacOS belum didukung. Hanya macOS yang memungkinkan untuk membangun versi aplikasi iOS.

Dependensi

Penting: Jika Anda hanya ingin menjalankan server web secara lokal (termasuk semua taman bermain dan simulator), Anda hanya perlu menginstal Python 3. Repositori memberikan perpustakaan yang dibangun terkini di docs/ Directory.

Catatan: Android dan Xcode dapat dilewati, jika Anda hanya ingin mengkompilasi dan menjalankan simulator MatheBuddy . pandoc dapat dilewati jika Anda tidak bermaksud membangun manual.

• Linux berbasis Debian (misalnya Ubuntu)

   sudo apt install python3 snapd pandoc
  sudo snap install flutter --classic
  

• MacOS

  Pertama -tama instal The Brew Package Manager.

   brew install git python3 flutter pandoc
  

Kemudian jalankan flutter doctor di jendela terminal dan instal semua dependensi yang terdaftar.

• MacOS

  Instal Xcode dari App Store dan mulai aplikasi untuk menyelesaikan instalasi. Kemudian jalankan perintah berikut dari terminal.

   xcode-select --install
  sudo gem install cocoapods
  brew install --cask android-studio
  brew install bundletool
  

  Jalankan aplikasi Android Studio.app , setujui lisensi dan selesaikan pengaturan. Dalam pengaturan Android Studio, pilih Appearance & Behavior , System Settings , Android SDK dan pilih di tab [SDK Platforms] (misalnya) Android 13 . Kemudian pilih di tab [SDK Tools] Android SDK Command-line Tools (latest) . Klik tombol Accept untuk memulai instalasi.

  Di terminal, jalankan flutter doctor --android-licenses dan terima setiap lisensi dengan y Kemudian jalankan flutter doctor lagi untuk memeriksa instalasi.

  Jika Anda tidak memiliki Java Runtime, jalankan brew install openjdk untuk menginstalnya. Homebrew akan menghasilkan bahwa Anda harus menjalankan echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc . Lakukan!

  Bug terbaru (Flutter/Flutter#118502) dapat mencantumkan kesalahan Java. Jalankan perbaikan berikut (jelek!):

   cd /Applications/Android Studio.app/Contents
  cp -r jbr jre
  

Mendapatkan Mathebuddy

Anda sekarang perlu mengkloning repositori Mathebuddy berikut. Ganti YOUR_FAVORITE_DIRECTORY dengan direktori lokal di disk Anda.

Kiat: Gunakan Github Desktop untuk mengkloning repositori (lihat akhir dokumen ini).

 cd YOUR_FAVORITE_DIRECTORY
git clone https://github.com/mathebuddy/mathebuddy.git
git clone https://github.com/mathebuddy/mathebuddy-public-courses.git

Pengembang tim inti harus menggunakan pasangan kunci SSH; Lihat https://docs.github.com/en/authentication/connecting-to-github-with-ssh; dan juga mengkloning repositori pribadi:

 cd YOUR_FAVORITE_DIRECTORY
git clone [email protected]:mathebuddy/mathebuddy.git
git clone [email protected]:mathebuddy/mathebuddy-public-courses.git
git clone [email protected]:mathebuddy/mathebuddy-private-courses.git

PERINGATAN: Never (!!) klon ke iCloud / googledrive / onedrive / nextcloud / sciebo / ...!

Menjalankan situs web secara lokal

Jalankan perintah berikut:

 cd YOUR_FAVORITE_DIRECTORY/mathebuddy/docs
python3 -m http.server 8314

Buka http://localhost:8314/ Di browser favorit Anda. Anda dapat memilih beberapa port lain dari 8314 .

Atau, Anda juga dapat menggunakan skrip ./web.sh (atau alat admin ./cmd.sh ) di direktori root repositori.

 cd YOUR_FAVORITE_DIRECTORY/mathebuddy
./web.sh

Membangun

Kami menggunakan vscode untuk mengedit kode sumber. Pastikan Anda menginstal semua ekstensi yang disarankan: Buka repositori mathebuddy di vscode, lalu klik Extensions pada simbol kiri div. Ketik @recommended di bidang pencarian. Kemudian klik Install pada setiap ekstensi yang belum diinstal.

(Todo: Bagian ini akan segera diperpanjang ...)

Daftar Repositori

• https://github.com/mathebuddy/mathebuddy

  Aplikasi iOS dan Android (diimplementasikan dengan flutter)

• https://github.com/mathebuddy/mathebuddy-public-courses

  Kursus Matematika Gratis dan Open Source