0 - en to it translation catalogue (39 entries)

en: Desktop menu entries for documents
it: Voci nel menu del desktop per i documenti

en: By default, RPM packages of <application>Publican</application> documents for desktop use appear on the GNOME desktop under the <menuchoice><guimenu>System</guimenu><guisubmenu>Documentation</guisubmenu></menuchoice> menu. When users have large numbers of documents installed on their systems, this menu becomes very cluttered and difficult to navigate. Documentation for many different products and perhaps different languages becomes intermixed, adding to the confusion.
it: Per impostazione, i pacchetti RPM dei documenti di <application>Publican</application> per il desktop, appaiono negli ambienti GNOME, sotto il menu <menuchoice><guimenu>Sistema</guimenu><guisubmenu>Documentazione</guisubmenu></menuchoice>. All'aumentare del numero di documenti installati, questo menu diventa intricato e di difficile navigazione. Ciò porta ad un menu con molti documenti per differenti prodotti ed in alcuni casi, in diverse lingue, che crea non poca confusione.

en: To group documentation for your product under a separate submenu within the GNOME <menuchoice><guimenu>System</guimenu><guisubmenu>Documentation</guisubmenu></menuchoice> menu, you must:
it: Per raggruppare i documenti per un prodotto, in un sotto-menu separato, nel menu  <menuchoice><guimenu>Sistema</guimenu><guisubmenu>Documentazione</guisubmenu></menuchoice> di GNOME, occorre:

en: create and distribute a desktop menu package that creates the new submenu.
it: creare e distribuire un pacchetto desktop-menu (per il menu del desktop), che crea il sotto-menu.

en: specify the menu <firstterm>category</firstterm> in the document, and optionally, have the documentation package <firstterm>require</firstterm> the desktop menu package.
it: specificare nel documento, la <firstterm>category</firstterm> del menu, ed opzionalmente, nel pacchetto di documentazione, specificare una direttiva <firstterm>require</firstterm> per richiedere anche l'installazione del pacchetto desktop-menu.

en: Note that the <guimenu>Documentation</guimenu> menu does not group entries under a submenu until two or more documents are installed that belong on that submenu. The first document appears under <menuchoice><guimenu>System</guimenu><guisubmenu>Documentation</guisubmenu></menuchoice>.
it: Notare che il menu <guimenu>Documentazione</guimenu> non raggruppa le voci in sotto-menu finché non sono presenti due o più documenti appartenenti al sotto-menu. Il primo documento compare sotto <menuchoice><guimenu>Sistema</guimenu><guisubmenu>Documentazione</guisubmenu></menuchoice>.

en: Creating an desktop menu package
it: Creare un pacchetto desktop-menu

en: A desktop menu package consists of:
it: Un pacchetto desktop-menu consiste di:

en: a <firstterm>desktop entry</firstterm> (<filename>.directory</filename>) file that provides metadata about the new submenu.
it: un file <firstterm>desktop entry</firstterm> (<filename>.directory</filename>) che fornisce i metadati sul nuovo sotto-menu.

en: a <firstterm>desktop menu</firstterm> (<filename>.menu</filename>) file that defines the position of the new submenu within the <guimenu>Documentation</guimenu> menu.
it: un file <firstterm>desktop menu</firstterm> (<filename>.menu</filename>) che definisce la posizione del sotto-menu nel menu <guimenu>Documentazione</guimenu>.

en: The structure for the <filename>.directory</filename> file for <application>Publican</application>-generated documentation is as follows:
it: La struttura del file <filename>.directory</filename>, per documentazione generata da <application>Publican</application>, è la seguente:

en: the <firstterm>group header</firstterm> <literal>[Desktop Entry]</literal>
it: il <firstterm>group header</firstterm> <literal>[Desktop Entry]</literal>

en: the <parameter>Name</parameter> parameter, set to the name of the submenu that you want to place under the <guimenu>Documentation</guimenu> menu.
it: il parametro <parameter>Name</parameter>, impostato con il nome del sotto-menu da posizionare nel menu <guimenu>Documentazione</guimenu>.

