documentazione_3di_riservata:celt:index
Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
| Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedente | ||
| documentazione_3di_riservata:celt:index [2016/01/27 19:38] – [XmlMindCELTAddons (classi Java)] aalberghini | documentazione_3di_riservata:celt:index [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1 | ||
|---|---|---|---|
| Linea 1: | Linea 1: | ||
| - | ====== Applicativi CELT ====== | ||
| - | |||
| - | Il parco applicativi di CELT/La Tribuna è composto di diversi componenti client e server. Lato server gli applicativi permettono l' | ||
| - | |||
| - | ===== Base di dati ===== | ||
| - | |||
| - | La base dati poggia su un server extraway 21.x che presenta una customizzazione in forma di DLL (libnse.dll). Questa libreria permette, tra le altre cose, la decorazione dei provvedimenti salvati nel DB con tutti gli articoli che contengono, dato che solo i loro riferimenti vengono salvati all' | ||
| - | |||
| - | ===== Applicativi server ===== | ||
| - | |||
| - | Di seguito un primo elenco degli applicativi installati lato server presso l' | ||
| - | |||
| - | * XCrossWay (Tomcat), un applicativo per la gestione del crawling automatico da diversi siti per recuperare automaticamente riferimenti normativi. **IN DISUSO** | ||
| - | * nsews (Tomcat), una versione specializzata dei 3diws con funzioni specifiche alla loro base dati((utilizzati anche da applicativi lato client, come l' | ||
| - | * nserealm (Tomcat), un Realm Tomcat personalizzato per permettere l' | ||
| - | * GestioneUtenti (Tomcat), un applicativo per la gestione degli utenti presenti sulla banca dati e sui loro diritti di accesso | ||
| - | * nse (Flash/ | ||
| - | * Guce (PHP), un " | ||
| - | |||
| - | ===== Applicativi client ===== | ||
| - | |||
| - | Qui sotto un elenco degli applicativi lato client | ||
| - | |||
| - | * EBook (Java): un applicativo che trasforma l' | ||
| - | * XMLTransformer (Java): applicativo che permette di preparare un' | ||
| - | * NSE Editor (Java): editor XMLMind esteso con un plugin specifico per NSE che ne customizza l' | ||
| - | * 3di.tribuna.cd (InnoSetup e C++): progetto che, tramite l'uso di InnoSetup, produce un setup di installazione per il DVD con i provvedimenti di Tribuna - Windows only. | ||
| - | * InDesignTransform (Java): ???, probabilmente effettua una qualche conversione sui menabo per indesign. | ||
| - | |||
| - | ===== Note generali ===== | ||
| - | |||
| - | Molti applicativi sono realizzati tramite progetti Netbeans, per cui si rimanda a [[cicnasin | questa pagina]] per le configurazioni del caso per CVS, ssh ecc. | ||
| - | |||
| - | La versione di Netbeans utilizzata finora è la 7.x. Non sono state effettuate prove con versioni più recenti. | ||
| - | |||
| - | ====== Dettaglio applicativi ====== | ||
| - | |||
| - | ===== ADAP ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=ADAP | ||
| - | | ||
| - | Utility swing mai vista/usata negli ultimi anni. Probabilmente in disuso. | ||
| - | |||
| - | Vista la dipendenza dal broker, probabilmente permette di aggiornare in un colpo solo diversi documenti/ | ||
| - | |||
| - | ===== DictionaryToXML ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=DictionaryToXML | ||
| - | | ||
| - | Utility che effettua un qualche tipo di conversione batch sui dizionari (una delle unità informative presenti nella banca dati Tribuna). | ||
| - | |||
| - | Mai vista/ | ||
| - | |||
| - | ===== EBook ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=EBook | ||
| - | | ||
| - | Applicativo swing che permette la trasformazione di un export di menabò tramite l' | ||
| - | |||
| - | La modalità di funzionamento principale prevede il caricamento dell' | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | L' | ||
| - | |||
| - | - estrarre tutti gli XML dagli zip, se sono stati specificati degli zip come file di input | ||
| - | - effettuare un primo split dei file XML > 200KB((motivo spiegato nel seguito)) | ||
| - | - creare la TOC (navigation map nel gergo epub) | ||
| - | - effettuare la trasformazione in XHTML mediante degli stylesheet XSLT | ||
| - | - creare i metadati OPF necessari per l'epub | ||
| - | - convertire le immagini trovate nei documenti sorgenti in jpg a bassa risoluzione | ||
| - | - creare le pagine XHTML delle copertine | ||
| - | - creare una TOC HTML in modo che compaia anche all' | ||
| - | |||
| - | Al termine delle conversione, | ||
| - | |||
| - | L' | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | Questa funzione è in disuso da diverso tempo, poiché CELT si avvale del portale [[http:// | ||
| - | |||
| - | ==== Software di terze parti utile ==== | ||
| - | |||
| - | * [[http:// | ||
| - | * [[https:// | ||
| - | * [[http:// | ||
| - | |||
| - | ==== Questioni in sospeso ==== | ||
| - | |||
| - | Questa applicazione è una di quelle sulle quali sono stati effettuati più interventi negli ultimi anni, principalmente per i seguenti motivi: | ||
| - | |||
| - | * mancata validazione di alcuni epub che vengono però convertiti correttamente | ||
| - | * errori in fase di conversione in epub | ||
| - | * mancata validazione lato [[http:// | ||
| - | * warning sugli epub prodotti all' | ||
| - | |||
| - | Elenco ticket trattati su Egroupware: | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | |||
| - | Elenco ticket trattati su Easyredmine: | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | |||
| - | Sono stati corretti diversi bug, mentre altri problemi non sono stati ancora risolti. Nel seguito un riassunto di quelli __ancora da risolvere__. | ||
| - | |||
| - | === Split automatico file > 200 KB === | ||
| - | |||
| - | Poiché i primi e-reader avevano capacità di memoria RAM ridotte, una regola empirica che alcuni software impongono (tipo Adobe Digital Editions) è che i singoli file XML componenti l'epub devono essere grandi al massimo 200KB, pena la non retrocompatibilità con lettori dalla limitata capacità di memoria. | ||
| - | |||
| - | L' | ||
| - | |||
| - | Dato che la suddivisione da operare è non banale (poiché bisogna mantenere il contenuto coerente con ciò che lo precede, ovvero tutto il ramo HTML del predecessore), | ||
| - | |||
| - | Negli ultimi sviluppi effettuati si è quindi aggiunta la possibilità di delegare la conversione a Calibre, tuttavia non si è ancora arrivati ad una stabilizzazione dell' | ||
| - | |||
| - | Il requisito per poter " | ||
| - | |||
| - | === Migliore gestione del codice ISBN === | ||
| - | |||
| - | Il codice ISBN va specificato in due punti diversi all' | ||
| - | |||
| - | content.opf => // | ||
| - | |||
| - | e | ||
| - | |||
| - | toc.ncx => ncx/ | ||
| - | | ||
| - | Attualmente non è ben gestita la propagazione dell' | ||
| - | |||
| - | === Validazione tramite epubchek === | ||
| - | |||
| - | Sarebbe bene incorporare una versione sempre attuale di epubcheck, in moda da effettuare la validazione secondo i crismi più recenti. | ||
| - | |||
| - | === Razionalizzazione codice === | ||
| - | |||
| - | Sono stati disposti diversi < | ||
| - | |||
| - | ===== FormToXML ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=FormToXML | ||
| - | | ||
| - | Progetto Eclipse mai visto/ | ||
| - | |||
| - | ===== GestioneUtenti ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=GestioneUtenti | ||
| - | | ||
| - | Web application che permette la gestione degli utenti applicativi inclusi nel db '' | ||
| - | |||
| - | ===== InDesignTransform ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=InDesignTransform | ||
| - | | ||
| - | Applicativo client che opera un qualche tipo di trasformazione sugli esportati per Indesign. | ||
| - | |||
| - | Mai vista/ | ||
| - | |||
| - | ===== MonographyToXML ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=MonographyToXML | ||
| - | | ||
| - | Progetto Eclipse per operare una qualche trasformazione sulle monografie (tipo di unità documentale). | ||
| - | |||
| - | Mai utilizzata. | ||
| - | |||
| - | ===== NseConfXml ===== | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=NseConfXml | ||
| - | | ||
| - | Semplice cartella contenente le configurazioni degli archivi utilizzati. | ||
| - | |||
| - | ===== NseRealm ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=NseRealm | ||
| - | | ||
| - | Componente che implementa un Realm Tomcat per gestire l' | ||
| - | |||
| - | Questo componente non era migrabile su Tomcat >= 5.5 poiché implementa classi/ | ||
| - | |||
| - | ===== RCSCleaner ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=RCSCleaner | ||
| - | | ||
| - | Prima versione standalone dello strumento realizzato per effettuare una pulizia di alcuni HTML che non venivano importati in [[# | ||
| - | |||
| - | Questa versione è stata deprecata in favore di quella maven-based denominata [[# | ||
| - | |||
| - | Per dettagli sulle problematiche risolte da questo componente, consultare il ticket [[https:// | ||
| - | |||
| - | ===== ReferenceMatch ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=ReferenceMatch | ||
| - | | ||
| - | Libreria che implementa funzionalità di ricerca ed identificazione dei riferimenti normativi all' | ||
| - | |||
| - | Questa libreria è utilizzata dall' | ||
| - | |||
| - | Probabilmente la versione distribuita di NSEEditor in precedenza conteneva una versione diversa da quella presente sul CVS, poiché in fase di debug si è notato un certo disallineamento dei sorgenti. La versione precedente è '' | ||
| - | |||
| - | |||
| - | ===== ScubeToXw ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=ScubeToXw | ||
| - | | ||
| - | Mai visto/ | ||
| - | |||
| - | ===== XMLTransformer ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=XMLTransformer | ||
| - | | ||
| - | Applicativo utilizzato per la vecchia conversione "per l' | ||
| - | |||
| - | ==== Origine ==== | ||
| - | |||
| - | Il vecchio portale di "La Tribuna" | ||
| - | |||
| - | Dopo il passaggio dall' | ||
| - | |||
| - | Fine excursus | ||
| - | |||
| - | Questo applicativo è comunque utilizzato perché attua una qualche trasformazione sulla base dati che è ancora utile. | ||
| - | |||
| - | Segue un' | ||
| - | |||
| - | ==== LoadingMap ==== | ||
| - | |||
| - | - Inizializza il log (FIXME: da porre nella $HOME invece che nella directory corrente) | ||
| - | - carica aree tematiche da una serie di file TXT, facendone il parsing e ponendone le voci in una mappà così costituita: < | ||
| - | Map <String, String> m := <" | ||
| - | | ||
| - | area tematica | ||
| - | voce area -------------------| | ||
| - | descrizione | ||
| - | </ | ||
| - | - carica nsews.properties __amanuensemente__ per ricavare la URL degli nsews | ||
| - | - carica CharMap.properties __a mano__ nella variabile '' | ||
| - | - carica LexMap.properties __a mano__ nella variabile | ||
| - | - crea o legge OnlineDVDTransformer.properties | ||
| - | |||
| - | In generale questa classe fornisce accesso '' | ||
| - | |||
| - | ==== ConversionManager (MAIN) ==== | ||
| - | |||
| - | Per ogni file fornito al programma: | ||
| - | - lo decomprime se zip in una directory temporanea | ||
| - | - se XML lo tratta direttamente | ||
| - | - itera sugli XML eventualmente estratti dagli zip | ||
| - | - | ||
| - | Conversione per l' | ||
| - | - Caricamento epigrafe da DB mediante nsews se l'ID è nota, altrimenti no caricamento (solo provvedimento) | ||
| - | - imbustamento all' | ||
| - | - conversione e salvataggio mediante [[# | ||
| - | |||
| - | ==== OnlineConversion ==== | ||
| - | |||
| - | TODO | ||
| - | ===== Editor XML / NSE Editor ===== | ||
| - | |||
| - | L' | ||
| - | |||
| - | * XMLEditorJavaClasses, | ||
| - | * XmlMindCELTAddons, | ||
| - | |||
| - | Come anticipato nella panoramica degli applicativi, | ||
| - | |||
| - | Per poter effettuare delle prove di funzionamento, | ||
| - | |||
| - | Gli addon di XMLMind sono dei file .zip contenenti una struttura di cartelle predefinite ed un insieme di jar. | ||
| - | |||
| - | L' | ||
| - | |||
| - | È **perentorio** l' | ||
| - | |||
| - | Per costruire il pacchetto dell' | ||
| - | |||
| - | Una volta ottenuto il pacchetto dell' | ||
| - | |||
| - | |||
| - | Elenco ticket trattati su Egroupware: | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | |||
| - | Elenco ticket trattati su Easyredmine: | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | * [[https:// | ||
| - | |||
| - | ==== Classi Java ==== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=XMLEditorJavaClasses | ||
| - | | ||
| - | |||
| - | === Questioni in sospeso === | ||
| - | |||
| - | == Inserimento riferimenti normativi nei commenti di tipo dottrina e note a sentenza == | ||
| - | |||
| - | È stata richiesta la quotazione di questo intervento, che prevede la possibilità di inserire i riferimenti normativi anche nelle due categorie di commenti sopracitati che la momento non lo prevedono. | ||
| - | |||
| - | Vedere le note sui [[riferimenti normativi]]. | ||
| - | |||
| - | == Invio mail di notifica ad ogni modifica == | ||
| - | |||
| - | È stato segnalato diverso tempo fa il fatto che le mail di notifica, inviate automaticamente all' | ||
| - | |||
| - | In seguito alla migrazione di CELT da RCS a EDRA/LSWR e all' | ||
| - | |||
| - | L' | ||
| - | ==== Editor addon ==== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=XmlMindCELTAddons | ||
| - | | ||
| - | Questo progetto contiene l' | ||
| - | |||
| - | Anche questo progetto, come il precedente, dispone di un file Ant per gestire le questioni di impacchettamento e di deploy dei file modificati all' | ||
| - | |||
| - | ===== nsews ===== | ||
| - | |||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=nsews | ||
| - | | ||
| - | |||
| - | Progetto dei web service di NSE. Praticamente tutti gli applicativi si appoggiano a questi web service per il colloquio verso la base di dati eXtraWay. | ||
| - | |||
| - | ==== Amenità ===== | ||
| - | |||
| - | I WSDL inclusi nel progetto (e pubblicati poi dall' | ||
| - | |||
| - | |||
| - | ===== it.osa.application.RCSCleaner ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.application.RCSCleaner | ||
| - | | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | | ||
| - | Refactoring basato su maven del progetto [[# | ||
| - | |||
| - | Come scritto per il progetto " | ||
| - | |||
| - | Il progetto (come i suoi sottoprogetti) è già presente nel nostro [[http:// | ||
| - | |||
| - | ===== it.osa.modules.filters-text ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.filters-text | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Componente che contiene classi utili per applicare trasformazioni a delle stringhe. Attualmente implementa una trasformazione basata su una lista di caratteri " | ||
| - | |||
| - | |||
| - | ===== it.osa.modules.interfaces ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.interfaces | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Contenitore di interfacce base da condividere tra più componenti. | ||
| - | |||
| - | |||
| - | ===== it.osa.modules.scraping ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.scraping | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Componente che definisce una serie di interfacce e classi base generiche per realizzare funzionalità di scraping testuale. | ||
| - | |||
| - | ===== it.osa.modules.scraping-jsoup ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.scraping.jsoup | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Componente che implementa le classi e interfacce del modulo [[# | ||
| - | |||
| - | |||
| - | ===== it.osa.modules.utils ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.utils | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Utility generiche utilizzate dagli altri progetti. Nello specifico, sono incluse classi di utility per: | ||
| - | * output formattato su console | ||
| - | * stampa dei risultati ottenuti da un oggetto [[https:// | ||
| - | * join di stringhe | ||
| - | |||
| - | ===== it.osa.modules.workers ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=it.osa.modules.workers | ||
| - | maven=[[http:// | ||
| - | jenkins=[[http:// | ||
| - | |||
| - | Contiene un' | ||
| - | |||
| - | ===== 3di.tribuna.cd ===== | ||
| - | |||
| - | |||
| - | {{ : | ||
| - | |||
| - | CVSROOT=: | ||
| - | CVS_MODULE=3di.tribuna.cd | ||
| - | | ||
| - | | ||
| - | |||
| - | ===== XMLTransformer ===== | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | ====== Layout dei sistemi ====== | ||
| - | |||
| - | TODO | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
/data/attic/documentazione_3di_riservata/celt/index.1453919927.txt.gz · Ultima modifica: 2017/09/08 10:59 (modifica esterna)