0 - en to it translation catalogue (36 entries)

en: Creating the website structure
it: Creare la struttura del sito web

en: To build the website structure:
it: Per creare la struttura del sito web:

en: On your workstation, create a new directory and change into it. For example, on a Linux system, run:
it: Sulla propria macchina, creare una nuova cartella, in cui poi spostarsi. Per esempio, su un sistema Linux, eseguire:

en: Run <command>publican create_site</command>, specifying the following parameters:
it: Eseguire <command>publican create_site</command>, specificando i seguenti parametri:

en: <option>--site_config</option> — the name of the configuration file for your site, with the filename extension <filename>.cfg</filename>
it: <option>--site_config</option> —  il nome del file di configurazione, per il sito, con estensione <filename>.cfg</filename>

en: <option>--db_file</option> — the name of the SQLite database file for your site, with the filename extension <filename>.db</filename>
it: <option>--db_file</option> — il nome del file di database SQLite, per il sito, con estensione <filename>.db</filename>

en: <option>--toc_path</option> — the path to the directory in which you will place your documents
it: <option>--toc_path</option> — il percorso alla cartella in cui saranno salvati i documenti

en: On a computer with an operating system other than Linux, also set:
it: Su un computer con sistema operativo diverso da Linux, impostare anche:

en: <option>--tmpl_path</option> — the path to the <filename>templates/</filename> directory of your <application>Publican</application> installation. On computers with Windows operating systems, this is typically <filename><replaceable>%SystemDrive%</replaceable>\<replaceable>%ProgramFiles%</replaceable>\Publican	emplates</filename>.
it: <option>--temp_path</option> — il percorso alla cartella <filename>templates/</filename> nella directory di installazione di <application>Publican</application>. Sui computer con sistemi operativi Windows, il percorso tipicamente coincide con <filename><replaceable>%SystemDrive%</replaceable>\<replaceable>%ProgramFiles%</replaceable>\Publican	emplates</filename>.

en: For example:
it: Per esempio:

en: <prompt>$</prompt> <command>publican create_site --site_config foomaster.cfg --db_file foomaster.db --toc_path html/docs</command>
it: <command>publican create_site --site_config foomaster.cfg --db_file foomaster.db --toc_path html/docs</command>

en: You might give names to the site configuration file and database file that help you to recognize the site to which they belong. For example, for the <application>FooMaster</application> documentation site, you might call these files <filename>foomaster.cfg</filename> and <filename>foomaster.db</filename>. You can set <parameter>--toc_path</parameter> to whatever you choose.
it: E' possibile assegnare dei nomi ai file di configurazione e di database del sito per un miglior riconoscimento del sito di appartenenza. Per esempio, per il sito di documentazione <application>FooMaster</application>, si potrebbe assegnare a questi file, rispettivamente, i nomi <filename>foomaster.cfg</filename> e <filename>foomaster.db</filename>. Il parametro <parameter>--toc_path</parameter> può essere impostato a piacere.

en: Edit the site configuration file to specify the name of the site, the web host, and optionally, search parameters, default language, dump file settings, and update settings for the site:
it: Modificare il file di configurazione specificando il nome del sito, il web host ed opzionalmente, impostare i parametri di ricerca, la lingua predefinita, le impostazioni del file dump e quelle di aggiornamento per il sito:

en: Specify the title with the <parameter>title</parameter> parameter, for example:
it: Specificare il titolo con il parametro <parameter>title</parameter>, per esempio:

en: Normally, visitors to your website do not see this title because the site's JavaScript redirects them to a homepage. However, this title is likely to be found and indexed by search engines.
it: Normalmente, i visitatori del sito non visualizzano questo titolo perché il JavaScript del sito li reindirizza alla homepage. Comunque il titolo è facilmente individuato ed indicizzato dai motori di ricerca.

