# translation of Publican Users' Guide to Italiano
#
# Luigi Votta <lewis41@fedoraproject.org>, 2010, 2011 
msgid ""
msgstr ""
"Project-Id-Version: 0\n"
"POT-Creation-Date: 2011-09-09T14:23:21\n"
"PO-Revision-Date: 2010-09-10T16:12:51\n"
"Last-Translator: <lewis41@fedoraproject.org>\n"
"Language-Team: Italian <trans-it@lists-fedoraproject.org>\n"
"Language: it-IT\n"
"MIME-Version: 1.0\n"
"Content-Type: application/x-publican; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. Tag: title
#, no-c-format
msgid "Creating the website structure"
msgstr "Creare la struttura del sito web"

#. Tag: para
#, no-c-format
msgid "To build the website structure:"
msgstr "Per creare la struttura del sito web:"

#. Tag: para
#, no-c-format
msgid "On your workstation, create a new directory and change into it. For example, on a Linux system, run:"
msgstr "Sulla propria macchina, creare una nuova cartella, in cui poi spostarsi. Per esempio, su un sistema Linux, eseguire:"

#. Tag: screen
#, no-c-format
msgid ""
"<command>mkdir ~/docsite</command>\n"
"<command>cd ~/docsite</command>"
msgstr ""
"<command>mkdir ~/docsite</command>\n"
"<command>cd ~/docsite</command>"

#. Tag: para
#, no-c-format
msgid "Run <command>publican create_site</command>, specifying the following parameters:"
msgstr "Eseguire <command>publican create_site</command>, specificando i seguenti parametri:"

#. Tag: para
#, no-c-format
msgid "<option>--site_config</option> — the name of the configuration file for your site, with the filename extension <filename>.cfg</filename>"
msgstr "<option>--site_config</option> —  il nome del file di configurazione, per il sito, con estensione <filename>.cfg</filename>"

#. Tag: para
#, no-c-format
msgid "<option>--db_file</option> — the name of the SQLite database file for your site, with the filename extension <filename>.db</filename>"
msgstr "<option>--db_file</option> — il nome del file di database SQLite, per il sito, con estensione <filename>.db</filename>"

#. Tag: para
#, no-c-format
msgid "<option>--toc_path</option> — the path to the directory in which you will place your documents"
msgstr "<option>--toc_path</option> — il percorso alla cartella in cui saranno salvati i documenti"

#. Tag: para
#, no-c-format
msgid "On a computer with an operating system other than Linux, also set:"
msgstr "Su un computer con sistema operatvio diverso da Linux, impostare anche:"

#. Tag: para
#, no-c-format
msgid "<option>--temp_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\\templates</filename>."
msgstr "<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\\templates</filename>."

#. Tag: para
#, no-c-format
msgid "For example:"
msgstr "Per esempio:"

#. Tag: screen
#, no-c-format
msgid "<command>publican create_site --site_config foomaster.cfg --db_file foomaster.db --toc_path html/docs</command>"
msgstr "<command>publican create_site --site_config foomaster.cfg --db_file foomaster.db --toc_path html/docs</command>"

#. Tag: para
#, no-c-format
msgid "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."
msgstr "E' possibile assegnare dei nomi ai file di configurazione e di database del sito per un miglior riconoscemento 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."

#. Tag: para
#, no-c-format
msgid "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:"
msgstr "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:"

#. Tag: para
#, no-c-format
msgid "Specify the title with the <parameter>title</parameter> parameter, for example:"
msgstr "Specificare il titolo con il parametro <parameter>title</parameter>, per esempio:"

#. Tag: programlisting
#, no-c-format
msgid "title: \"Foomaster Documentation\""
msgstr "title: \"Foomaster Documentation\""

#. Tag: para
#, no-c-format
msgid "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."
msgstr "Normalmente, i visitatori del sito non visualizzano questo titolo parchè il JavaScript del sito li reindirizza alla homepage. Comunque il titolo è facilmente individuato ed indicizzato dai motori di ricerca."

#. Tag: para
#, no-c-format
msgid "Specify the web host with the <parameter>host</parameter> parameter as a full URL, including the protocol (for example, <literal>http://</literal>). For example:"
msgstr "Specificare con il parametro <parameter>host</parameter>, il web host indicando l'URL completo, incluso il protocollo. Per esempio:"

#. Tag: programlisting
#, no-c-format
msgid "host: http://docs.example.com"
msgstr "host: http://docs.example.com"

#. Tag: para
#, no-c-format
msgid "<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."
msgstr "<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."

#. Tag: para
#, no-c-format
msgid "Optionally, construct a search engine query to use with the search box in the navigation menu and specify the entire content of a HTML <sgmltag>&lt;form&gt;</sgmltag> 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."
msgstr "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>."

