0 - en to it translation catalogue (27 entries)

en: Creating a document
it: Creare un documento

en: This chapter describes creating books and articles: the main configuration files, example document files, and how to build a document.
it: Questo capitolo descrive come creare libri ed articoli: i file di configurazione principali, i file in un documento d'esempio, e come compilare un documento.

en: Use the <prompt>$</prompt> <command>publican create</command> command to create a new document, including all the necessary files for the document.
it: Usare il comando <command>publican create</command> per creare un nuovo documento corredato di tutti i file necessari.

en: The <prompt>$</prompt> <command>publican create</command> command accepts several options, detailed in this chapter. When an option can accept a value, separate the option from the value with a space or an equals sign; for example, <command>publican create --name New_Book</command> or <command>publican create --name=New_Book</command>.
it: Il comando <command>publican create</command> accetta diverse opzioni, come indicato in questo capitolo. Quando una opzione accetta un valore, separare il valore con uno spazio o con il segno di uguale; per esempio, <command>publican create --name New_Book</command> o <command>publican create --name=New_Book</command>.

en: print a list of all <prompt>$</prompt> <command>publican create</command> command options.
it: visualizza l'elenco di tutte le opzioni del comando <command>publican create</command>.

en: <option>--name<replaceable> Doc_Name</replaceable></option>
it: <option>--name<replaceable> Nome_Doc</replaceable></option>

en: set <replaceable>Doc_Name</replaceable> as the name of the book or article. This variable must not contain any spaces. For example, the command <prompt>$</prompt> <command>create_book --name Test_Book</command> creates a book named <literal>Test_Book</literal> with all the necessary files to build the book, and sets the <parameter>BOOKID</parameter> in the <filename>Test_Book.ent</filename> file.
it: assegna <replaceable>Nome_Doc</replaceable> al nome del libro o articolo. Questa variabile non deve contenere spazi. Per esempio, il comando <command>create_book --name Test_Book</command> crea un libro di nome <literal>Test_Book</literal> con tutti i file necessari per creare il libro, ed imposta il parametro <parameter>BOOKID</parameter> nel file <filename>Test_Book.ent</filename>.

en: <option>--lang<replaceable> Language_Code</replaceable></option>
it: <option>--lang<replaceable> Codice_Lingua</replaceable></option>

en: set <replaceable>Language_Code</replaceable> as the language code of the language in which the book or article will be authored. If you do not specify a language code, <application>Publican</application> defaults to <literal>en-US</literal> (American English). The <option>--lang</option> option sets the <parameter>xml_lang</parameter> in the <filename>publican.cfg</filename> file and creates a directory with this name in the document directory. When initially created, this directory contains some boilerplate XML files. Refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> for more information on <filename>publican.cfg</filename> parameters and <xref linkend="appe-Publican-Users_Guide-Language_codes" /> for more detail on language codes.
it: imposta la lingua, con il <replaceable>Codice_Lingua</replaceable>, in cui il libro o articolo verrà redatto. Se non si specifica un codice linguistico, <application>Publican</application> per impostazione usa <literal>en-US</literal> (inglese americano). L'opzione <option>--lang</option> imposta il parametro <parameter>xml_lang</parameter> nel file di configurazione <filename>publican.cfg</filename>. Fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> per maggiori informazioni sui parametri di <filename>publican.cfg</filename> ed all'<xref linkend="appe-Publican-Users_Guide-Language_codes" /> per i dettagli sui codici linguistici.

en: <option>--version<replaceable> version</replaceable></option>
it: <option>--version<replaceable> versione</replaceable></option>

en: set <replaceable>version</replaceable> as the version number of the product that the book describes. For example, for Red Hat Enterprise Linux 5.1 you would use <literal>5.1</literal>. The default version is <literal>0.1</literal>. The <option>--version</option> option sets the <tag>&lt;productnumber&gt;</tag> tag in the <filename>Book_Info.xml</filename> or <filename>Article_Info.xml</filename> file. For more information refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-Book_Info.xml" />.
it: imposta il numero di <replaceable>versione</replaceable> del prodotto descritto dal libro. Per esempio, per Red Hat Enterprise Linux 5.1 si userà <literal>5.1</literal>. Il valore predefinito è <literal>0.1</literal>. L'opzione <option>--version</option> imposta il tag <sgmltag>&lt;productnumber&gt;</sgmltag> nel file <filename>Book_Info.xml</filename> o nel file <filename>Article_Info.xml</filename>. Per maggiori informazioni vedere la <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-Book_Info.xml" />.

