diff --git a/chmonly/integration.xml b/chmonly/integration.xml new file mode 100644 index 000000000..49b06aa51 --- /dev/null +++ b/chmonly/integration.xml @@ -0,0 +1,125 @@ + + + + Integrare il Manuale PHP + + + + + Le informazioni fornite qui sono principalmente rivolte agli autori di IDE, o + agli utenti avanzati che desiderano integrare questo file CHM nei loro + IDE preferiti o in altri componenti dell'ambiente di produzione. + + + + + Esistono diversi editor con supporto per l'integrazione CHM, + ma potresti aver bisogno di conoscere alcune cose sul contenuto del CHM + per integrare con successo il manuale nel tuo ambiente. + + + Il CHM è costruito utilizzando fogli di stile XSL da sorgenti XML. Questo è + attualmente unico nella famiglia del Manuale PHP, poiché tutte le altre versioni sono + generate utilizzando fogli di stile DSSSL. Questo significa anche che + potrebbero verificarsi differenze di rendering non intenzionali. Uno speciale + script di conversione viene eseguito sull'output XSLT, aggiungendo diverse + funzionalità interessanti, e impacchettando il manuale con i file delle preferenze + e gli esempi di skin. + + + Se non hai mai lavorato con i CHM, puoi pensarli come file compressi + con accesso ai file interni supportato dal sistema operativo e con supporto aggiuntivo + per ricerca e indice. Tuttavia i CHM possono essere visualizzati solo utilizzando HTML Help + Viewer, puoi accedere direttamente ai file al loro interno utilizzando un prefisso URL + speciale, il nome del file CHM e il file che richiedi dall'interno. Poiché tutto + il contenuto dell'aiuto è memorizzato in file HTML, puoi mostrare le pagine del CHM + in Internet Explorer. + + + Supponiamo che tu abbia posizionato il tuo php_manual_it.chm in + c:\phpmanual, il file indice nel manuale (che + vedi la prima volta) può essere accessibile con il seguente URL: + mk:@MSITStore:C:\phpmanual\php_manual_it.chm::/_index.html. + Qui mk:@MSITStore: è il "protocollo" speciale, + C:\phpmanual\php_manual_it.chm è il CHM con il suo + percorso completo. La parte /_index.html è il percorso del + file indice all'interno del CHM e :: è semplicemente ciò che devi + mettere tra il percorso del CHM e questo percorso del file. + + + + + Tutti i file sono nella directory radice del CHM, a differenza delle precedenti + versioni CHM che includevano una directory per la lingua. Immagini, fogli di stile + e altri file supplementari hanno nomi che iniziano con un underscore + (come l'indice principale mostrato sopra), per evitare collisioni di nomi. + + + + + I nomi dei file generati seguono le stesse regole del manuale + online, tranne che l'estensione è .html e + non .php. La cosa più importante è che i file + di documentazione delle funzioni sono denominati function.NOMEFUNZIONE.html + dove NOMEFUNZIONE è il nome della funzione, con tutti + gli underscore convertiti in trattini. Alcuni esempi sono + function.echo.html, + function.mysql-close.html, + function.imagecopy.html. + + + Utilizzando tutte queste informazioni, puoi mostrare una pagina del manuale per una funzione + richiesta da un utente. Un semplice esempio è incluso nella distribuzione, + denominato php_quickref.hta. Questa è una + HTML Application per dimostrare il + semplice processo di mostrare una pagina del manuale per una funzione. La + funzione quickRef() definita al suo interno fa il lavoro. + + + Se desideri integrare il manuale in un IDE senza supporto diretto + per il manuale PHP (in particolare la conversione da underscore a trattino), + puoi utilizzare il file _function.html incluso per accedere + a una pagina di funzione. Questo file è semplicemente un redirector, e può essere parametrizzato tramite + l'URL, come _function.html#mysql_close. Questa pagina + ti reindirizzerà automaticamente alla pagina della funzione mysql_close + (function.mysql-close.html). Puoi + fornire il percorso completo di questo file se il tuo IDE supporta l'aiuto + contestuale, e fornire la stringa specificata dall'IDE come parametro. Un esempio + per questo è l'integrazione con UltraEdit 9 (vedi il sito web dell'edizione). + + + L'indice del manuale (accessibile tramite la scheda indice nel pannello + di navigazione) può anche essere utilizzato per scopi di integrazione. Tutte le pagine HTML + sono incluse nell'indice con i loro titoli come termini dell'indice (incluse + le pagine di descrizione delle funzioni). + + + Se sei uno sviluppatore di applicazioni desktop e desideri integrare + strettamente il CHM nel tuo programma (come visualizzare l'albero TOC + nella casella di aiuto del tuo IDE), puoi trovare maggiori informazioni su + &url.chm.helpware;, così come + link ad altre risorse utili. Il sito ufficiale per HTML Help è + su &url.chm;. + + + + diff --git a/chmonly/search.xml b/chmonly/search.xml new file mode 100644 index 000000000..248a42fd9 --- /dev/null +++ b/chmonly/search.xml @@ -0,0 +1,314 @@ + + + + La Ricerca Full Text + + + Questa edizione del Manuale PHP include una possibilità avanzata di ricerca + full text fornita dall'applicazione di visualizzazione. Questo permette + agli utenti di cercare in ogni parola nel file di aiuto per trovare una + corrispondenza. Per esempio, se un utente fa una ricerca full-text sulla parola + "Apache", ogni argomento che contiene la parola "Apache" verrà elencato. + La ricerca full-text avanzata permette a un utente di cercare utilizzando espressioni + booleane, con caratteri jolly e annidate. Un utente può anche limitare la ricerca + ai risultati precedenti, cercare parole simili, o cercare solo nei titoli degli argomenti. + + + + L'uso della funzionalità di ricerca è abbastanza semplice. Clicca sulla + scheda ricerca, digita le parole desiderate e premi INVIO (o clicca + su "Elenca argomenti"). Poi riceverai un elenco di corrispondenze dal + Manuale PHP (e dalle note). Puoi usare il pulsante con una freccia + destra per aggiungere operatori booleani alla tua ricerca (o puoi digitarli + direttamente). Come vedi dai risultati, puoi usare le intestazioni delle colonne + (Titolo, Posizione e Rilevanza) per ordinare l'elenco degli argomenti. L'ordine predefinito + è per Rilevanza. Puoi anche regolare alcuni parametri nella parte inferiore di questa + scheda. + + + + Le parole trovate sono evidenziate sulla pagina corrente nel pannello Argomento + per impostazione predefinita. Puoi disattivare questa funzionalità scegliendo la voce di menu + "Disattiva evidenziazione ricerca" nel menu Opzioni. Per riattivare questa funzionalità + procedi in modo simile. Se stai visualizzando un argomento lungo, solo le prime 500 + istanze di una parola o frase cercata verranno evidenziate, a causa di una + limitazione del visualizzatore. + + + + Regole generali di ricerca + + Una ricerca di base consiste nella parola o frase che vuoi trovare. Puoi + usare espressioni con caratteri jolly, espressioni annidate, operatori booleani, + corrispondenze di parole simili, un elenco di risultati precedenti, o titoli degli argomenti per definire + ulteriormente la tua ricerca. + + + Le regole di base per formulare query sono le seguenti: + + + Le ricerche non fanno distinzione tra maiuscole e minuscole, quindi puoi digitare la tua ricerca in caratteri maiuscoli o minuscoli. + + + + Puoi cercare qualsiasi combinazione di lettere (a-z) e numeri (0-9). + Non puoi cercare singole lettere (a, b, c, ecc.) e parole comuni, + come: an, and, as, at, be, but, by, do, for, from, have, he, + in, it, not, of, on, or, she, that, the, there, they, this, to, we, + which, with, you. + + + + + I segni di punteggiatura come il punto (.), i due punti (:), il punto e virgola (;), la virgola (,), + e il trattino (-) vengono ignorati durante una ricerca. + + + + Raggruppa gli elementi della tua ricerca usando virgolette doppie o parentesi per separare ogni elemento. Non puoi cercare virgolette. + + + + + + + Se stai cercando un nome di file con un'estensione, dovresti raggruppare + l'intera stringa tra virgolette doppie, ("nomefile.ext"). Altrimenti, il punto + dividerà il nome del file in due termini separati. L'operazione predefinita + tra i termini è AND, quindi creerai l'equivalente logico di + "nomefile AND ext." + + + + + + + Cercare parole o frasi + + Puoi cercare parole o frasi e usare espressioni con caratteri jolly. + Le espressioni con caratteri jolly ti permettono di cercare uno o più caratteri + usando un punto interrogativo o un asterisco. La tabella seguente descrive i + risultati di questi diversi tipi di ricerche. + + Ricerche di parole e frasi + + + + Cerca + Esempio + Risultati + + + + + Una singola parola + select + Argomenti che contengono la parola "select". (Troverai anche le sue variazioni grammaticali, come "selector" e "selection".) + + + Una frase + "new operator" oppure new operator + + + Argomenti che contengono la frase letterale "new operator" e tutte le sue variazioni grammaticali. + + + Senza le virgolette, la query è equivalente a specificare "new AND operator", che + troverà argomenti contenenti entrambe le singole parole, invece della frase. + + + + + Espressioni con caratteri jolly + esc* oppure HT?? + + + I risultati per il primo esempio includono argomenti che contengono i termini "ESC", + "escape", "escalation", e così via. L'asterisco non può essere l'unico + carattere nel termine. + + + I risultati per il secondo esempio includono argomenti che contengono i termini "HTTP", + "HTML" e così via. Il punto interrogativo non può essere l'unico carattere nel + termine. + + + + + +
+ + + + + Seleziona la casella Abbina parole simili per includere variazioni grammaticali minori + per la frase che cerchi. Questa funzionalità individua solo variazioni della parola con + suffissi comuni. Per esempio, una ricerca sulla parola "add" troverà "added", ma + non troverà "additive". Questa opzione è indipendente dalle altre opzioni o sintassi. + Se fai una ricerca solo nei titoli, verranno abbinate le variazioni nei titoli. Se usi + virgolette (o qualsiasi altro operatore di query) qualsiasi variazione della parola può apparire; per + esempio, "stemmed search" troverà anche "stemming search". + + + + + + + Definire i termini di ricerca + + Gli operatori AND, OR, NOT e NEAR ti permettono di definire precisamente la tua + ricerca creando una relazione tra i termini di ricerca. La seguente tabella + mostra come puoi usare ciascuno di questi operatori. Se non viene specificato alcun operatore, + viene usato AND. Per esempio, la query "server cgi security" è equivalente + a "server AND cgi AND security". + + Operatori di ricerca + + + + Cerca + Esempio + Risultati + + + + + Entrambi i termini nello stesso argomento + http AND apache + Argomenti contenenti sia la parola "http" che "apache". + + + Uno dei termini in un argomento + ming OR swflib + Argomenti contenenti la parola "ming" o la parola "swflib" o entrambe. + + + Il primo termine senza il secondo termine + xml NOT expat + Argomenti contenenti la parola "xml" ma non la parola "expat". + + + Entrambi i termini nello stesso argomento, vicini + database NEAR security + Argomenti contenenti la parola "database" entro otto parole dalla parola "security". + + + +
+ + + + + I caratteri |, &, e ! possono anche essere usati al posto di OR AND e + NOT rispettivamente. Questo potrebbe non funzionare se usi una versione molto vecchia del + visualizzatore. + + + + + + + Usare espressioni annidate nella ricerca + + Le espressioni annidate ti permettono di creare ricerche complesse per informazioni. + Per esempio, "html AND ((smtp OR pop3) NEAR mail)" trova argomenti + contenenti la parola "html" insieme alle parole "smtp" e "mail" + vicine, o contenenti "html" insieme alle parole "pop3" e + "mail" vicine. + + + Le regole di base per cercare argomenti di aiuto usando espressioni annidate sono + le seguenti: + + + + Puoi usare le parentesi per annidare espressioni all'interno di una query. Le + espressioni tra parentesi vengono valutate prima del resto della query. + + + + + Se una query non contiene un'espressione annidata, viene valutata da sinistra a destra. + Per esempio: "mail NOT pop3 OR smtp" trova argomenti contenenti la parola "mail" senza + la parola "pop3" o argomenti contenenti la parola "smtp". D'altra parte, "mail NOT + (pop3 OR smtp)" trova argomenti contenenti la parola "mail" senza nessuna delle parole + "pop3" o "smtp". + + + + Non puoi annidare espressioni per più di cinque livelli di profondità. + + + + + + + + + diff --git a/chmonly/usingchm.xml b/chmonly/usingchm.xml new file mode 100644 index 000000000..54e56463d --- /dev/null +++ b/chmonly/usingchm.xml @@ -0,0 +1,554 @@ + + + + Usare l'Edizione CHM del Manuale PHP + + + Quando fai doppio clic su un CHM, si apre una finestra del Visualizzatore + HTML Help con tre pannelli. Sul lato sinistro della finestra c'è + il pannello di Navigazione. Contiene quattro schede di navigazione: + le schede Contenuti, Indice, Cerca e Preferiti. Sul lato destro + della finestra c'è il pannello Argomento. Mostra l'argomento + di aiuto selezionato, o l'argomento di aiuto predefinito all'avvio. + Le pagine di aiuto sono tutti file HTML separati, il tuo Internet + Explorer mostra le pagine nel pannello Argomento. Il terzo pannello + è la barra degli strumenti, che si trova sotto la barra del titolo della finestra di aiuto. + Puoi regolare il layout orizzontale trascinando il bordo verticale + tra il pannello di Navigazione e il pannello Argomento. + + + + Nota che quando apri il CHM la prima volta, potrebbe + apparire in una posizione e dimensione strane. Da quel momento, Windows + ricorda la posizione della finestra, la dimensione e l'ultima scheda + aperta. Tutte queste informazioni, inclusi i tuoi preferiti, sono memorizzate in un + file chiamato hh.dat. Se sposti il tuo + file in un'altra directory, tutte queste impostazioni memorizzate + andranno perse (incluso il tuo elenco di preferiti!). Se + sostituisci il tuo file CHM con uno nuovo, con lo stesso nome, + questo non è un problema però. I nomi dei file e i valori dei percorsi + sono memorizzati in hh.dat. + + + + La Barra degli Strumenti di HTML Help + + La Barra degli Strumenti di HTML Help contiene le seguenti icone, + quando visualizzi il Manuale PHP: + + + Nascondi/Mostra - Nasconde/mostra il pannello di navigazione. + + + + Localizza - Localizza un argomento nella scheda contenuti (nel + caso tu abbia raggiunto un argomento con ricerca, indice o + preferiti, e vorresti vedere dove si trova + nella vista ad albero del sommario). + + + + Indietro - Torna indietro nella cronologia. + + + Avanti - Va avanti nella cronologia. + + + Aggiorna - Ricarica la pagina corrente. + + + Home - Apre la pagina iniziale del CHM. + + + Stampa - Apre la finestra di dialogo di stampa. + + + Opzioni - Fornisce un menu a discesa con più opzioni. + + + Usare questa barra degli strumenti è davvero facile, molte delle icone + della barra degli strumenti sono strettamente correlate ai loro equivalenti + di Internet Explorer. + + + + + Il Pannello di Navigazione + + Il Pannello di Navigazione contiene quattro schede di navigazione: + le schede Contenuti, Indice, Cerca e Preferiti. Queste + forniscono tutte metodi diversi per accedere a un argomento nel + file di aiuto. + + + + La scheda contenuti rivela un sommario ad albero, + dove puoi navigare verso l'argomento desiderato aprendo + e chiudendo parti dell'albero. Puoi anche accedere alle + sezioni più profonde usando questo TOC. Se fai clic destro su + un elemento qui e scegli "Stampa...", avrai l'opzione + di stampare l'argomento selezionato o l'argomento selezionato e + tutti i sottoargomenti. Tuttavia la stampa non è l'obiettivo iniziale + di questa rappresentazione del manuale (la versione PDF è + adatta per la stampa). + + + + + La scheda indice elenca un gran numero di "parole chiave" (in realtà + titoli delle pagine del manuale). Puoi sceglierne una, o iniziare a digitare + una parola chiave, vedere l'elenco adattarsi al tuo input, e poi + cliccare su un argomento, o premere invio se l'argomento selezionato + è quello che vorresti vedere. + + + + + La scheda cerca mostra una delle funzionalità più potenti del + Visualizzatore HTML Help, la ricerca full text (nota anche come + FTS). Qui puoi digitare la tua espressione di ricerca, + opzionalmente collegando parole con AND/OR/NEAR/NOT. Prima + di cliccare su 'Elenca argomenti', puoi anche impostare alcune opzioni + in basso. Dopo che i risultati della ricerca sono visualizzati, + ti renderai conto che i risultati del testo del manuale e delle note utente sono + separati. Per distinguere i due tipi, clicca sull'intestazione della colonna + 'Posizione'. Ora dall'elenco dei risultati della ricerca, + puoi scegliere un argomento e vedere la sua pagina. Le parole chiave che + hai cercato sono evidenziate sulla pagina. + + + + + La scheda preferiti ti permette di memorizzare i tuoi argomenti più usati + in un elenco, facilmente accessibile. Qui puoi vedere + l'elenco, aggiungere l'argomento corrente ad esso, rimuoverne uno, o + visualizzare un elemento selezionato. Puoi anche specificare il tuo + titolo personalizzato per il preferito, digitandolo nella casella 'Argomento + corrente:'. I titoli delle pagine delle note utente sono preceduti + da una stringa 'N:' così puoi distinguerli dalle + normali pagine del manuale nell'elenco dei preferiti. + + + + + + + + Scorciatoie da Tastiera + + Ci sono molte scorciatoie da tastiera che puoi usare per aumentare + la tua produttività. Molti utenti trovano più appropriato + usare queste scorciatoie da tastiera per accedere agli argomenti, invece di + cliccare. + + + + Scorciatoie Generali del Visualizzatore di Aiuto + + + + Per + Premi + + + + + Chiudere il Visualizzatore di Aiuto + + + ALT + F4 + + + + + Visualizzare il menu Opzioni + + + ALT + O + + + + + Nascondere o mostrare il pannello di Navigazione + + + ALT + O + , + e poi T + + + + Stampare un argomento + + + ALT + O + , + e poi P + + + + Tornare all'argomento precedente + + + ALT + FRECCIA SINISTRA + + + + + Avanzare all'argomento successivo (se lo hai appena visualizzato) + + + ALT + FRECCIA DESTRA + + + + + Attivare o disattivare l'evidenziazione della ricerca. + + + ALT + O + , + e poi O + + + + Tornare alla pagina iniziale del file di aiuto + + + ALT + O + , + e poi H + + + + Passare dal pannello di Navigazione al pannello Argomento + F6 + + + Scorrere tutti i link in un argomento o tutte le opzioni in una scheda del pannello di Navigazione + TAB + + + Visualizzare il menu contestuale (clic destro) + + + SHIFT + F10 + + + + + +
+ + + Scorciatoie della Scheda Contenuti + + + + Per + Premi + + + + + Visualizzare la scheda Contenuti + + + ALT + C + + + + + Aprire e chiudere un libro o cartella + + + e - + oppure FRECCIA SINISTRA e FRECCIA DESTRA + + + + Selezionare un argomento + + FRECCIA GIÙ e FRECCIA SU + + + + Visualizzare l'argomento selezionato + INVIO + + + +
+ + + Scorciatoie della Scheda Indice + + + + Per + Premi + + + + + Visualizzare la scheda Indice + + + ALT + N + + + + + Digitare una parola chiave da cercare + + + ALT + W + , + e poi digita la parola + + + + Selezionare una parola chiave nell'elenco + + FRECCIA SU e FRECCIA GIÙ + + + + Visualizzare l'argomento associato + + INVIO oppure + + ALT + D + + + + + +
+ + + Scorciatoie della Scheda Cerca + + + + Per + Premi + + + + + Visualizzare la scheda Cerca + + + ALT + S + + + + + Digitare una parola chiave da cercare + + + ALT + W + , + e poi digita la parola + + + + Avviare una ricerca + + + ALT + L + + + + + Selezionare un argomento nell'elenco dei risultati + + + ALT + T + , + e poi + FRECCIA SU e FRECCIA GIÙ + + + + Visualizzare l'argomento selezionato + + INVIO oppure + + ALT + D + + + + + Cercare una parola chiave nell'elenco dei risultati di una ricerca precedente + + + ALT + U + + + + + + Cercare parole simili alla parola chiave. + Per esempio, per trovare parole come "running" e "runs" per la parola chiave "run" + + + + ALT + M + + + + + Cercare solo nei titoli degli argomenti + + + ALT + R + + + + + +
+ + + Scorciatoie della Scheda Preferiti + + + + Per + Premi + + + + + Visualizzare la scheda Preferiti + + + ALT + I + + + + + Aggiungere l'argomento attualmente visualizzato all'elenco dei Preferiti + + + ALT + A + + + + + Selezionare un argomento nell'elenco dei Preferiti + + + ALT + P + , + e poi + FRECCIA SU e FRECCIA GIÙ + + + + Visualizzare l'argomento selezionato + + INVIO oppure + + ALT + D + + + + + Rimuovere l'argomento selezionato dall'elenco + + + ALT + R + + + + + +
+ + + Scorciatoie del Pannello Argomento + + + + Per + Premi + + + + + Ricerca nell'Indice + + Seleziona le parole che vorresti cercare e premi + F1 + + + + Trova nella pagina + + + CTRL + F + , + e poi regola le opzioni + + + + Aggiorna pagina + F5 + + + +
+ + + + + +