Benvenuti a The Stator - HyperTrek Offline Project

Questo sito internet è dedicato al progretto di conversione dell'HyperTrek in una guida consultabile offline a partire dal database sul quale si basa la versione online.

Il software che effettua questa conversione si chiama 'The Stator' ed è sviluppato da Luca Mauri con l'aiuto di tutti i partecipanti alle mailing list di Hypertrek.
Il software è scritto in Visual Basic .NET e opera estraendo le informazioni dal DB che contiene tutta la struttura e i testi della versione online e creando poi una serie di file XHTML contenente queste informazioni.
In questo modo, tutto Hypertrek è ricreato come un minisito contenuto in un archivio ZIP che può essere scaricato, scompattato e consultato offline, come era per tutte le versioni precedenti a quella PHP+MySQL. Per maggiori informazioni potete anche vedere questa pagina sul sito.

In questa pagina trovate le informazioni sul progetto, le ultime novità, i problemi aperti e un link all'ultimo pacchetto disponibile per il download.

Il nome del programma, Stator, deve ovviamente ricordare lo scopo del progetto: rendere statico il contenuto di un sito internet dinamico.
Tuttavia STATOR è anche l'acronimo di STAtic Trekkers Offline Resource.

Stato attuale

Al momento il software è nello stato Release Candidate, i pacchetti generati sono sostanzialmente completi, anche se la veste grafica deve essere perfezionata. Il pacchetto è pronto per essere distribuito al pubblico generale.
Fate riferimento alle News qui a destra per gli aggiornamenti sullo sviluppo.

Files disponibili

Di seguito sono elencati i files disponibili per questo progetto

Problemi aperti

In questa sezione trovate i problemi che incontro durante la programmazione.
Chiunque abbia una idea per risolverli o aggirarli è pregato di contribuire nella apposita mailing list.

Query parametriche - Soluzione proposta. In test

Non riesco a eseguire una query parametrica. Per esempio, il frammento di codice seguente non ritorna nessun risultato.

cmdMenu = mnuConn.CreateCommand
parm = New MySqlParameter("@topTag", baseTag)
parm.MySqlDbType = MySqlDbType.String
cmdMenu.Parameters.Add(parm)
cmdMenu.CommandText = "SELECT * FROM sezioni WHERE toptag=@topTag"

Lo stesso codice funziona perfettamente per altri tipi di provider, ma con il mySQL Connector non c'e' niente da fare.
Ho consultato la documentazione sul sito, ma non ho trovato nessun aiuto.

---

Formattazione dell'output XML - Aperto

Non riesco a fare in modo che le pagine HTML siano indentate e spaziate come dovrebbero.
Per crearle uso un XmlWriter che, secondo le note del MSDN è configurato così:

Dim settings As New XmlWriterSettings

With settings
.Indent = True
.IndentChars = " "
.NewLineChars = Environment.NewLine
.ConformanceLevel = ConformanceLevel.Fragment
.Encoding = System.Text.Encoding.UTF8
End With

Dim writer As XmlWriter = XmlWriter.Create(htmPath, settings)

Tuttavia il codice HTML che viene salvato è scritto su una sola riga e senza indentazione.

News

• RC2
  30/03/2008 12.35.00
  Aggiunte le pagine di descrizione.
  CSS modificato.
  Il software è passato alla Release Candidate 2.
• Bugfix
  02/03/2008 21.49.00
  Risolti alcuni problemi di formattazione dei titoli nella tabella Guest.
  Corretta la formattazione della tabella delle informazioni sui pianeti.
• Modifiche estetiche
  18/11/2007 21.55.25
  Modifica della visualizzazione dei rimandi dei capitoli esterni a una pagina.
  Piccola modifica al più di pagina
• Nuove funzioni
  11/11/2007 19.48.00
  Anche la versione offline implementa da questo pomeriggio la funzione che permette di visualizzare capitoli 'estranei' a ogni pagina, con un riferimento alla sorgente.
  Piccola revisione del sistema di creazione dei link, poche modifiche evidenti all'utente finale
• Modifiche estetiche
  23/09/2007 13.41.44
  Piccole modifiche al layout delle pagine e revisione del CSS.
• Grafica e immagini
  02/09/2007 15.49.00
  Tabelle riassuntive completate.
  Revisione grafica e CSS riscritto.
  Immagini scaricate solo su modifica.
• Menu e immagini
  29/08/2007 13.54.00
  Bugfix dei menu di navigazione.
  Aggiunto il link al menu superiore.
  Integrazione immagini automatica.
  Aggiunta data modifica pagina.
• Immagini
  19/08/2007 21.32.00
  Primo versione del downloader delle immagini. Integrazione manuale.
• Tabelle riassuntive
  18/08/2007 18.21.00
  Prima versione delle Tabelle riassuntive.
  Bugfix.
• Feed RSS
  17/08/2007 22.51.00
  Aggiunto un feed RSS per il progetto. Segnala le news e il link all'ultimo pacchetto disponibile.

ToDo List

• Verificare ordinamento delle voci nel menu 'Timeline'
• Ridurre l'albero delle cartelle nell'archivio ZIP
• Classifiche nei QV da rivedere
• Rimuovere RSS.
  Spostare FAVICO e CSS in locale
• Alla fina della elaborazione, calcolare MD5 del file zip e annotarlo
• Stabilire se rimuovere i link a risorse internet da tutte le pagine o solo dalla HomePage

Credits