en: <option>--edition<replaceable> edition</replaceable></option>
it: <option>--edition<replaceable> edizione</replaceable></option>

en: set <replaceable>edition</replaceable> as the edition number of the book. This number indicates to users when a new edition of the book is released. The initial <firstterm>general availability</firstterm> (GA) release of the book should be edition <literal>1.0</literal>. The default value is <literal>0</literal>. The <option>--edition</option> option sets the <tag>&lt;edition&gt;</tag> tag in the <filename>Book_Info.xml</filename> or <filename>Article_Info.xml</filename> file. For more information refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-Book_Info.xml" />.
it: assegna il numero di <replaceable>edizione</replaceable> del libro. Questo numero serve ad indicare il rilascio di una nuova edizione di un libro. Il primo rilascio pubblico (<firstterm>general availability</firstterm> o GA) di un libro, dovrebbe avere l'edizione <literal>1.0</literal>. Il valore predefinito è <literal>0</literal>. L'opzione <option>--edition</option> imposta il tag <sgmltag>&lt;edition&gt;</sgmltag> nel file <filename>Book_Info.xml</filename> o nel file <filename>Article_Info.xml</filename>. Per maggiori informazioni fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-Book_Info.xml" />.

en: <option>--product<replaceable> Product_Name</replaceable></option>
it: <option>--product<replaceable> Nome_Prodotto</replaceable></option>

en: set <replaceable>Product_Name</replaceable> as the name of the product that the book describes. This variable must not contain any spaces. For example, set this to <literal>Fedora</literal> for core Fedora documentation, and the name of the product for other products, for example, <literal>Fedora_Directory_Server</literal>. The default value is <literal>Documentation</literal>. The <option>--product</option> option sets the <tag>&lt;product name&gt;</tag> tag in the <filename>Book_Info.xml</filename> file or <filename>Article_Info.xml</filename> file and the <parameter>PRODUCT</parameter> entity in the <filename><replaceable>Doc_Name</replaceable>.ent</filename> file.
it: assegna <replaceable>Nome_Prodotto</replaceable> al nome del prodotto descritto dal libro. Questa variabile non deve contenere spazi. Per esempio, usare il valore <literal>Fedora</literal> per la documentazione Fedora di base, ed il nome del prodotto per gli altri documenti, per esempio <literal>Fedora_Directory_Server</literal>. Il valore pedefinito è <literal>Documentation</literal>. L'opzione <option>--product</option> imposta il tag <sgmltag>&lt;productname&gt;</sgmltag> nel file <filename>Book_Info.xml</filename> o <filename>Article_Info.xml</filename> e il parametro <parameter>PRODUCT</parameter> nel file <filename><replaceable>Doc_Name</replaceable>.ent</filename>.

en: <option>--type Article --name<replaceable> Article_Name</replaceable></option>
it: <option>--type Article --name<replaceable> Nome_Articolo</replaceable></option>

en: create an article instead of a book. Replace <replaceable>Article_Name</replaceable> with the article name. This variable must not contain any spaces. The <option>--type</option> option sets the <parameter>type</parameter> in the <filename>publican.cfg</filename> file. Refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> for more information on <filename>publican.cfg</filename> parameters.
it: crea un articolo invece di un libro, assegnando <replaceable> Nome_Articolo</replaceable> al nome dell'articolo. Questa variabile non deve contenere spazi. L'opzione <option>--type</option> imposta il parametro <parameter>type</parameter> nel file di configurazione <filename>publican.cfg</filename>. Fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> per maggiori informazioni sui parametri del file <filename>publican.cfg</filename>.

en: <option>--type Set --name<replaceable> Set_Name</replaceable></option>
it: <option>--type Set --name<replaceable> Nome_Set</replaceable></option>

