Axiom Paths
Axiom Paths è una piattaforma collaborativa open source per la documentazione accademica universitaria in Matematica. Il progetto implementa un approccio wiki-based per la creazione, organizzazione e condivisione di contenuti didattici strutturati.
Features
- 📚 Modular Architecture: Organizzazione per corso con linking intelligente
- 🔗 Interconnected Knowledge: Graph-based navigation tra concetti
- 📖 LaTeX Integration: Rendering matematico avanzato
- 🏷️ Semantic Tagging: Sistema di categorizzazione multi-dimensionale
- 📱 Responsive Design: Ottimizzato per dispositivi mobili
- 🔄 Version Control: Git-based workflow per contributi
- 🚀 Static Site Generation: Deploy automatico via GitHub Pages
Architecture
Tech Stack
| Componente | Tecnologia |
|---|---|
| Content Management | Obsidian + Markdown |
| Math Rendering | LaTeX + MathJax |
| Site Generation | Quartz 4 |
| Version Control | Git + GitHub |
| Deployment | GitHub Pages |
| Styling | CSS + Responsive |
Getting Started
Prerequisites
Local Setup
# Clone repository
git clone https://github.com/giovyx90/axiom-paths.git
cd axiom-paths
# Open in Obsidian
# File -> Open Folder as Vault -> select axiom-paths/
# For Quartz preview (optional)
npm install
npx quartz build --serve
### Content Standards
#### File Naming Convention
MM-NOME-CONCETTO.md
├── 01-Spazi-Vettoriali.md
├── 02-Applicazioni-Lineari.md
└── 03-Matrici-e-Determinanti.md
Metadata Template
***
title: "Titolo Concetto"
tags: [materia, difficoltà, tipo]
prerequisites: [["Concetto Base"]]
related: [["Concetto Correlato"]]
version: "1.0"
last_updated: "YYYY-MM-DD"
***
Content Structure
> **Definizione X.Y** (Nome Formale)
> Enunciato matematico preciso
# Proprietà
- Proprietà fondamentali
- Caratterizzazioni equivalenti
# Esempi
## Esempio 1
Istanza concreta con calcoli
# Teoremi Correlati
- [[Link a teoremi]]
- [[Link a applicazioni]]Available Content
Geometria I - v3.1
Status: Contenuti validi e quasi completi, con solo Geometria Proiettiva mancante. Da risistemare visivamente. Vanno inseriti esercizi ed esami.
Coverage: 80% teoria completa, 0% Esercizi
- Algebra Lineare: Spazi vettoriali, endomorfismi, forma di Jordan
- Geometria Metrica: Spazi euclidei, ortogonalità, forme bilineari
- Geometria Proiettiva: Coordinate omogenee, trasformazioni proiettive
Analisi Matematica I 🚧 v0.5
Status: In Development
Coverage: 0% teoria di base
Contributing
Leggi CONTRIBUTING.md per le guidelines complete.
Quick Start per Contributors
- Fork il repository
- Crea branch:
git checkout -b feature/nuovo-contenuto - Aggiungi contenuti seguendo gli standard
- Test locale in Obsidian
- Submit PR con descrizione dettagliata
Tipi di Contributi
- 🐛 Bug fixes: Errori matematici o di formattazione
- 📚 Content: Nuovi teoremi, definizioni, esempi
- 🏗️ Structure: Miglioramenti architetturali
- 🎨 UI/UX: Design e accessibilità
- 🔧 Tooling: Build system e automazione
Roadmap
v4.0 (Q4 2025)
- Analisi Matematica I - Release completa
- Sistema di ricerca avanzato
- PDF export per singoli moduli
- Mobile app companion
v5.0 (Q1 2026)
- Algebra I - Beta release
- Collaborative editing features
- API per integrazioni esterne
- Analytics e usage metrics
Long-term Vision
- Coverage completo triennio Matematica
- Multi-university deployment
Maintainers
- Giovanni Albanese (@giovyx90) - Project Lead & Primary Maintainer
Community
- 🐙 GitHub Issues: Bug reports e feature requests
- 💬 Discussions: Idee e feedback generale
- 📧 Email: axiompaths@protonmail.com
License
Questo progetto è rilasciato sotto licenza MIT License.
Content License
I contenuti didattici sono disponibili sotto Creative Commons CC-BY-SA 4.0.
Acknowledgments
- Università di Firenze - Dipartimento di Matematica
- Open Source Community - Tools e metodologie
- Contributors - Vedi CONTRIBUTORS.md
🚀 Ready to contribute? Inizia dalle good-first-issue!