mathebuddy
0.5.0
Site Web officiel avec simulateur et terrain de jeu: https://mathebuddy.github.io/mathebuddy/
Ce projet est financé par "Freiraum 2022" (Stiftung Innovation à Der Hochschullehre), Allemagne.
Si vous aimez uniquement utiliser des terrains de jeux ou tester le simulateur avec des exemples de fichiers, il n'est pas nécessaire d'installer quoi que ce soit. Visitez simplement https://mathebuddy.github.io/mathebuddy/
Si vous aimez créer et tester vos propres cours, visitez le site Web, dirigez-vous vers simulator et cliquez sur le bouton http://localhost:8271 . Suivez ensuite les instructions répertoriées.
Ce référentiel implémente tous les composants de l'application matheBuddy .
| Chemin | Description |
|---|---|
| .vscode / | Paramètres du projet de code visuel |
| app / | Implémentation de l'application avec flottement |
| bac / | Scripts |
| docs / | Site Web: https://mathebuddy.github.io/mathebuddy/ |
| docs / doc / | Documentation de SMPL, MBL, MBCL |
| ext / | Composants externes |
| img / | Fichiers d'image d'origine |
| lib / | Implémentation de composants (Math-Runtime, ...) |
| cmd.sh | Script d'administration pour les développeurs |
| web.sh | Démarre le serveur Web localement |
| mathebuddy.code-workspace | Espace de travail pour VScode |
Dirigez-vous vers les fichiers README.md dans les sous-répertoires pour plus d'informations.
D'autres systèmes d'exploitation que Debian et MacOS ne sont pas encore pris en charge. Seul MacOS permet de créer une version iOS de l'application.
IMPORTANT: Si vous aimez seulement exécuter le serveur Web localement (y compris tous les terrains de jeux et le simulateur), vous n'avez qu'à installer Python 3. Le référentiel fournit des bibliothèques construites à jour dans les docs/ répertoire.
Remarque: Android et Xcode peuvent être sautés, si vous aimez seulement compiler et exécuter le simulateur MatheBuddy . pandoc peut être ignoré si vous n'avez pas l'intention de construire les manuels.
Linux basé à Debian (par exemple Ubuntu)
sudo apt install python3 snapd pandoc
sudo snap install flutter --classic
macos
Installez d'abord le Brew Package Manager.
brew install git python3 flutter pandoc
Ensuite, exécutez flutter doctor dans une fenêtre de terminal et installez toutes les dépendances répertoriées.
macos
Installez Xcode à partir de l'App Store et démarrez l'application pour terminer l'installation. Exécutez ensuite les commandes suivantes à partir d'un terminal.
xcode-select --install
sudo gem install cocoapods
brew install --cask android-studio
brew install bundletool
Exécutez l'application Android Studio.app , acceptez les licences et remplissez la configuration. Dans Android Studio Paramètres, choisissez Appearance & Behavior , System Settings , Android SDK et Sélectionnez dans TAB [SDK Platforms] (par exemple) Android 13 . Sélectionnez ensuite dans TAB [SDK Tools] Android SDK Command-line Tools (latest) . Cliquez sur le bouton Accept pour démarrer l'installation.
Dans un terminal, exécutez flutter doctor --android-licenses et acceptez chaque licence avec y . Ensuite, exécutez à nouveau flutter doctor pour vérifier l'installation.
Dans le cas où vous n'avez pas de runtime Java, exécutez brew install openjdk pour l'installer. Homebrew sortira que vous devez exécuter echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc . Fais-le!
Un bug récent (Flutter / Flutter # 118502) peut indiquer les erreurs Java. Exécutez le correctif suivant (laid!):
cd /Applications/Android Studio.app/Contents
cp -r jbr jre
Vous devez maintenant cloner les référentiels Mathebuddy suivants. Remplacez YOUR_FAVORITE_DIRECTORY par un répertoire local sur votre disque.
Astuce: utilisez GitHub Desktop pour cloner les référentiels (reportez-vous à la fin de ce document).
cd YOUR_FAVORITE_DIRECTORY
git clone https://github.com/mathebuddy/mathebuddy.git
git clone https://github.com/mathebuddy/mathebuddy-public-courses.git
Les développeurs de l'équipe de base doivent utiliser une paire de clés SSH; voir https://docs.github.com/en/authentication/connecting-to-github-with-ssh; et cloner également le référentiel privé:
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
AVERTISSEMENT: Jamais (!!) clone à iCloud / googledrive / onedrive / nextcloud / sciebo / ...!
Exécutez les commandes suivantes:
cd YOUR_FAVORITE_DIRECTORY/mathebuddy/docs
python3 -m http.server 8314
Ouvrez http://localhost:8314/ dans votre navigateur préféré. Vous pouvez choisir un autre port que 8314 .
Alternativement, vous pouvez également utiliser Script ./web.sh (ou l'outil d'administration ./cmd.sh ) dans le répertoire racine du référentiel.
cd YOUR_FAVORITE_DIRECTORY/mathebuddy
./web.sh
Nous utilisons VScode pour modifier le code source. Assurez-vous d'installer toutes les extensions recommandées: ouvrez le référentiel mathebuddy dans VScode, puis cliquez sur Extensions du symbole de gauche Div. Tapez @recommended dans le champ de recherche. Cliquez ensuite sur Install sur chaque extension qui n'est pas encore installée.
(TODO: cette section sera étendue bientôt ...)
https://github.com/mathebuddy/mathebuddy
Application iOS et Android (implémentée avec Flutter)
https://github.com/mathebuddy/mathebuddy-public-courses
Cours de mathématiques gratuits et open source