en: create a set of documents instead of a book. Replace <replaceable>Set_Name</replaceable> with the set name. This variable must not contain any spaces. The <option>--type</option> option sets the <parameter>type</parameter> in the <filename>publican.cfg</filename> file. Refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> for more information on <filename>publican.cfg</filename> parameters and to <xref linkend="chap-Publican-Users_Guide-Using_sets" /> for details on using sets.
it: crea un set di documenti invece di un libro, assegnando <replaceable> Nome_Set</replaceable> al nome del set. Questa variabile non deve contenere spazi. L'opzione <option>--type</option> imposta il parametro <parameter>type</parameter> nel file di configurazione <filename>publican.cfg</filename>. Fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> per maggiori informazioni sui parametri del file <filename>publican.cfg</filename> ed al <xref linkend="chap-Publican-Users_Guide-Using_sets" /> per i dettagli sull'uso dei set.

en: set <replaceable>brand</replaceable> as the <firstterm>brand</firstterm> to use to style the output of this document, for example, <literal>RedHat</literal>, <literal>fedora</literal>, <literal>JBoss</literal>, <literal>oVirt</literal>, or <literal>GIMP</literal>. The default value is <literal>common</literal>, a default brand shipped with <application>Publican</application>. The <option>--brand</option> option sets the <parameter>brand</parameter> parameter in the <filename>publican.cfg</filename> file. Refer to <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> for more information on <filename>publican.cfg</filename> parameters. This option requires the appropriate <application>Publican</application> brand package to be installed. For example, to build Red Hat branded books, you must install the <package>publican-redhat</package> package. Refer to <xref linkend="sect-Publican-Users_Guide-Installing_a_brand" /> for instructions on installing brand packages for <application>Publican</application>. If you do not specify a brand, <application>Publican</application> uses its built-in, default brand. Refer to <xref linkend="chap-Publican-Users_Guide-Branding" /> for more information.
it: assegna lo stile di presentazione o <replaceable>brand</replaceable>, per esempio <literal>RedHat</literal>, <literal>fedora</literal>, <literal>JBoss</literal>, <literal>oVirt</literal> o <literal>GIMP</literal> del documento. Il valore predefinito è <literal>common</literal>, il brand integrato in <application>Publican</application>. L'opzione <option>--brand</option> imposta il parametro <parameter>brand</parameter> nel file di configurazione <filename>publican.cfg</filename>. Fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Files_in_the_book_directory-The_publican.cfg_file" /> per maggiori informazioni sui parametri del file <filename>publican.cfg</filename>. Questa opzione richiede che sia installato l'appropriato pacchetto di brand di <application>Publican</application>. Per esempio, per compilare libri con <emphasis>brand</emphasis> Red Hat, occorre installare il pacchetto <package>publican-redhat</package>. Fare riferimento alla <xref linkend="sect-Publican-Users_Guide-Installing_a_brand" /> per istruzioni su come installare pacchetti di brand per l'uso in <application>Publican</application>. Vedere il <xref linkend="chap-Publican-Users_Guide-Branding" /> per maggiori informazioni.

en: Before running the <prompt>$</prompt> <command>publican create</command> command, use the <prompt>$</prompt> <command>cd</command> command to change into the directory where you want the book to be created. For example, to create a book named <literal>Test_Book</literal> in the <filename>my_books/</filename> directory, run the following commands:
it: Prima di eseguire il comando <command>publican create</command>, spostarsi (con il comando shell <command>cd</command>), nella directory in cui si vuole venga creato il libro. Per esempio, per creare un libro di nome <literal>Libro_di_Prova</literal> nella directory <filename>miei_libri/</filename>, eseguire i seguenti comandi:

en: <prompt>$</prompt> <command>cd my_books/</command> 
    <prompt>$</prompt> <command>publican create --name Test_Book</command>
it: <command>cd miei_libri/</command>
    <command>publican create --name Libro_di_Prova --lang=it-IT</command>

en: To see the results of this command on a computer with a Linux operating system, run the following:
it: Per visualizzare i risultati di questo comando su un computer con Sistema Operativo Linux, eseguire il comando:

en: The output should be similar to the following:
it: Il risultato dovrebbe assomigliare a:

en: <computeroutput>Test_Book/</computeroutput>
it: <computeroutput>Libro_di_Prova/</computeroutput>

en: To see the contents of the new <filename>Test_Book/</filename> directory on a computer with a Linux operating system, run the following:
it: Per visualizzare il contenuto della nuova cartella <filename>Libro_di_Prova/</filename> su un computer con Sistema Operativo Linux, eseguire i comandi:

en: <computeroutput>en-US/ publican.cfg</computeroutput>
it: <computeroutput>it-IT/ publican.cfg</computeroutput>
