- CataLOG8or -

Versione 1.0.2.2

(28/05/2003)

- INTRODUZIONE -

Questo simpatico programmino (assolutamente freeware) è stato realizzato con lo scopo di aiutarmi a stilare una lista dei miei svariati mp3, da fornire prontamente ai tanti pellegrini che di tanto in tanto mendicavano in casa mia in cerca di una tale canzone, e, manco a dirlo, "non è che avresti una lista da darmi" era la frase più profferita....

Aggiungo che è alquanto fastidioso avere sempre qualcuno che sfoglia i drive del mio pc in cerca di quello che più gli aggrada, specialmente se deve guardarsi qualche migliaia di files (esatto, MIGLIAIA, almeno fino al momento in cui scrivo...). E quindi ecco CataLOG8or!

Questo programma vi permette di creare un lista di un qualsiasi tipo di file presente in qualsiasi tipo di supporto, di creare delle statistiche (per ora limitate a numero di file e dimensione totale dei file), con la possibilità di salvare il tutto su file di testo (TXT delimitato da tabulazioni, così lo potete aprire con Excel) oppure in HTML (sono in attesa del nullaosta da quelli della NullSoft per usare la stessa grafica.... diciamo che ho preso "spunto" da loro...).
Ho poi intenzione di aggiungere altre funzioni, specialmente alcune specifiche per gli mp3, ma il lavoro da fare è molto ed il tempo invece è poco...tanto il mio scopo l'ho raggiunto (a me CataLOG8or è molto comodo). Insomma, se non l'avete capito: PROVATELO! E possibilmente, fatemi sapere come vi sembra; io accetto consigli e critiche.

Vi rimando al manuale per l'uso per avere alcune informazioni sull'uso di CataLOG8or. Buona catalogazione!

< Wolf > (holyword@hotmail.com)

Sito web: http://www.holyword.it/catalog8or/

 

- INDICE -

 

- MANUALE PER L'USO -

Prima di descrivere le singole schermate che compongono il programma descriverò brevemente come si effettua una ricerca e come è organizzato CataLOG8or.

CataLOG8or è organizzato in maniera tale da guidare l'utente nella creazione della lista che preferisce ottenere, un pò come i famosi "wizard" delle installazioni. Questo significa che in qualsiasi momento l'utente sa in che punto si trova nel processo, quanti passi mancano e può decidere di tornare indietro sulle sue scelte fatte per modificare uno o più parametri, senza dover reinserire le scelte fatte successivamente. Alla fine del processo si può visualizzare il risultato e successivamente salvarlo in uno dei formati disponibili per poterlo conservare e consultare anche in seguito.

Il programma ha, per la quasi totalità delle schermate, delle parti in comune. Ogni schermata è suddivisa in due parti: nella parte superiore ci sono le scelte da effettuare o spazi dove inserire dei parametri che vanno ad influire sulla creazione della lista, mentre nella parte inferiore ci sono gli elementi di navigazione nel programma e alcune informazioni di riepilogo sul processo in corso. Nel dettaglio questi elementi sono i seguenti:

Su alcune parti della schermata sono attivi i "tooltip", ovvero dei suggerimenti o spiegazioni specifici per quel componente che compaiono lasciando il puntatore del mouse fermo per alcuni secondi sul componente stesso.

Schermata principale

Questa è la schermata principale del programma, da dove ogni ricerca ha inizio. Ci sono due voci nel menù in alto:

"Esci": chiude la schermata e termina l'applicazione;

"About": è una schermata con alcune info su CataLOG8or (ovvero le famose "Informazioni su...");

Premendo il pulsante "Crea la lista!" si da inizio alla procedura di creazione della lista.

Schermata del percorso

Qui si sceglie dove si vuole effettuare la ricerca (disco fisso, cdrom, ecc...), indicando al programma da dove deve cominciare.

