LaTeX Glossary Editor - V2.3.0

Supported Operating Systems :

Technologies:

📖 Indice

• Descrizione
• Caratteristiche
• Requisiti di Sistema
• Installazione
• Guida all'Uso
• Struttura del Progetto
• Funzionalità Avanzate
• Risoluzione Problemi
• Contribuire
• Roadmap
• Licenza
• Contatti

📝 Descrizione

LaTeX Glossary Editor è un'applicazione desktop (cross-platform) progettata per semplificare la gestione dei glossari nei documenti LaTeX. Offre un'interfaccia grafica intuitiva che permette agli utenti di creare, modificare e organizzare definizioni e abbreviazioni in modo efficiente, eliminando la complessità della gestione manuale del codice LaTeX.

Perché LaTeX Glossary Editor?

• Semplificazione del Workflow: Elimina la necessità di scrivere manualmente il codice LaTeX per le definizioni del glossario

• Gestione Centralizzata: Organizza tutte le definizioni in un database strutturato

• Compatibilità Cross-Platform: Funziona perfettamente su Windows e macOS

• Supporto Completo LaTeX: Gestisce correttamente la formattazione matematica e i comandi LaTeX

• Funzionalità Core

  • Gestione Progetti
    • Creazione e gestione di progetti multipli
    • Importazione/esportazione da/verso file LaTeX
    • Backup automatico dei dati

📸 Screenshots

Interfaccia principale dell'editor

Vista del database delle definizioni

Interfaccia Utente

• Editor Visuale

  • Campi dedicati per ogni componente della definizione
  • Formattazione del testo in tempo reale
  • Anteprima LaTeX istantanea

• Organizzazione

  • Categorizzazione delle definizioni
  • Creazione di gruppi per definizioni separate se necessario
  • Sistema di ricerca e filtri
  • Vista database integrata

Formattazione

• Supporto Completo LaTeX
  • Modalità matematica integrata
  • Comandi di formattazione
    • modalità testo : Normale, \textbf{}, \texit{}
    • modalità matematica : Normale, \mathbf{}, \mathit{},\textbackslash)
  • Gestione automatica delle graffe e degli escape

Gestione Dati

• Database SQLite
  • Salvataggio automatico
  • Gestione efficiente delle relazioni
  • Backup integrato

🚀 Installazione

1. Clona il repository:

git clone https://github.com/AntonioDEM/LaTeX-Glossary-Editor.git

2. Installa le dipendenze:

pip install tkinter sqlite3

3. Esegui l'applicazione:

python glossary_editor.py

💡 Utilizzo

Al primo avvio crea una cartella GlossaryEditor

1. Primi Passi

   1. Creazione Nuovo Progetto

      • Apri l'applicazione
      • Seleziona "File > Nuovo Progetto"
      • Inserisci nome e descrizione

   2. Gestione Categorie

      • Crea nuove categorie da "File > Nuova Categoria" (MATEMATICA, FISICA, CHIMICA.....)
      • Aggiungi commenti per organizzare meglio le definizioni
      • Aggiungi Gruppo (se necessario)
        • l'opzione gruppo consente appunto di suddividere il glossario in gruppi di definizioni, ad esempio: math, fis, chim.....

   3. Inserimento Definizioni

      • Seleziona una categoria
      • Compila i campi richiesti:
        • Chiave (identificatore univoco)
        • Nome (con opzioni di formattazione)
        • Prima occorrenza
        • Testo
        • Descrizione

   4. Formattazione

      • Usa i controlli di formattazione per:
        • Testo in grassetto
        • Testo in corsivo
        • Modalità matematica
        • Prima lettera in grassetto
      • Esempio del risultato finale

      \newglossaryentry{cnel}{
              type=\acronymtype,
              name={\textbf{CNEL}},
              first={\textbf{C}ommunity \textbf{N}oise \textbf{E}quivalent \textbf{L}evel (CNEL)},
              text={\textbf{CNEL}},
              description={Indicatore del livello di rumore medio giornaliero con penalizzazioni per il periodo serale e notturno},
          group={dac}
          }

   Funzionalità Avanzate

   • Importazione LaTeX

     • Supporto per file esistenti
     • Parsing automatico delle definizioni
     • Mantenimento della formattazione

   • Esportazione

     • Generazione codice LaTeX
     • Esportazione selettiva per categoria
     • Backup del database

📁 Struttura del Progetto

LaTeX-Glossary-Editor/
├── abt/                  # Componenti dell'interfaccia About
│   ├── about_window.py   # Finestra informazioni
│   └── info.py          # Configurazioni applicazione
├── assets/              # Risorse statiche
│   ├── icons/          # Icone dell'interfaccia
│   └── images/         # Immagini dell'applicazione
├── src/                 # Codice sorgente principale
│   ├── db_manager.py    # Gestione database SQLite
│   ├── glossary_db.py   # Logica del glossario
│   ├── glossary_os_handler.py  # Gestione multipiattaforma
│   ├── latex_parser.py  # Parser per file LaTeX
│   ├── options_write.py # Gestione opzioni di scrittura
│   └── project_manager.py # Gestione progetti
├── tests/              # Suite di test
├── docs/               # Documentazione
├── LICENSE             # Licenza MIT
├── README.md          # Questo file
├── requirements.txt   # Dipendenze Python
└── glossary_editor.py # Entry point applicazione

❗ Risoluzione Problemi

Problemi Comuni

1. Database non accessibile

   • Verifica i permessi della directory
   • Controlla il path del database
   • Riavvia l'applicazione

2. Errori di Importazione LaTeX

   • Verifica la sintassi del file
   • Controlla la codifica del file (UTF-8)
   • Usa l'opzione di debug per maggiori dettagli

3. Problemi di Formattazione

   • Pulisci la cache dell'applicazione
   • Verifica la sintassi LaTeX
   • Usa l'anteprima per controllare il risultato

🤝 Contributi

Contributi e suggerimenti sono sempre benvenuti! Per contribuire:

1. Fai un fork del repository
2. Crea un nuovo branch (git checkout -b feature/nuova-feature)
3. Committa le tue modifiche (git commit -am 'Aggiunta nuova feature')
4. Pusha il branch (git push origin feature/nuova-feature)
5. Apri una Pull Request

👥 Autori

• Antonio Demarcus (@AntonioDEM) - Sviluppatore Principale
• Claude (@Anthropic) - Contributi allo sviluppo

📄 Licenza

Questo progetto è rilasciato sotto licenza MIT - vedi il file LICENSE per i dettagli.