en: Specify the web host with the <parameter>host</parameter> parameter as a full URL, including the protocol (for example, <literal>http://</literal>). For example:
it: Specificare con il parametro <parameter>host</parameter>, il web host indicando l'URL completo, incluso il protocollo. Per esempio:

en: <application>Publican</application> uses the value set for <parameter>host</parameter> to construct the URLs in the XML <filename>Sitemap</filename> that it creates for search engine crawlers, and to limit searches submitted through the search box in the navigation menu to results on your site only.
it: <application>Publican</application> usa il valore impostato in <parameter>host</parameter> per costruire gli URL nel file XML, <filename>Sitemap</filename>, usato dai motori di ricerca e per limitare le ricerche dalla casella relativa nel menu di navigazione, soltanto ai documenti presenti nel sito.

en: Optionally, construct a search engine query to use with the search box in the navigation menu and specify the entire content of a HTML <tag>&lt;form&gt;</tag> with the <parameter>search</parameter> parameter. If you do not specify a custom web search, <application>Publican</application> creates a Google search limited to the host that you specified in the <parameter>host</parameter> parameter.
it: Opzionalmente, costruire un motore di ricerca da usare con la casella di ricerca nel menu di navigazione, e specificare l'intero contenuto del <sgmltag>&lt;form&gt;</sgmltag> HTML con il parametro <parameter>search</parameter>. Se non si specifica alcun criterio di ricerca, <application>Publican</application> crea una ricerca basata su Google, limitando la ricerca all'host specificato dal parametro <parameter>host</parameter>.

en: For example, to construct a Yahoo! search limited to <literal>docs.example.com</literal>, set:
it: Per esempio, per costruire una ricerca basata su Yahoo!, limitatamente all'host <literal>docs.example.com</literal>, impostare:

en: Refer to the documentation of your chosen search engine for details of how to construct custom searches.
it: Fare riferimento alla documentazione del motore di ricerca scelto, per i dettagli su come creare criteri di ricerca personalizzati.

en: If you set <literal>value="###Search###"</literal> in the code for a submit button, <application>Publican</application> uses the word <literal>Search</literal> on the button, localized into any language that <application>Publican</application> supports.
it: Se nel codice di un pulsante di ricerca, si imposta <literal>value="###Search###"</literal>, <application>Publican</application> visualizza il termine <literal>Search</literal> sul pulsante, ovviamente tradotto in ogni lingua supportata da <application>Publican</application>.

en: Important — the search parameter is not validated
it: Importante — il parametro <parameter>search</parameter> non è validato

en: <application>Publican</application> does not validate the <parameter>search</parameter> parameter, but builds the value of this parameter into the navigation menu exactly as you specify it. Be especially careful when you use this feature.
it: <application>Publican</application> non controlla la validità del parametro <parameter>search</parameter>, ma crea il valore di questo parametro nel menu di navigazione, così come specificato. Prestare particolare attenzione nell'usare questa proprietà.

en: Optionally, set the default language of the website. <application>Publican</application> creates a separate, translatable navigation menu for each language in which you publish documentation. However, if a document is not available in a particular language, <application>Publican</application> links visitors to the untranslated version of that document. To specify the default, untranslated language for the site, set <parameter>def_lang</parameter> with a language code. For example:
it: Opzionalmente, impostare la lingua predefinita del sito web. <application>Publican</application> crea un menu di navigazione distinto e tradotto, per ogni lingua in cui si pubblica la documentazione. Comunque, se un documento non è disponibile in una particolare lingua, <application>Publican</application> indirizza i visitatori alla versione in lingua originale del documento. Per specificare la lingua predefinita, originale del sito, impostare il parametro <parameter>def_lang</parameter> con il codice linguistico relativo. Per esempio:

en: def_lang: fr-FR
it: def_lang: it-IT

en: With <parameter>def_lang</parameter> set to <literal>fr-FR</literal>, visitors viewing the navigation menu in (for example) Spanish are presented with a link to the original French version of the document if the document has not yet been translated into Spanish.
it: Impostando il parametro <parameter>def_lang</parameter> con il codice <literal>it-IT</literal>, i visitatori che visualizzano il menu di navigazione, per esempio in spagnolo, vengono diretti alla versione italiana del documento se non è presente una traduzione in spagnolo.

en: Optionally, configure a <firstterm>dump file</firstterm> for the website. <application>Publican</application> can output an XML file that provides complete site content details for delivery of other services, such as web feeds or customised search pages. The file is updated whenever a book is installed or removed from the site, or the <prompt>$</prompt> <command>publican update_site</command> command is run. Configure the <parameter>dump</parameter>, <parameter>dump_file</parameter>, and <parameter>zip_dump</parameter> parameters as follows:
it: Opzionalmente, configurare un <firstterm>file dump</firstterm> per il sito web. <application>Publican</application> può produrre un file XML con i dettagli completi del contenuto del sito per offrire altri servizi, come feed web o pagine di ricerca personalizzate. Questo file viene aggiornato ad ogni installazione o rimozione di un libro dal sito, oppure eseguendo il comando <command>publican update_site</command>. Configurare come indicato di seguito, i parametri <parameter>dump</parameter>, <parameter>dump_file</parameter> e <parameter>zip_dump</parameter>:

en: Set <literal>dump: 1</literal> to enable the dump file function. This parameter defaults to <literal>0</literal> (off).
it: Impostare <literal>dump: 1</literal> per abilitare la funzione di file dump. Il parametro, in modo predefinito, è impostato su <literal>0</literal> (disattivato).

en: Set <literal>dump_file: <replaceable>name</replaceable></literal> to specify the name of the dump file and the directory in which <application>Publican</application> stores it. This parameter defaults to <literal>/var/www/html/DUMP.xml</literal>.
it: Impostare <literal>dump_file: <replaceable>nome</replaceable></literal> per specificare il nome del file dump e la cartella in cui salvare il file. Il parametro, in modo predefinito, è impostato su <literal>/var/www/html/DUMP.xml</literal>.

en: Set <literal>zip_dump: 1</literal> to specify that <application>Publican</application> should create a zipped version of the XML file together with the XML version. This parameter defaults to <literal>0</literal> (off).
it: Impostare <literal>zip_dump: 1</literal> per creare anche una versione zippata del file XML. Il parametro, in modo predefinito, è impostato su <literal>0</literal> (disattivato).

en: Optionally, specify that the site tables of contents will be updated manually with the <parameter>manual_toc_update</parameter> parameter, for example:
it: Opzionalmente, specificare con il parametro <parameter>manual_toc_update</parameter>, che le tabelle dei contenuti sono aggiornate manualmente, per esempio:

en: Normally, <application>Publican</application> updates the site's tables of contents every time a documentation package is added or removed. On a site with a large number of documents on it (more than a few hundred), or where documents are updated very frequently (dozens of updates per week), this process is very demanding on a server. On a large or busy site, we recommend that you set this parameter and then periodically update the tables of contents with the <prompt>$</prompt> <command>publican update_site</command> command.
it: Normalmente, <application>Publican</application> aggiorna le tabelle dei contenuti del sito, ogniqualvolta viene aggiunto o rimosso un pacchetto di documentazione. Su un sito con un gran numero di documenti (più di un centinaio), o in cui i documenti sono spesso aggiornati (dozzine per settimana), questo processo è oneroso di risorse. Su un sito di grandi dimensioni o molto occupato, si raccomanda di impostare questo parametro e poi di aggiornare periodicamente le tabelle dei contenuti con il comando <command>publican update_site</command>.

en: Create an empty file named <filename>site_overrides.css</filename> in the directory that you specified with <option>doc_path</option> (the directory that contains <filename>interactive.css</filename> and the various language directories). If you want to use site-specific styles to override those provided by <filename>interactive.css</filename>, you can add a <filename>site_overrides.css</filename> to the document that provides the site <firstterm>home page</firstterm> — refer to <xref linkend="sect-Publican-Users_Guide-Creating_installing_and_updating_the_home_page" />. If you do not want to use site-specific styles, the empty file you add here will prevent 404 errors on your server. On a Linux system, change into the directory that you specified with <option>doc_path</option> and run:
it: Creare un file vuoto di nome  <filename>site_overrides.css</filename> nella cartella specificata con l'opzione <option>doc_path</option> (la cartella che contiene il foglio di stile <filename>interactive.css</filename> e le cartelle linguistiche). Se si desidera usare degli stili specifici alternativi a quelli forniti da <filename>interactive.css</filename>, aggiungere un file <filename>site_overrides.css</filename> al documento che fornisce la <firstterm>home page</firstterm>  del sito — vedere la <xref linkend="sect-Publican-Users_Guide-Building_a_website_with_Publican-Building_a_website_manually" />. Se non si usa uno stile specifico, il file vuoto aggiunto impedirà la comparsa dell'errore 404 sul server. Su un sistema Linux, spostarsi nella cartella specificata con l'opzione <option>doc_path</option> ed eseguire:

en: <prompt>$</prompt> <command>touch site_overrides.css</command>
it: <command>touch site_overrides.css</command>

en: To make <application>Publican</application> refresh the site structure at any time, run:
it: Per aggiornare la struttura del sito, eseguire:

en: <prompt>$</prompt> <command>publican update_site --site_config <replaceable>path_to_site_configuration_file</replaceable>.cfg</command>
it: <command>publican update_site --site_config <replaceable>percorso_al_file_di_configuration_del_sito</replaceable>.cfg</command>