en: optionally, localizations of the <parameter>Name</parameter> parameter, in the format <parameter>Name[<replaceable>language_code</replaceable>]</parameter> where <replaceable>language_code</replaceable> is a language code in glibc format, <emphasis>not</emphasis> the XML format that <application>Publican</application> uses for language codes.
it: opzionalmente, le localizzazioni per il parametro <parameter>Name</parameter>, nel formato <parameter>Name[<replaceable>codice_lingua</replaceable>]</parameter>, dove <replaceable>codice_lingua</replaceable> è un codice linguistico in formato glibc, <emphasis>non</emphasis> nel formato XML usato da <application>Publican</application>.

en: the <parameter>Comment</parameter> parameter, set to a description of the new submenu.
it: il parametro <parameter>Comment</parameter>, impostato con una descrizione del sotto-menu.

en: optionally, localizations of the <parameter>Comment</parameter> parameter, in the format <parameter>Comment[<replaceable>language_code</replaceable>]</parameter> where <replaceable>language_code</replaceable> is a language code in glibc format, <emphasis>not</emphasis> the XML format that <application>Publican</application> uses for language codes.
it: opzionalmente, le localizzazioni per il parametro <parameter>Comment</parameter>, nel formato <parameter>Comment[<replaceable>codice_lingua</replaceable>]</parameter>, dove <replaceable>codice_lingua</replaceable> è un codice linguistico in formato glibc, <emphasis>non</emphasis> nel formato XML usato da <application>Publican</application>.

en: the <parameter>Type</parameter> parameter, set to <literal>Directory</literal>.
it: il parametro <parameter>Type</parameter>, imposto a <literal>Directory</literal>.

en: the <parameter>Encoding</parameter> parameter, set to <literal>UTF-8</literal>.
it: il parametro <parameter>Encoding</parameter>, impostato a <literal>UTF-8</literal>.

en: Example .directory file
it: Esempio di file .directory

en: The following file, <filename>menu-example.directory</filename> illustrates the structure of a desktop entry file.
it: Il seguente file, <filename>menu-example.directory</filename> mostra la struttura di un file di desktop entry:

en: The desktop entry file is placed in <filename>/usr/share/desktop-directories/</filename>
it: Il file di desktop entry, è salvato in <filename>/usr/share/desktop-directories/</filename>

en: A desktop menu file is an XML file that contains:
it: Un file di desktop menu, è un file XML che contiene:

en: a document type declaration for the freedesktop.org Desktop Menu Specification:
it: un DTD (Document Type Declaration), per la Desktop Menu Specification di freedesktop.org:

en: a <firstterm>root element</firstterm>, <tag>&lt;Menu&gt;</tag>, that contains:
it: un <firstterm>elemento radice</firstterm>, <sgmltag>&lt;Menu&gt;</sgmltag>, contenente:

en: a <tag>&lt;Name&gt;</tag> element with the content <literal>Documentation</literal>
it: un elemento <sgmltag>&lt;Name&gt;</sgmltag> contenente <literal>Documentation</literal>

en: another <tag>&lt;Menu&gt;</tag> element that in turn contains:
it: un altro elemento <sgmltag>&lt;Menu&gt;</sgmltag> che a sua volta, contiene:

en: a <tag>&lt;Name&gt;</tag> element with the content <literal>Documentation</literal> (just like the root element)
it: un elemento <sgmltag>&lt;Name&gt;</sgmltag> contenente <literal>Documentation</literal> (come l'elemento radice)

en: a <tag>&lt;Directory&gt;</tag> element with its content the name of the desktop entry file you created, for example:
it: un elemento <sgmltag>&lt;Directory&gt;</sgmltag> contenente il nome del file di desktop entry creato, per esempio:

en: an <tag>&lt;Includes&gt;</tag> element with the content <literal>X-<replaceable>category_name</replaceable></literal>, where <replaceable>category_name</replaceable> is an identifier for the documents that will be grouped together under this menu entry. For example:
it: un elemento <sgmltag>&lt;Includes&gt;</sgmltag> contenente <literal>X-<replaceable>nome_categoria</replaceable></literal>, dove <replaceable>nome_categoria</replaceable> è un identificatore per i documenti da raggruppare  nel sotto-menu. Per esempio:

en: Example .menu file
it: Esempio di file .menu

en: The following file, <filename>menu-example.menu</filename> illustrates the structure of a desktop menu file.
it: Il seguente file, <filename>menu-example.menu</filename> mostra la struttura di un file di desktop menu.

en: The desktop menu file is placed in <filename>/etc/xdg/menus/settings-merged/</filename>
it: Il file di desktop menu è salvato in <filename>/etc/xdg/menus/settings-merged/</filename>

en: Setting a desktop menu category
it: Impostare un categoria di desktop menu

en: To place a document in a submenu of <menuchoice><guimenu>System</guimenu><guisubmenu>Documentation</guisubmenu></menuchoice>, set the <parameter>menu_category</parameter> parameter in its <filename>publican.cfg</filename> file to match the content of the <tag>&lt;Includes&gt;</tag> element in the corresponding desktop menu file. For example, consider a desktop menu file that contains the element:
it: Per posizionare un documento in un sotto-menu di <menuchoice><guimenu>Sistema</guimenu><guisubmenu>Documentazione</guisubmenu></menuchoice>, impostare il parametro <parameter>menu_category</parameter> nel proprio file <filename>publican.cfg</filename>, in modo da corrispondere al contenuto dell'elemento <sgmltag>&lt;Includes&gt;</sgmltag> nel relativo file di desktop menu. Per esempio, si consideri il file di desktop menu, contenente l'elemento:

en: To place a document in the submenu defined by this desktop menu file, the document's <filename>publican.cfg</filename> file should contain:
it: Per posizionare un documento nel sotto-menu definito da questo file di desktop menu, il file <filename>publican.cfg</filename> del documento, dovrebbe contenere:

en: menu_category: X-Example-Docs-__LANG__
it: menu_category: X-Example-Docs

en: Note that you can include this parameter in the <filename>defaults.cfg</filename> file or <filename>overrides.cfg</filename> file of a brand so that all documents built with that brand are grouped into this submenu automatically without you having to set the <parameter>menu_category</parameter> parameter in each document.
it: Notare che si può includere questo parametro nel file <filename>defaults.cfg</filename> o nel file <filename>overrides.cfg</filename> di un brand, cosicché tutti i documenti creati con il brand siano automaticamente raggruppati nel sotto-menu, senza dover impostare il parametro <parameter>menu_category</parameter> in ogni documento.

en: If you ship the desktop menu and desktop entry files in an RPM package, you can make RPM packages of documentation <firstterm>require</firstterm> the desktop menu package. With this dependency set, the desktop menu package is installed automatically on users' systems when they install a documentation package, which ensures that the documentation appears under the submenu you have created for your project. Set the dependency with the <parameter>dt_requires</parameter> parameter in the document's <filename>publican.cfg</filename> file. For example, if you ship a desktop menu package named <package>foodocs-menu</package>, set:
it: Se si distribuiscono i file di desktop menu e di desktop entry in un pacchetto RPM, si può impostare che i pacchetti RPM di documenti <firstterm>richiedano</firstterm> il pacchetto di desktop-menu. Impostando questa dipendenza, il pacchetto di desktop-menu è installato automaticamente sul sistema degli utenti, durante l'installazione del pacchetto di documentazione, in modo da apparire nel sotto-menu creato per il progetto. Impostare la dipendenza con il parametro <parameter>dt_requires</parameter>, nel file <filename>publican.cfg</filename> del documento. Per esempio, se si distribuisce un pacchetto di desktop-menu di nome <package>foodocs-menu</package>, impostare:

en: Note that you can include this parameter in the <filename>defaults.cfg</filename> file or <filename>overrides.cfg</filename> file of a brand so that all documents built with that brand require the same desktop menu package.
it: Notare che si può includere il parametro nel file <filename>defaults.cfg</filename> o nel file <filename>overrides.cfg</filename> di un brand, cosicché tutti i documenti creati con il brand richiedano lo stesso pacchetto di desktop-menu.