Directory di partenza: qui si può scrivere il percorso della directory in cui effettuare la ricerca, oppure tramite il pulsante a fianco richiamare la schermata di scelta della directory (v. sotto), dove questa si può selezionare in maniera diretta

Volume: indica il nome del volume attualmente selezionato

Includi le sottodirectory: specifica se proseguire la ricerca anche nelle directory contenute dalla directory iniziale (se presenti)

Schermata di selezione della directory

Se non vi ricordaste esattamente il percorso completo di una directory, questa schermata vi consentirà di scegliere drive e directory in maniera molto intuitiva.

La finestra maggiore consente di selezionare la directory con il mouse (il percorso completo viene sempre visualizzato in alto), mentre sotto è possibile scegliere il drive e confermare od annullare le scelte effettuate con i pulsanti presenti.

Schermata del tipo di file

In questa schermata si sceglie il tipo di file da ricercare, indicandone l'estensione, nonché il tipo di ordinamento della lista.

Estensione dei file: qui si può specificare il tipo di file da ricercare, scrivendone la sua estensione. Vengono accettati sia i formati con il "." (es: *.XXX) che senza (es: XXX), dove "XXX" sta per l'estensione scelta.
Per ricercare tutti i file MP3 si dovrà per esempio scrivere "*.MP3" oppure "MP3" (maiuscolo o minuscolo).
Il menù a discesa si valorizza con i criteri inseriti nelle ricerche precedenti, ovvero se usate il programma per più ricerche troverete nel menù a discesa le estensioni che avete ricercato precedentemente (ma sempre finché non chiuderete CataLOG8or).
Nota: per ricercare più tipologie di file, inserire le estensioni separate da ";". Esempio: "MP3;M3U"

Ordinamento lista: l'ordinamento alfabetico da priorità all'iniziale del nome del file, mentre quello per directory ordina i file in base alle directory dove sono contenuti

Schermata del contenuto

Qui si scelgono le informazioni che si desidera ottenere dalla lista e l'ordine in cui si vuole vengano presentate.

Informazioni contenute nella lista: qui viene presentato un elenco di possibili informazioni che possono essere contenute nella lista. Cliccando sulla casellina di fianco ad ogni nome sarà possibile includere/escludere gli elementi desiderati (mettendo o togliendo il segno di spunta). I contenuti sono:

Se il tipo di file da ricercare è "*.MP3", il programma proporrà delle informazioni aggiuntive (che sono recuperate dall'ID3 TAG se presente):

ATTENZIONE: il programma attualmente gestisce in maniera corretta solo l'ID3v1.

Pulsante di selezione: questo pulsante (in alto a destra) seleziona/deseleziona tutti gli elementi presenti nell'elenco dei contenuti possibili

Pulsante tipologia campi: la pressione di questo pulsante (in alto a destra) attiva/disattiva la possibilità di impostare una lunghezza in caratteri per ogni voce selezionata nell'impostazione dei contenuti della lista.
Nota: questa scelta imposta la lista come "fissa senza separatore".

Pulsante di ordinamento: questo pulsante (in alto a destra) mostra la schermata di ordinamento (v. sotto), che consente di specificare l'ordinamento degli elementi nella lista (si può anche includere/escludere elementi dalla selezione).

Schermata dell'ordinamento

Con questa schermata si può scegliere quali elementi inserire nella lista e in che ordine devono comparire.

Lista Sorgente: contiene l'elenco completo di tutti gli elementi che possono comparire nella lista. Per confermare un elemento basta selezionarlo e cliccare sulla freccia rivolta verso destra (oppure selezionarlo con un doppio click); questo sposterà l'elemento nella lista Destinazione. L'ordine in cui si confermano i campi è quello in cui poi i campi saranno mostrati nella lista finale.

Lista Destinazione: contiene gli elementi che andranno nella lista, nell'ordine in cui compariranno. Per cambiare ordinamento si deve spostare i campi nella lista sorgente e successivamente riposizionarli qui nell'ordine corretto, mentre per rimuovere un elemento dalla selezione è necessario selezionarlo e in seguito cliccare sulla freccia rivolta verso sinistra (oppure selezionarlo con un doppio click).

Una volta compiute le scelte del caso, si potrà annullarle o confermarle con i pulsanti in basso, oppure richiamare le istruzioni della schermata.

Schermata del tipo di lista

Ci sono 3 tipi di lista creabili attualmente da CataLOG8or, e qui si può scegliere quale di essi andare a creare e se mantenere i risultati delle ricerche precedenti (andando così a sommare le liste).

Tipo di lista: la scelta della lista da creare va fatta in base alle caratteristiche delle liste stesse.

Cancella la lista precedente: specifica se aggiungere i risultati delle ricerche precedenti a quelli che si andranno ad ottenere oppure no. Nota: il processo non può essere invertito! Per ottenere nuovamente i risultati di una ricerca precedente una volta che sono stati cancellati si dovrà effettuare di nuovo la ricerca.

Con Intestazione e Piede: aggiunge alla lista l'intestazione delle varie colonne di dati e un riepilogo finale, indicante il numero di file trovati e la dimensione totale.

Separatore: viene visualizzato SOLO se la lista scelta è la lista personalizzata! Qui si specifica il carattere usato come separatore nella lista, come ad esempio ";" oppure "," (la tabulazione viene indicata come "#9"). Se ne consiglia l'uso solo ad utenti esperti.

Riepilogo

Questa schermata ha solamente la funzione di fornire un riepilogo delle scelte effettuate prima di procedere alla creazione della lista. Le informazioni sono fornite nell'ordine in cui sono state inserite, ma presentano un carattere tecnico che potrebbe non essere facilmente comprensibile da tutti gli utenti.

Premendo il pulsante "Fine" si da avvio alla creazione della lista, che finché non sarà salvata resterà nella memoria "temporanea"del pc.

La lista conterrà i file (o il file) trovati da CataLOG8or rispondenti ai criteri di ricerca impostati.

Salvataggio della lista

A questo punto la lista è stata creata. Qui si può visualizzarne i contenuti e decidere se salvarli su disco.

Anteprima: questo pulsante mostra una schermata che visualizza i contenuti della lista appena creata (v. sotto). Questi dati NON sono in alcun modo modificabili dall'utente!

Tipo di output per la lista: qui ci sono i formati supportati da CataLOG8or per il salvataggio su file delle liste create col programma, ovvero

Mostra opzioni link: premendo questo pulsante si attiva un menù a scomparsa che consente di specificare il campo sul quale si desidera venga attivato il link ipertestuale nella lista "HTML con links"; naturalmente questa scelta influenza solo la creazione di tale lista. La scelta predefinita, anche a menù nascosto, è la creazione di un campo aggiuntivo con il link.

Premendo il pulsante "Salva" si trasferirà la lista creata nel tipo di file scelto, mentre premendo il pulsante "Esci" si uscirà dal programma.

Nota: la finestra di salvataggio tiene in memoria il nome dell'ultimo file salvato, riproponendolo la volta successiva; è sufficiente cancellarlo ed inserire il nuovo nome per poter salvare il file come desiderato.

Anteprima della lista

Qui viene fornita un'anteprima della lista che si è creato, con la possibilità di scorrerne i contenuti sfogliando le pagine in cui è suddivisa oppure eseguendo un file della lista.

La lista viene suddivisa in vari pagine, a seconda della sua lunghezza, per facilitarne la consultazione. In alto vengono indicate le pagine totali e la pagina correntemente visualizzata; con i pulsanti di navigazione ci si potrà muovere tra le pagine agevolmente.

Facendo un doppio click su una riga dell'Anteprima si eseguirà il file relativo con l'applicazione associata di Windows (ovvero verrà eseguito il programma che è associato all'estensione del file selezionato).

Alcuni consigli

La lista più comoda è senz'altro la Lista Semplice. Questa, una volta salvata in formato testo delimitato da tabulazione, può venire editata da Excel; possono così essere aggiunti sia il piede (con i totali calcolati da formule) che l'intestazione che più vi aggrada. Inoltre si possono creare più liste semplici consecutive, in modo da creare una lista unica anche se i file da cercare sono sparsi in più directory. Mi raccomando, state attenti a non creare una lista cercando di sovrascrivere un file che è già aperto in consultazione (es: state visualizzando la LISTA1.HTM con Explorer, e decidete di rifarla cambiando alcune cose, la fate, la salvate sopra l'originale, ma aprendola non notate alcuna differenza!), perché le modifiche NON sarebbero salvate!

[inizio]

 

- HISTORY -

[1.0.2.2] 12/05/2003 (versione corrente)
! Fix al codice html generato
  19/05/2003 + Aggiunta la lista "Xml ad albero"
  28/05/2003 ! Fix in UPercorso sul cambiamento manuale della path;
+ nuova "About"
[1.0.2.1] 09/04/2003 + Aggiunta la funzione "Aggiungi ad un TXT", per accodare la lista in un file di testo creato precedentemente;
+ Ultimata la gestione dei campi fissi o variabili
[1.0.2.0b] 14/03/2003 + Aggiunta automatica di "*." in TipoFile;
+ Restyling di TipoFile, ora accetta più estensioni separate da ";"
[1.0.1.9b] 11/02/2003 ! Fissata la dimensione della label in SceltaDir
  12/02/2003 ! Variato il recupero della path in Percorso perché la caption della label viene troncata se troppo lunga;
! Disabilitato il pulsante Fine in CreaLista durante la creazione della lista
[1.0.1.8b] 10/01/2003 + Aggiunta in TipoFile la gestione di "*" (come "*.*");
! Variato il comando per lanciare l'applicazione associata in Anteprima
  05/02/2003 + Aggiunta in SalvaLista una combo attivabile per scegliere il campo sul quale attivare il link ipertestuale della lista html
[1.0.1.7b] 23/12/2002 ! Corretto un bug di creazione file html con links, sbagliava gli indici dei file se erano presenti intestazione e piede;
+ Aggiunto uno stile per il link (ora più chiaro e visibile)
  03/01/2003 ! Piccolo fix estetico nella scelta del separatore;
+ Eliminata la "Lista con Intestazione e Piede, ed aggiunto un controllo per aggiungere quei dati ad un tipo qualsiasi di lista;
! Bug fix all'Anteprima che non trovava più il path completo e quindi non eseguiva più i file;
! Rinominata la lista da "FILE TESTO con separatore" in "FILE TESTO" per maggiore flessibilità;
+ Aggiunta la "Lista Fissa (senza separatore)", per liste con i campi concatenati
  04/01/2003 + Aggiunta preliminare della scelta della lunghezza dei campi (beta)
  05/01/2003 ! Ottimizzazione del codice in UContenuti;
+ Aggiunto un controllo nell'impostazione della lunghezza dei campi sulla presenza della selezione;
! Bug fix nella scrittura di Intestazione e Piede (troppi separatori)
[1.0.1.6] 17/12/2002 ! Variata la memorizzazione della variabile "Percorso", ora con il path e non più col nome file completo;
+ Lo sfondo dell'immagine del logo è ora trasparente;
+ Tolta la lista HTML con separatore (inutile);
+ Aggiunta la lista HTML con links, che comprende nell'html generato il Codice per poter lanciare i file direttamente da browser
[1.0.1.5] 08/03/2001 + Aggiunta l'apertura con applicazione associata dei file da "Anteprima";
! Restilyng e ottimizzazione del codice in "Anteprima"
  09/03/2001 + Aggiunti i pulsanti First e Last in "Anteprima";
! Cambiate le diciture dei possibili output in "Salva Lista";
! Restyling del codice HTML per le liste che lo usano (più snello e corretto);
! Corretta l'impostazione del tipo di output in "Salva Lista" (ora memorizza la scelta precedente);
! Corretta l'impostazione del separatore in "Tipo Lista" quando la lista non era più quella Personalizzata
[1.0.1.4] 05/03/2001 ! Corretto un bug della procedura CaricaDir in "Crea Lista" (ora non dovrebbe più dare errori se elabora numerose sottodir);
+ Aggiunta la gestione della "Lista con intestazione e Piede";
! Corretto il mantenimento delle impostazioni in "Contenuti" (ma solo per i file che hanno estensione diversa da MP3);
+ Aggiunto un hint in "Percorso" sulla directory di partenza;
+ Aggiunta la segnalazione se la lista creata è vuota.
  06/03/2001 ! Modificata la caption in "Crea Lista" (ora mostra tutte le sottodir mentre le sta elaborando)
[1.0.1.3] 02/03/2001 ! Corretta la creazione dell'elenco dei contenuti in "Contenuti" (ora viene creato solo la prima volta);
! Fix estetici in "OrdineLista"
  03/03/2001 ! Correzioni in "Contenuti" (miglior controllo sui risultati da "Ordine Lista", su selezione/deselezione);
! Corretta la gestione dei pulsanti in "Ordine Lista";
! Cambiata la caption in "Anteprima"
  04/03/2001 + Aggiunta una lista SLLista, che contiene la lista creata dall'utente, mentre in SLDati sono presenti sempre TUTTI i dati (questo mi da maggiore flessibilità nell'uso dei dati stessi);
+ Aggiunta la gestione dell'ordinamento dei contenuti della lista (!!!)
[1.0.1.2] 17/02/2001 + Aggiunta la suddivisione in colonne di "Anteprima";
+ Aggiunta a "Tipo Lista" la lista Personalizzata (dove si può scegliere il separatore);
! Interruzione della creazione anche su pressione di Indietro.
[1.0.1.1] 04/02/2001 ! Ristrutturata "Anteprima", ora con una StringGrid; ! Bloccata la possibilità di scrittura in Volume ("Percorso"); + Form principali minimizzabili; + Cursore a clessidra durante la creazione della lista e possibilità di interrompere la creazione; ! Ristrutturato il riepilogo delle scelte in "Salva Lista"
[1.0.1.0] 02/01/2001 ! Modificato le proprietà di ogni form, che ora si apre sulle stesse coordinate dello schermo del form precedente;
+ Aggiunto un pulsante di uscita dal programma nel form "Salva Lista" (con conferma);
+ Nella schermata "Ordine Lista" ora è abilitato anche il doppio click per spostare gli elementi.
  05/01/2001 ! Cambiato la Position di ogni form a Designed, altrimenti la prima volta appariva sempre in ScreenCenter;
! Impostato un font non proporzionale nella "Anteprima" per una maggiore uniformità.
  12/01/2001 + Impostata la terminazione del programma sulla chiusura di ogni form;
+ Usato HIDE al posto di CLOSE per passare da un form all'altro.
  13/01/2001 ! Riscritti gli showmessage di HELP;
+ Cambiato il memo di "Anteprima" per mostrare la SL su più pagine, navigabili dall'utente.
  14/01/2001 ! Rifatta la schermata "About".
[1.0.0.9] 01/01/2001 Varie beta e varie modifiche...
[1.0.0.8] 18/10/1999 ! Tolta la richiesta di estensione dalla form di scelta della directory di ricerca, e messa solo in caso di mancata specifica da parte dell'utente;
! Fix dell'edit dell'estensione, che se veniva modificata non incideva sulla ricerca in corso;
! Sistemazione del codice (puramente stilistica...)
  05/11/1999 ! Riscritta la procedura ScriviLista, ora più generica
[1.0.0.7] 05/10/1999 + Rifatto completamente il layout della lista HTML; ora i dati sono racchiusi in una tabella;
Nota: scoperto il bug di "Esegui"! Il comando non funziona con i file che hanno spazi nel nome!;
Il file INFO.TXT è alla versione 1.1
  16/10/1999 ! Sistemato il bug di "Esegui" (aggiunte le virgolette prima e dopo il nome del file, come in DOS);
Il file INFO.TXT è alla versione 1.2;
+ Aggiunta una lista HTML con tabulazione (per compatibilità con le basse risoluzioni)
[1.0.0.6] 02/10/1999 ! Fix della scelta del percorso di ricerca (se si sceglie la root di un drive, non aggiunge la '\', già presente);
+ Modifica del layout del menù "Salva";
+ Modifica del layout grafico (aggiunta di label, allineamento dei componenti visuali);
+ Aggiunta dell'inizializzazione del form sullo OnShow;
! Riscrittura della procedura di inizializzazione e dei suoi utilizzi;
! Fix della caption di "Cerca", che rimaneva "Prossimo" con ricerche successive aventi liste differenti;
! Fix della Status Bar, che non scriveva niente in caso di ricerca negativa con una lista diversa da "Nessuna";
+ Aggiunta l'Edit per l'estensione; ciò rende la ricerca più intuitiva e facile da gestire;
! Fix dell'OnChange dell'Edit della path; ora non prosegue più con la ricerca nella directory precedente;
Aggiunta del file INFO.TXT versione 1.0;
Aggiunti alcuni commenti al codice sorgente
  03/10/1999 + Aggiunto il menù "Lista", che comprende le funzioni di "Salva" e di "Cancella" (nuovo, per cancellare la lista o tutto il contenuto del form);
! Fix del counter, che contava un file in meno;
+ Aggiunte delle segnalazioni di errore nella StatusBar
[1.0.0.5] 19/06/1999 ! Formattazione del testo del Memo;
+ Aggiunta degli Hint;
+ Aggiunta del form di scelta directory
  20/06/1999 ! Fix dell'azzeramento dei parametri di ricerca (sulla onChange della Edit, che ora consente di mantenere le ricerche precedenti)
  22/06/1999 ! Fix della formattazione del Memo (più spazio per le directory)
[1.0.0.4] 11/06/1999 + Parsing della combo box in Ricerca
  12/06/1999 ! Error trapping, bug fix (lista html, lista overwrite)
  13/06/1999 ! Fix del Memo, affinamento stilistico (testi vari)
[before 1.0.0.4] 29/05/1999 Esperimenti, esperimenti e ancora esperimenti...
[inizio]

 

- PROBLEMI NOTI -

Nessuno! :-)

[inizio]

 

- AGGIUNTE FUTURE -

ID3 Tag: con questa funzione voglio permettere l'editing dei tag presenti nei file mp3;

Menù Contestuale: aggiunta della gestione della clipboard;

Help: creazione di un file di help sul programma

[inizio]

 

- NOTE -

Non mi considero responsabile di eventuali danni recati al vostro pc dall'uso IMPROPRIO del mio programmetto; ovviamente IMPROPRIO, perché io se programmo di solito lo faccio bene (eheheh...). E poi diciamocelo: come CAVOLO potete riuscire a far danni creando un file di testo???

Potete usare liberamente CataLOG8or, e più lo distribuite in giro meglio è, a patto che includiate sempre il suddetto README.HTM (altrimenti come fanno a contattarmi gli altri utenti?).

Chi volesse contribuire allo sviluppo del progetto può contattarmi e io sarò ben lieto di mandargli i sorgenti (fatti con Borland Delphi 5).

[inizio]

 

- CREDITI -

Si ringraziano in modo particolare:

Eva
Gigi
Marcel
MAS!
mp [Menzione d'onore: sua è la procedura ricorsiva che cerca i file nelle directory e quella per la lettura dell'ID3!]
Sunspot
Totti

Ed inoltre tutti i beta tester:

Bimbogigi
Caleb
Giorgio
M@O
MADrigal
Marcello
Satyr
Seby [non più nel team dal 2003]
Strao [non più nel team dal 05/03/2001]
Ugo
[inizio]