#. Tag: para
#, no-c-format
msgid "For example, to construct a Yahoo! search limited to <literal>docs.example.com</literal>, set:"
msgstr "Per esempio, per costruire una ricerca basata su Yahoo!, limitatamente all'host <literal>docs.example.com</literal>, impostare:"

#. Tag: programlisting
#, no-c-format
msgid "search: '&lt;form target=\"_top\" method=\"get\" action=\"http://search.yahoo.com/search\"&gt; &lt;div class=\"search\"&gt; &lt;input type=\"text\" name=\"p\" value=\"\" /&gt; &lt;input type=\"hidden\" name=\"vs\" value=\"docs.example.com\" /&gt; &lt;input type=\"submit\" value=\"###Search###\" /&gt; &lt;/div&gt; &lt;/form&gt;'"
msgstr "search: '&lt;form target=\"_top\" method=\"get\" action=\"http://search.yahoo.com/search\"&gt; &lt;div class=\"search\"&gt; &lt;input type=\"text\" name=\"p\" value=\"\" /&gt; &lt;input type=\"hidden\" name=\"vs\" value=\"docs.example.com\" /&gt; &lt;input type=\"submit\" value=\"###Search###\" /&gt; &lt;/div&gt; &lt;/form&gt;'"

#. Tag: para
#, no-c-format
msgid "Refer to the documentation of your chosen search engine for details of how to construct custom searches."
msgstr "Fare riferimento alla documentazione del motore di ricerca scelto, per i dettagli su come creare criteri di ricerca personalizzati."

#. Tag: para
#, no-c-format
msgid "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."
msgstr "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>."

#. Tag: title
#, no-c-format
msgid "Important — the search parameter is not validated"
msgstr "Importante — il parametro <parameter>search</parameter> non è validato"

#. Tag: para
#, no-c-format
msgid "<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."
msgstr "<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à."

#. Tag: para
#, no-c-format
msgid "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:"
msgstr "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 pubblca 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:"

#. Tag: programlisting
#, no-c-format
msgid "def_lang: fr-FR"
msgstr "def_lang: it-IT"

#. Tag: para
#, no-c-format
msgid "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."
msgstr "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."

#. Tag: para
#, no-c-format
msgid "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 <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:"
msgstr "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>:"

#. Tag: term
#, no-c-format
msgid "<parameter>dump</parameter>"
msgstr "<parameter>dump</parameter>"

#. Tag: para
#, no-c-format
msgid "Set <literal>dump: 1</literal> to enable the dump file function. This parameter defaults to <literal>0</literal> (off)."
msgstr "Impostare <literal>dump: 1</literal> per abilitare la funzione di file dump. Il parametro, in modo predefinito, è impostato su <literal>0</literal> (disattivato)."

#. Tag: term
#, no-c-format
msgid "<parameter>dump_file</parameter>"
msgstr "<parameter>dump_file</parameter>"

#. Tag: para
#, no-c-format
msgid "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>."
msgstr "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>."

#. Tag: term
#, no-c-format
msgid "<parameter>zip_dump</parameter>"
msgstr "<parameter>zip_dump</parameter>"

#. Tag: para
#, no-c-format
msgid "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)."
msgstr "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)."

#. Tag: para
#, no-c-format
msgid "Refer to <xref linkend=\"dump_file\" /> for a description of the contents of the dump file."
msgstr "Fare riferimento all'<xref linkend=\"dump_file\" /> per una descrizione del contenuto del file dump."

#. Tag: para
#, no-c-format
msgid "Optionally, specify that the site tables of contents will be updated manually with the <parameter>manual_toc_update</parameter> parameter, for example:"
msgstr "Opzionalmente, specificare con il parametro <parameter>manual_toc_update</parameter>, che le tabelle dei contenuti sono aggiornate manualmente, per esempio:"

#. Tag: programlisting
#, no-c-format
msgid "manual_toc_update: 1"
msgstr "manual_toc_update: 1"

#. Tag: para
#, no-c-format
msgid "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 <command>publican update_site</command> command."
msgstr "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>."

#. Tag: para
#, no-c-format
msgid "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-Users_Guide-Website-homepage-manual\" />. 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:"
msgstr "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-Users_Guide-Website-homepage-manual\" />. 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:"

#. Tag: screen
#, no-c-format
msgid "<command>touch site_overrides.css</command>"
msgstr "<command>touch site_overrides.css</command>"

#. Tag: para
#, no-c-format
msgid "To make <application>Publican</application> refresh the site structure at any time, run:"
msgstr "Per aggiornare la struttura del sito, eseguire:"

#. Tag: screen
#, no-c-format
msgid "<command>publican update_site --site_config <replaceable>path_to_site_configuration_file</replaceable>.cfg</command>"
msgstr "<command>publican update_site --site_config <replaceable>percorso_al_file_di_configuration_del_sito</replaceable>.cfg</command>"