0 - en to it-IT translation catalogue (16 entries)

note: Tag: title
en: Conditional tagging
it-IT: Tagging condizionale

note: Tag: para
en: In some cases you may need to maintain multiple versions of a book; for example, a HOWTO guide for product FOO can have an upstream version and an enterprise version, with very subtle differences between them.
it-IT: In alcuni casi occorre mantenere multiple versioni di un libro; per esempio, un HOWTO per il prodotto FOO può avere una versione upstream ed una versione enterprise, con piccole differenze tra loro.

note: Tag: para
en: <application>Publican</application> makes it easy to manage differences between multiple versions of a book by allowing you to use a single source for all versions. <firstterm>Conditional tagging</firstterm> allows you to make sure that version-specific content only appears in the correct version; that is, you <firstterm>conditionalize</firstterm> the content.
it-IT: <application>Publican</application> semplifica la gestione delle differenze tra versioni multiple di un libro, permettendo di usare una sorgente unica per tutte le versioni. Il <firstterm>tagging condizionale</firstterm> garantisce che il contenuto di una versione specifica, compaia soltanto nella versione stabilita; ossia, permette di <firstterm>condizionare</firstterm> il contenuto.

note: Tag: para
en: To conditionalize content in a book, use the tag attribute <command>condition</command>. For example, let's say the book <citetitle>How To Use Product Foo</citetitle> has an "upstream", "enterprise", and "beta" version:
it-IT: Per condizionare il contenuto di un libro, usare il tag <command>condition</command>. Per esempio, si supponga che il libro <citetitle>How To Use Product Foo</citetitle> abbia una versione "upstream", una versione "enterprise" e una versione "beta".

note: Tag: para
en: To build a specific version (and thereby capture all content conditionalized for that version), add the <command>condition: <replaceable>version</replaceable></command> parameter to the <filename>publican.cfg</filename> file and run the <command>publican build</command> command as normal. For example, if you add <literal>condition: upstream</literal> to the <filename>publican.cfg</filename> file of <citetitle>How To Use Product Foo</citetitle> and run:
it-IT: Per compilare una versione specifica (e quindi catturare solo il conenuto relativo a questa versione), aggiungere il parametro <command>condition: <replaceable>versione</replaceable></command> al file <filename>publican.cfg</filename> ed eseguire il comando <command>publican build</command>, ormai noto. Per esempio, aggiungendo <command>condition: upstream</command> al file <filename>publican.cfg</filename> dell'HOWTO <citetitle>How To Use Product Foo</citetitle>, e poi eseguendo:

note: Tag: para
en: <application>Publican</application> filters out all tags with condition attributes other than <literal>condition="upstream"</literal> and builds <citetitle>How To Use Product Foo</citetitle> in as a PDF file in American English.
it-IT: <application>Publican</application> filtra i contenuti con i tag condizionali, escluso il tag con l'attributo <command>condition="upstream"</command> e compila l'<citetitle>How To Use Product Foo</citetitle> in un file PDF in lingua inglese statunitense.

note: Tag: title
en: Conditional tagging and translation
it-IT: Tagging condizionale e traduzione

note: Tag: title
en: Use conditional tagging with great caution
it-IT: Usare con cautela il tagging condizionale

note: Tag: para
en: Use conditional tagging only with great caution in books that you expect to be translated, as conditional tagging creates extra difficulties for translators.
it-IT: Usare il tagging condizionale con una certa cautela soprattutto nei libri che si presuma vengano tradotti, poichè ciò crea ulteriori difficoltà ai traduttori.

note: Tag: para
en: Conditional tagging creates difficulty for translators in two ways: it obscures context in the <firstterm>portable object</firstterm> (PO) files through which translators work, and it makes proofreading more difficult for translators who are not deeply familiar with your book and all the conditions that you have set.
it-IT: Il tagging condizionale crea difficoltà ai traduttori in due modi: oscura il contesto nei file <firstterm>PO</firstterm> (Portable Object) e rende più ardua la rilettura/correzione del documento, a quei traduttori non molto familiari con i tag condizionali.

note: Tag: para
en: The PO files for the document contain the full set of tags from the XML files, regardless of any conditions set. When translators open the PO file for the example from <citetitle>How To Use Product Foo</citetitle> in <xref linkend="sect-Users_Guide-Conditional_tagging" />, they see:
it-IT: I file PO includono tutti i tag presenti in XML, a prescindere dalle condizioni. Per esempio, se un traduttore apre il file PO, relativo all'<citetitle>How To Use Product Foo</citetitle> della <xref linkend="sect-Users_Guide-Conditional_tagging" />, egli vede:

note: Tag: para
en: Because PO files include do not include attributes from tags, there is nothing obvious here to show translators that these paragraphs are alternatives to each other and that the writer does not intend that meaning should flow from one paragraph to the next.
it-IT: Poichè i file PO non includono gli attributi dei tag, non è per nulla ovvio indicare ai traduttori che questi paragrafi sono tra loro alternativi e che il redattore non intende realizzare un flusso continuo da un paragrafo al successivo.

note: Tag: para
en: In this example, the only paragraphs where the meaning flows logically from one to the next is between paragraphs three and four. Because both of these paragraphs appear in the book for the beta version of the product, they (hopefully) make sense together. Beyond that, the use of conditionals here requires translators to translate individual small chunks of content without the ability to follow the context from one paragraph to the next. When translators must work under these conditions, the quality of the translation will suffer, or the time required — and therefore the cost of translation — will increase.
it-IT: In questo esempio, i soli paragrafi in cui il senso scorre logicamente da un paragrafo al successivo è tra il terzo e il quarto. Poichè entrambi i paragrafi sono presenti nella versione beta del libro, essi (si spera), sono i soli ad avere senso. Quindi, l'uso dei tag condizionali costringe i traduttori a lavorare su brevi pezzi di brani, senza possibilità di seguire il contesto globale del discorso, da un paragrafo al successivo. In queste condizioni, ne risente la qualità della traduzione, aumentando di conseguenza il tempo richiesto — ed anche il costo della traduzione.

note: Tag: para
en: Furthermore, unless the translators who work on your book know how to configure <application>Publican</application>'s <filename>publican.cfg</filename> file and are aware of the valid conditions for your book, they cannot proofread their work. Without that knowledge, when translators proofread a document, they will wonder why they cannot find text that they know they translated and can find easily in the PO file. If you must use conditionals in your book, you must be prepared to provide a greater degree of support to your translators than you would otherwise provide.
it-IT: Inoltre, a meno che i traduttori non sappiano come configurare il file <filename>publican.cfg</filename> di <application>Publican</application> e non siano a conoscenza dei tag condizionali, essi non riuscirebbero a rivedere il documento finale tradotto. Se i traduttori non sono informati sull'uso di questi tag, quando procedono a rivedere un documento, rimarrebbero sorpresi nel non riuscire a trovare il testo che hanno tradotto e che facilmente trovano nei file PO. Quindi, se occorre usare i tag condizionali, ricordarsi di informare i propri traduttori del loro uso, fornendo loro il neccessario supporto.

note: Tag: para
en: As an alternative to conditionals, consider maintaining separate versions of your book in separate branches of a version-controlled repository. You can still share XML files and even PO files between the various branches as necessary, and some version control systems allow you to share changes readily among branches.
it-IT: In alternativa ai tag condizionali, si consideri di mantenere versioni separate di un libro, in branch separati di un repository con controllo di versione. In tal modo, è anche possibile condividere file XML e PO tra i vari branch; inoltre alcuni sistemi di controllo versione permettono di condividere correttamente le modifiche tra branch.

note: Tag: para
en: If you maintain two versions of a book in the same repository, we recommend using a separate config file for each version. For example, the <filename>upstream.cfg</filename> file might contain the condition <literal>condition: upstream</literal> and the <filename>enterprise.cfg</filename> file might contain the condition <literal>condition: enterprise</literal>. You could then specify the version of the document to build or package with the <option>--config</option>; for example, <command>publican package --lang en-US --config upstream.cfg</command>. Using two separate config files saves you from having to edit the one config file each time you build or package a document.
it-IT: Se si mantengono due versioni di un libro nello stesso repository, si raccomanda di usare un file di configurazione distinto per ciascuna versione. Per esempio, il file <filename>upstream.cfg</filename> potrebbe contenere la condizione <literal>condition: upstream</literal> e il file <filename>enterprise.cfg</filename> la condizione <literal>condition: enterprise</literal>. Si potrebbe allora specificare di compilare una versione del documento, con l'opzione <option>--config</option>; per esempio, <command>publican package --lang en-US --config upstream.cfg</command>. Usare due file di configurazione separati, evita di dover editare ognivolta il file di configurazione, per la compilazione di un libro o pacchetto.
