mirror of
https://github.com/php/doc-it.git
synced 2026-03-23 23:22:07 +01:00
Add Italian translations for chmonly section (#101)
* Add Italian translations for chmonly section Translate integration.xml, search.xml, and usingchm.xml to Italian. These files document CHM Help viewer integration, full-text search, and usage instructions for the PHP Manual CHM edition. * Fix EN-Revision hashes and maintainer metadata * Translate HTML Application * Translate redirector --------- Co-authored-by: Davide Pastore <pasdavide@gmail.com>
This commit is contained in:
125
chmonly/integration.xml
Normal file
125
chmonly/integration.xml
Normal file
@@ -0,0 +1,125 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lacatoire Status: ready -->
|
||||
<chapter xml:id="chm.integration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>Integrare il Manuale PHP</title>
|
||||
|
||||
<para>
|
||||
<note>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
</note>
|
||||
</para>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
Supponiamo che tu abbia posizionato il tuo <filename>php_manual_it.chm</filename> in
|
||||
<filename>c:\phpmanual</filename>, il file indice nel manuale (che
|
||||
vedi la prima volta) può essere accessibile con il seguente URL:
|
||||
<literal>mk:@MSITStore:C:\phpmanual\php_manual_it.chm::/_index.html</literal>.
|
||||
Qui <literal>mk:@MSITStore:</literal> è il "protocollo" speciale,
|
||||
<filename>C:\phpmanual\php_manual_it.chm</filename> è il CHM con il suo
|
||||
percorso completo. La parte <filename>/_index.html</filename> è il percorso del
|
||||
file indice all'interno del CHM e <literal>::</literal> è semplicemente ciò che devi
|
||||
mettere tra il percorso del CHM e questo percorso del file.
|
||||
</para>
|
||||
<para>
|
||||
<note>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
</note>
|
||||
</para>
|
||||
<para>
|
||||
I nomi dei file generati seguono le stesse regole del manuale
|
||||
online, tranne che l'estensione è <literal>.html</literal> e
|
||||
non <literal>.php</literal>. La cosa più importante è che i file
|
||||
di documentazione delle funzioni sono denominati <filename>function.NOMEFUNZIONE.html</filename>
|
||||
dove <literal>NOMEFUNZIONE</literal> è il nome della funzione, con tutti
|
||||
gli underscore convertiti in trattini. Alcuni esempi sono
|
||||
<filename>function.echo.html</filename>,
|
||||
<filename>function.mysql-close.html</filename>,
|
||||
<filename>function.imagecopy.html</filename>.
|
||||
</para>
|
||||
<para>
|
||||
Utilizzando tutte queste informazioni, puoi mostrare una pagina del manuale per una funzione
|
||||
richiesta da un utente. Un semplice esempio è incluso nella distribuzione,
|
||||
denominato <filename>php_quickref.hta</filename>. Questa è un'
|
||||
<link xlink:href="&url.chm.hta;">Applicazione HTML</link> per dimostrare il
|
||||
semplice processo di mostrare una pagina del manuale per una funzione. La
|
||||
funzione <literal>quickRef()</literal> definita al suo interno fa il lavoro.
|
||||
</para>
|
||||
<para>
|
||||
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 <filename>_function.html</filename> incluso per accedere
|
||||
a una pagina di funzione. Questo file è semplicemente un reindirizzatore, e può essere parametrizzato tramite
|
||||
l'URL, come <filename>_function.html#mysql_close</filename>. Questa pagina
|
||||
ti reindirizzerà automaticamente alla pagina della funzione mysql_close
|
||||
(<filename>function.mysql-close.html</filename>). 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).
|
||||
</para>
|
||||
<para>
|
||||
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).
|
||||
</para>
|
||||
<para>
|
||||
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
|
||||
<link xlink:href="&url.chm.helpware;">&url.chm.helpware;</link>, così come
|
||||
link ad altre risorse utili. Il sito ufficiale per HTML Help è
|
||||
su <link xlink:href="&url.chm;">&url.chm;</link>.
|
||||
</para>
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
indent-tabs-mode:nil
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:nil
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
314
chmonly/search.xml
Normal file
314
chmonly/search.xml
Normal file
@@ -0,0 +1,314 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: dcd5448282973a659f62e4240fb6e50aae0eb78b Maintainer: lacatoire Status: ready -->
|
||||
<chapter xml:id="chm.search" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>La Ricerca Full Text</title>
|
||||
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
<sect1 xml:id="chm.search.rules">
|
||||
<title>Regole generali di ricerca</title>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
Le regole di base per formulare query sono le seguenti:
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>Le ricerche non fanno distinzione tra maiuscole e minuscole, quindi puoi digitare la tua ricerca in caratteri maiuscoli o minuscoli.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
I segni di punteggiatura come il punto (.), i due punti (:), il punto e virgola (;), la virgola (,),
|
||||
e il trattino (-) vengono ignorati durante una ricerca.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Raggruppa gli elementi della tua ricerca usando virgolette doppie o parentesi per separare ogni elemento. Non puoi cercare virgolette.</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
<para>
|
||||
<note>
|
||||
<para>
|
||||
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."
|
||||
</para>
|
||||
</note>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="chm.search.words">
|
||||
<title>Cercare parole o frasi</title>
|
||||
<para>
|
||||
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.
|
||||
<table>
|
||||
<title>Ricerche di parole e frasi</title>
|
||||
<tgroup cols="3">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Cerca</entry>
|
||||
<entry>Esempio</entry>
|
||||
<entry>Risultati</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Una singola parola</entry>
|
||||
<entry>select</entry>
|
||||
<entry>Argomenti che contengono la parola "select". (Troverai anche le sue variazioni grammaticali, come "selector" e "selection".)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Una frase</entry>
|
||||
<entry>"new operator" oppure new operator</entry>
|
||||
<entry>
|
||||
<simpara>
|
||||
Argomenti che contengono la frase letterale "new operator" e tutte le sue variazioni grammaticali.
|
||||
</simpara>
|
||||
<simpara>
|
||||
Senza le virgolette, la query è equivalente a specificare "new AND operator", che
|
||||
troverà argomenti contenenti entrambe le singole parole, invece della frase.
|
||||
</simpara>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Espressioni con caratteri jolly</entry>
|
||||
<entry>esc* oppure HT??</entry>
|
||||
<entry>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</para>
|
||||
<para>
|
||||
<note>
|
||||
<para>
|
||||
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".
|
||||
</para>
|
||||
</note>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="chm.search.terms">
|
||||
<title>Definire i termini di ricerca</title>
|
||||
<para>
|
||||
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".
|
||||
<table>
|
||||
<title>Operatori di ricerca</title>
|
||||
<tgroup cols="3">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Cerca</entry>
|
||||
<entry>Esempio</entry>
|
||||
<entry>Risultati</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Entrambi i termini nello stesso argomento</entry>
|
||||
<entry>http AND apache</entry>
|
||||
<entry>Argomenti contenenti sia la parola "http" che "apache".</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Uno dei termini in un argomento</entry>
|
||||
<entry>ming OR swflib</entry>
|
||||
<entry>Argomenti contenenti la parola "ming" o la parola "swflib" o entrambe.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Il primo termine senza il secondo termine</entry>
|
||||
<entry>xml NOT expat</entry>
|
||||
<entry>Argomenti contenenti la parola "xml" ma non la parola "expat".</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Entrambi i termini nello stesso argomento, vicini</entry>
|
||||
<entry>database NEAR security</entry>
|
||||
<entry>Argomenti contenenti la parola "database" entro otto parole dalla parola "security".</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</para>
|
||||
<para>
|
||||
<note>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
</note>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="chm.search.nested">
|
||||
<title>Usare espressioni annidate nella ricerca</title>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
Le regole di base per cercare argomenti di aiuto usando espressioni annidate sono
|
||||
le seguenti:
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Puoi usare le parentesi per annidare espressioni all'interno di una query. Le
|
||||
espressioni tra parentesi vengono valutate prima del resto della query.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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".
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Non puoi annidare espressioni per più di cinque livelli di profondità.</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</sect1>
|
||||
<!--
|
||||
<sect1 xml:id="chm.search.notes">
|
||||
<title>Manual Content and User Note Separation</title>
|
||||
<para>
|
||||
The manual content and the user notes are separated to
|
||||
<filename>php_manual_LANG.chm</filename> and
|
||||
<filename>php_manual_notes.chm</filename>. There were several reasons
|
||||
to do this, including:
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
This way you can update the user notes and the manual independently
|
||||
as you need.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
You can have more than one language of the manual, while only
|
||||
need to have one notes file. All the CHM files need to be in the
|
||||
same directory, and all translations need to share the same
|
||||
preferences if you would not like to have more then one notes file.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
You can bookmark manual pages with notes, or just a notes part
|
||||
of a page separately.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
You can "turn off" user note display and user note search results by
|
||||
simply deleting <filename>php_manual_notes.chm</filename>, moving it
|
||||
out of the directory or renaming it.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
All these benefits lead us to provide the manual the way you can see it
|
||||
right now. This distribution had the effect on the full text search that
|
||||
you get search results from the manual content and from the user notes
|
||||
as separate ones. The "Location" column shows the source of the result,
|
||||
also enabling you to "add precedence" to manual content results with
|
||||
ordering the results by "Location". User note page titles are also
|
||||
prefixed with "N:" to make them easily distinguishable in the favorites
|
||||
list (there's no location info in the favorites list).
|
||||
</para>
|
||||
</sect1>
|
||||
-->
|
||||
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
indent-tabs-mode:nil
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:nil
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
554
chmonly/usingchm.xml
Normal file
554
chmonly/usingchm.xml
Normal file
@@ -0,0 +1,554 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: lacatoire Status: ready -->
|
||||
<chapter xml:id="chm.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>Usare l'Edizione CHM del Manuale PHP</title>
|
||||
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
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 <filename>hh.dat</filename>. 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 <filename>hh.dat</filename>.
|
||||
</para>
|
||||
|
||||
<sect1 xml:id="chm.using.toolbar">
|
||||
<title>La Barra degli Strumenti di HTML Help</title>
|
||||
<para>
|
||||
La Barra degli Strumenti di HTML Help contiene le seguenti icone,
|
||||
quando visualizzi il Manuale PHP:
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>Nascondi/Mostra - Nasconde/mostra il pannello di navigazione.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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).
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Indietro - Torna indietro nella cronologia.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Avanti - Va avanti nella cronologia.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Aggiorna - Ricarica la pagina corrente.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Home - Apre la pagina iniziale del CHM.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Stampa - Apre la finestra di dialogo di stampa.</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>Opzioni - Fornisce un menu a discesa con più opzioni.</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
Usare questa barra degli strumenti è davvero facile, molte delle icone
|
||||
della barra degli strumenti sono strettamente correlate ai loro equivalenti
|
||||
di Internet Explorer.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="chm.using.navpane">
|
||||
<title>Il Pannello di Navigazione</title>
|
||||
<para>
|
||||
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.
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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).
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="chm.using.keyshorts">
|
||||
<title>Scorciatoie da Tastiera</title>
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
<table>
|
||||
<title>Scorciatoie Generali del Visualizzatore di Aiuto</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Chiudere il Visualizzatore di Aiuto</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>F4</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare il menu Opzioni</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>O</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Nascondere o mostrare il pannello di Navigazione</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>O</keycap>
|
||||
</keycombo>,
|
||||
e poi <keycap>T</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Stampare un argomento</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>O</keycap>
|
||||
</keycombo>,
|
||||
e poi <keycap>P</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Tornare all'argomento precedente</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>FRECCIA SINISTRA</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Avanzare all'argomento successivo (se lo hai appena visualizzato)</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>FRECCIA DESTRA</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Attivare o disattivare l'evidenziazione della ricerca.</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>O</keycap>
|
||||
</keycombo>,
|
||||
e poi <keycap>O</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Tornare alla pagina iniziale del file di aiuto</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>O</keycap>
|
||||
</keycombo>,
|
||||
e poi <keycap>H</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Passare dal pannello di Navigazione al pannello Argomento</entry>
|
||||
<entry><keycap>F6</keycap></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Scorrere tutti i link in un argomento o tutte le opzioni in una scheda del pannello di Navigazione</entry>
|
||||
<entry><keycap>TAB</keycap></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare il menu contestuale (clic destro)</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>SHIFT</keycap>
|
||||
<keycap>F10</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<title>Scorciatoie della Scheda Contenuti</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Visualizzare la scheda Contenuti</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>C</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Aprire e chiudere un libro o cartella</entry>
|
||||
<entry>
|
||||
<keycap>+</keycap> e <keycap>-</keycap>
|
||||
oppure <keycap>FRECCIA SINISTRA</keycap> e <keycap>FRECCIA DESTRA</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Selezionare un argomento</entry>
|
||||
<entry>
|
||||
<keycap>FRECCIA GIÙ</keycap> e <keycap>FRECCIA SU</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare l'argomento selezionato</entry>
|
||||
<entry><keycap>INVIO</keycap></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<title>Scorciatoie della Scheda Indice</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Visualizzare la scheda Indice</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>N</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Digitare una parola chiave da cercare</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>W</keycap>
|
||||
</keycombo>,
|
||||
e poi digita la parola
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Selezionare una parola chiave nell'elenco</entry>
|
||||
<entry>
|
||||
<keycap>FRECCIA SU</keycap> e <keycap>FRECCIA GIÙ</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare l'argomento associato</entry>
|
||||
<entry>
|
||||
<keycap>INVIO</keycap> oppure
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>D</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<title>Scorciatoie della Scheda Cerca</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Visualizzare la scheda Cerca</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>S</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Digitare una parola chiave da cercare</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>W</keycap>
|
||||
</keycombo>,
|
||||
e poi digita la parola
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Avviare una ricerca</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>L</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Selezionare un argomento nell'elenco dei risultati</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>T</keycap>
|
||||
</keycombo>,
|
||||
e poi
|
||||
<keycap>FRECCIA SU</keycap> e <keycap>FRECCIA GIÙ</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare l'argomento selezionato</entry>
|
||||
<entry>
|
||||
<keycap>INVIO</keycap> oppure
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>D</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Cercare una parola chiave nell'elenco dei risultati di una ricerca precedente</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>U</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
Cercare parole simili alla parola chiave.
|
||||
Per esempio, per trovare parole come "running" e "runs" per la parola chiave "run"
|
||||
</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>M</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Cercare solo nei titoli degli argomenti</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>R</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<title>Scorciatoie della Scheda Preferiti</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Visualizzare la scheda Preferiti</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>I</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Aggiungere l'argomento attualmente visualizzato all'elenco dei Preferiti</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>A</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Selezionare un argomento nell'elenco dei Preferiti</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>P</keycap>
|
||||
</keycombo>,
|
||||
e poi
|
||||
<keycap>FRECCIA SU</keycap> e <keycap>FRECCIA GIÙ</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Visualizzare l'argomento selezionato</entry>
|
||||
<entry>
|
||||
<keycap>INVIO</keycap> oppure
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>D</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Rimuovere l'argomento selezionato dall'elenco</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>ALT</keycap>
|
||||
<keycap>R</keycap>
|
||||
</keycombo>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<title>Scorciatoie del Pannello Argomento</title>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Per</entry>
|
||||
<entry>Premi</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Ricerca nell'Indice</entry>
|
||||
<entry>
|
||||
Seleziona le parole che vorresti cercare e premi
|
||||
<keycap>F1</keycap>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Trova nella pagina</entry>
|
||||
<entry>
|
||||
<keycombo action='simul'>
|
||||
<keycap>CTRL</keycap>
|
||||
<keycap>F</keycap>
|
||||
</keycombo>,
|
||||
e poi regola le opzioni
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Aggiorna pagina</entry>
|
||||
<entry><keycap>F5</keycap></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
indent-tabs-mode:nil
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:nil
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
Reference in New Issue
Block a user