Ciao a tutti,
innanzitutto vorrei ringraziare chi gestisce il sito per il servizio infinito che fornisce.
Vorrei però segnalare un problema, e chiedere se sia possibile correggere gli spezzoni di codice presenti sul sito affetti da tale problema. Tali spezzoni contengono errori comuni anche ad altri siti analoghi, quindi non li ho mai segnalati, però questa volta mi sono detto: «perché non chiedere?».
Mi spiego, prendiamo ad esempio un file XML visibile alla pagina http://www.html.it/articoli/introduz...d-hibernate-3/
Copincollandolo su un file.xml ed aprendolo con programma qualsiasi in grado di interpretare XML (come Notepad++), noteremo molti errori.
Quello più classico: gli apici doppi e singoli non sono quelli accettati in programmazione, ma quelli di aperti/chiusi, inclinati (per intenderci, quelli che sono inseriti da Word o Libreoffice quando scriviamo un documento).
L'errore più infido (che mi ha convinto ad aprire questa discussione) però è quello alla riga:
codice:
<!– Database connection settings –>
anche aggiungendo un trattino al commento <!–- blabla -–>, non riuscivo a capire perché il commento non venisse riconosciuto come tale.
Ecco il motivo: quello che sembra un trattino breve, usato in programmazione, è in realtà il trattino lungo (Word e compagnia modificano due trattini brevi in uno lungo mentre scriviamo). I tipi di carattere monospaziati usati in programmazione, per ovvi motivi, visualizzano i trattini lunghi e brevi con la stessa lunghezza.
Non sarebbe un problema se non fosse codice, e comunque non è neanche tanto grave, se non fosse una guida per principianti, che di tutto hanno bisogno eccetto che distinguere i trattini lunghi da quelli brevi. In seguito copincollo il file, sperando che nella pagina dove appare venga corretto in breve, assieme a tutti gli altri esempi del sito:
codice:
<?xml version=’1.0′ encoding=’utf-8′?>
<!DOCTYPE hibernate-configuration PUBLIC
”-//Hibernate/Hibernate Configuration DTD 3.0//EN”
”http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd”>
<hibernate-configuration>
<session-factory>
<!– Database connection settings –>
<property name=”connection.driver_class”>org.hsqldb.jdbcDriver</property>
<!-- (...) -->
<property name=”hbm2ddl.auto”>create</property>
<mapping resource=”it/html/hibernate/Persona.hbm.xml”/>
</session-factory>
</hibernate-configuration>
Tutti i problemi sono risolvibili con un copia-sostituisci, ma sarebbe bene rivedere la fonte dell'errore (qualche form quando si creano i post?) oppure correggere il testo un attimo prima della pubblicazione (per esempio una funzione che analizzi il codice e sostituisca i caratteri indicati sopra).
Infine, il file dopo la correzione (notare i colori corretti, ed il commento riconosciuto come tale):
codice:
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<!-- Database connection settings -->
<property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
<!-- (...) -->
<mapping resource="it/html/hibernate/Persona.hbm.xml"/>
</session-factory>
</hibernate-configuration>