Documentation › Construire et contribuer
Construire et contribuer
matOS est un logiciel libre : tout ce qui sert à fabriquer l'ISO est dans le dépôt GitHub.
Reconstruire l'ISO
Seul prérequis : Docker ou Podman. Le build se fait dans un conteneur Debian 13, sur n'importe quelle distribution. Prévoir environ 80 Go de disque libre et plusieurs heures la première fois.
git clone https://github.com/raantss18/MatOS.git && cd MatOS
./build.sh --rapide # ISO de test sans SageMath ni module
./build.sh # ISO (3,9 Go) et les quatre modules
scripts/test-iso.sh # démarre l'ISO dans QEMU sans écran et contrôle son rapport
./build.sh --test # démarre l'ISO dans QEMU, avec écran
Principes : le build échoue plutôt que de produire une image incomplète ; tout ce qui est téléchargé a une version et une empreinte SHA256 (versions.env) ; les personnalisations sont des paquets matos-* qui ne modifient jamais les fichiers d'autres paquets.
Publier une version
- Changer
MATOS_VERSIONdansversions.envet noter les changements dansCHANGELOG.md. - Construire et tester l'ISO, puis fusionner dans
main(pull request). - Vérifier le découpage sans rien envoyer :
scripts/publier-release.sh --a-blanc. - Créer la version en brouillon :
scripts/publier-release.sh, puis la rendre publique :scripts/publier-release.sh --publier.
La page Télécharger lit automatiquement la dernière version publiée.
Ajouter un livre libre
Un livre n'entre dans la bibliothèque que si sa licence libre est constatée dans le texte du PDF.
scripts/livre-verifier.sh L2/mon-livre.pdf https://exemple.org/livre.pdf
Le script vérifie que c'est un PDF, cherche la licence et affiche la ligne à copier dans MATOS_BOOKS (L1, L2, Outils : dans l'ISO) ou MATOS_BOOKS_PLUS (L3, M1-M2 : module bibliotheque) de versions.env.
Modifier ce site
Les sources sont dans site/src/ (pages en fragments HTML, une feuille de style, un petit JavaScript facultatif). La charte est dans site/DESIGN.md. Pour prévisualiser :
python3 scripts/generer-site.py --verifier && python3 -m http.server -d site/public 8000
Puis ouvrez http://localhost:8000. Le script ne demande aucune installation (Python seulement) et vérifie les liens, les ancres et les textes alternatifs. Le site est publié automatiquement après chaque fusion dans main.
Proposer une modification
Ouvrez une pull request décrivant ce que vous avez changé et comment vous l'avez testé. Lisez d'abord le guide de contribution et le code de conduite.