calibre - en to it translation catalogue (33 entries)

en: Snippets
it: Frammenti

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
it: L'editor di e-book di calibre supporta l'utilizzo dei "frammenti". Un frammento è un segmento di testo che è riutilizzato spesso o contiene parecchio testo ridondante. L'editor ti permette di inserire frammenti premendo solamente alcuni tasti. Per esempio, supponi di dover inserire molte volte dei tag link quando modifichi file HTML, puoi semplicemente scrivere ``<a`` nell'editor e premere |ct|. L'editor espanderà il testo in::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
it: Non solo, la parola ``filename`` sarà selezionata e il cursore posizionato su di essa, in modo che tu possa facilmente digitare il nome effettivo del file usando l'ingegnosa funzionalità di :ref:`editor_auto_complete`. E una volta che hai finito di digitare il nome del file, premi di nuovo |ct| e il cursore salterà alla posizione tra i tag ``<a>``, in modo che tu possa facilmente inserire il testo per il link.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
it: Il sistema dei frammenti dell'editor è molto sofisticato; ci sono alcuni frammenti predefiniti e puoi crearne di nuovi che si adattino al tuo stile di modifica.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
it: La seguente discussione sui frammenti predefiniti dovrebbe aiutare a illustrare le potenzialità del sistema dei frammenti.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
it: Puoi anche usare i frammenti nelle caselle di testo del pannello :guilabel:`Cerca e sostituisci`, tuttavia i placeholder (l'uso di |ct| per i salti di cursore) non funzioneranno.

en: The built-in snippets
it: I frammenti predefiniti

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
it: I frammenti predefiniti sono descritti di seguito. Tieni presente che puoi sovrascriverli creando i tuoi frammenti con lo stesso testo di attivazione.

en: Inserting filler text [Lorem]
it: Inserimento di un testo riempitivo [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
it: Il primo e più semplice frammento predefinito è utilizzato per inserire un testo riempitivo all'interno di un documento. Il testo riempitivo è preso da `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ un trattato filosofico di Cicerone (tradotto in inglese). Per utilizzarlo digita semplicemente "Lorem" in un file HTML e premi |ct|. Il frammento sarà automaticamente sostituito da due paragrafi di riempitivo.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
it: La definizione di questo frammento è molto semplice, il testo di attivazione è definito come "Lorem" e lo schema è definito semplicemente come il testo che deve essere inserito. Puoi facilmente personalizzarlo perché usi il testo riempitivo che preferisci.

en: Inserting a self-closing HTML tag [<>]
it: Inserimento di un tag HTML autochiudente [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
it: Ora diamo un'occhiata a un semplice esempio del potente concetto dei *placeholder*. Supponiamo di voler inserire il tag autochiudente ``<hr/>``: basta digitare ``<>`` e premere |ct|, l'editor espanderà il frammento in::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
it: Qui il simbolo ``|`` rappresenta la posizione corrente del cursore. Basta digitare ``hr`` e premere |ct| per muovere il cursore dopo la chiusura del tag. Questo frammento è definito come::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
it: I placeholder sono semplicemente il simbolo del dollaro ($) seguito da un numero. Quando il frammento viene espanso premendo |ct| il cursore è posizionato sul primo placeholder (cioè il placeholder con il numero più basso). Quando |ct| viene premuto nuovamente, il cursore salta al placeholder successivo (cioè il placeholder con il numero successivo più alto).

en: Inserting an HTML link tag [<a]
it: Inserimento di un tag HTML link [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
it: Tutti i tag HTML link condividono la stessa struttura. Hanno un attributo ``href`` e del testo tra i tag di apertura e di chiusura. Un frammento per inserirli in modo più efficiente ci introdurrà a nuove funzionalità dei placeholder. Per usare questo frammento digita semplicemente "<a" e premi |ct|. L'editor lo espanderà a::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
it: Non solo, la parola ``filename`` sarà selezionata e il cursore posizionato su di essa, in modo che tu possa facilmente digitare il nome effettivo del file usando l'ingegnosa funzionalità di :ref:`editor_auto_complete`. E una volta che hai finito di digitare il nome del file, premi di nuovo |ct| e il cursore salterà alla posizione tra i tag ``<a>``, in modo che tu possa facilmente inserire il testo per il link. Dopo aver finito di inserire il testo, premi |ct| ancora una volta per muovere il cursore dopo il tag di chiusura. Questo frammento è definito come::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
it: Ci sono un paio di novità qui. Per prima cosa il placeholder ``$1`` è diventato più complesso: include ora del *testo predefinito* (la parola ``filename``). Se un placeholder contiene del testo predefinito, il testo predefinito è sostituito per il placeholder quando il frammento viene espanso. Per di più quando salti ad un placeholder con del testo predefinito usando |ct|, il testo predefinito viene selezionato. In questo modo puoi usare il testo predefinito come promemoria per ricordarti di riempire parti importanti dello schema. Puoi specificare il testo predefinito per un placeholder usando la sintassi: ``${:testo predefinito}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
it: L'altra nuova caratteristica è che il secondo placeholder ha un asterisco a seguire (``${2*}``). Questo vuol dire che il testo (eventualmente) selezionato prima dell'espansione dello schema è sostituito per il placeholder. Per vedere questa caratteristica in azione, seleziona del testo nell'editor, premi |ct|, digita ``<a`` e premi nuovamente |ct|, lo schema sarà espanso a::

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
it: Questo è molto simile all'inserimento di un link HTML, come abbiamo appena visto. Ti permette di inserire rapidamente un tag ``<img src="filename" alt="description" />`` e di saltare tra gli attributi ``src`` e ``alt``::

en: Insert an arbitrary HTML tag [<<]
it: Inserimento di un tag HTML arbitrario [<<]

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
it: Digita il nome del tag, per esempio ``span`` e premi |ct|, questo porterà a::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
it: Come puoi vedere, il primo placeholder ($1) è stato specificato due volte, la seconda nel tag di chiusura, che semplicemente copierà qualunque testo tu scriva nel tag di apertura.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
it: Inserimento di un tag HTML arbitrario con un attributo di classe [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
it: Questo è molto simile all'inserimento di tag arbitrari visto sopra, eccetto per il fatto che si assume che tu voglia specificare una classe per il tag::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
it: Questo ti permetterà di inserire prima il nome del tag, |ct|, inserire il nome della classe, premere |ct|, inserire i contenuti del tag e premere |ct| un'ultima volta per saltare al di fuori del tag. Il tag di chiusura sarà riempito automaticamente.

en: Creating your own snippets
it: Creazione di frammenti personalizzati

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
it: I frammenti sono così interessanti perché puoi crearne di tuoi per adattarli al tuo stile di modifica. Per creare frammenti personalizzati entra nell'editor e vai in :guilabel:`Modifica->Preferenze->Impostazioni dell'editor->Gestisci i frammenti`. Apparirà una finestra che ti aiuterà a creare facilmente i tuoi frammenti personalizzati. Basta fare clic sul pulsante :guilabel:`Aggiungi frammento` per aprire una finestra come questa:

en: The create your own snippets tool
it: Lo strumento di creazione dei frammenti personalizzati

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
it: Per prima cosa dai un nome al tuo frammento, qualcosa di descrittivo che aiuti a identificare il frammento in futuro. Dopodiché specifica il testo di attivazione: è semplicemente il testo che devi digitare nell'editor prima di premere |ct| per far espandere il frammento.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
it: Ora specifica lo schema per il frammento. Dovresti cominciare con uno degli esempi visti finora e modificarlo secondo le tue necessità. Infine specifica per quali tipi di file vuoi che il frammento sia attivo. In questo modo potrai avere frammenti diversi con lo stesso testo di attivazione che diano risultati differenti a seconda del tipo di file.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
it: Il passo successivo è quello di provare i tuoi nuovi frammenti. Usa la casella :guilabel:`Prova` in fondo alla finestra. Digita il testo di attivazione e premi |ct| per far espandere il frammento e saltare tra i placeholder.
