calibre - en to sv translation catalogue (36 entries)

en: Snippets
sv: Kodavsnitt

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::
sv: calibres e-bokredigerare stöder *kodavsnitt*. Ett kodavsnitt är ett textstycke som återanvänds ofta eller innehåller mycket upprepad text. Redigeraren låter dig infoga ett kodavsnitt med bara några få tangenttryckningar. Anta exempelvis att du ofta infogar länktaggar när du redigerar HTML-filer. Då kan du skriva ``<a`` i redigeraren och trycka på |ct|. Redigeraren expanderar texten till::

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.
sv: Dessutom markeras ordet ``filename`` och markören placeras på det, så att du enkelt kan skriva in det verkliga filnamnet med hjälp av redigerarens praktiska :ref:`editor_auto_complete`-funktion. När du har skrivit filnamnet trycker du på |ct| igen. Markören flyttas då till platsen mellan ``<a>``-taggarna, där du enkelt kan skriva länktexten.

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.
sv: Kodavsnittssystemet i redigeraren är mycket avancerat. Det finns några inbyggda kodavsnitt, och du kan skapa egna som passar ditt sätt att arbeta.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
sv: Genomgången av de inbyggda kodavsnitten nedan visar hur kraftfullt systemet är.

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.
sv: Du kan också använda kodavsnitt i textfälten på panelen :guilabel:`Sök och ersätt`. Platshållare där du hoppar mellan positioner med |ct| fungerar dock inte där.

en: The built-in snippets
sv: Inbyggda kodavsnitt

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
sv: De inbyggda kodavsnitten beskrivs nedan. Observera att du kan åsidosätta dem genom att skapa dina egna kodavsnitt med samma utlösartext.

en: Inserting filler text [Lorem]
sv: Infoga fyllnadstext [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.
sv: Det första inbyggda kodavsnittet, som också är det enklaste, används för att infoga fyllnadstext i ett dokument. Fyllnadstexten hämtas från `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_, ett filosofiskt verk av Cicero som har översatts till engelska. För att använda kodavsnittet skriver du helt enkelt ``Lorem`` i en HTML-fil och trycker på |ct|. Texten ersätts då med ett par stycken fyllnadstext.

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.
sv: Definitionen av kodavsnittet är mycket enkel. Utlösartexten är ``Lorem`` och mallen består av den bokstavliga text som ska infogas. Du kan enkelt byta ut den mot den fyllnadstext du föredrar.

en: Inserting a self-closing HTML tag [<>]
sv: Infoga en självstängande HTML-tagg [<>]

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::
sv: Nu tittar vi på ett enkelt exempel på det kraftfulla begreppet *platshållare*. Anta att du vill infoga den självstängande taggen ``<hr/>``. Skriv ``<>`` och tryck på |ct|, så expanderar redigeraren kodavsnittet till::

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::
sv: Här anger symbolen ``|`` markörens aktuella position. Skriv ``hr`` och tryck på |ct| för att flytta markören till positionen efter taggen. Kodavsnittet definieras så här::

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).
sv: Platshållare består av ett dollartecken ($) följt av ett tal. När kodavsnittet expanderas med |ct| placeras markören vid den första platshållaren, alltså den med lägst nummer. Nästa gång du trycker på |ct| flyttas markören till platshållaren med närmast högre nummer.

en: Inserting an HTML link tag [<a]
sv: Infoga en HTML-länktagg [<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::
sv: Alla HTML-länktaggar har samma grundstruktur: ett ``href``-attribut och text mellan start- och sluttaggen. Ett kodavsnitt som effektiviserar inmatningen visar samtidigt fler funktioner hos platshållare. Skriv ``<a`` och tryck på |ct|, så expanderar redigeraren kodavsnittet till::

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::
sv: Dessutom markeras ordet ``filename`` och markören placeras på det, så att du enkelt kan skriva det verkliga filnamnet med redigerarens praktiska :ref:`editor_auto_complete`-funktion. När filnamnet är klart trycker du på |ct| igen. Markören flyttas då till positionen mellan ``<a>``-taggarna, där du skriver länktexten. Tryck på |ct| ännu en gång för att flytta markören till positionen efter sluttaggen. Kodavsnittet definieras så här::

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}``.
sv: Här finns ett par nya funktioner. Platshållaren ``$1`` har blivit mer avancerad och innehåller nu *standardtexten* ``filename``. När kodavsnittet expanderas ersätter standardtexten platshållaren. När du sedan hoppar till platshållaren med |ct| markeras standardtexten. Den kan därför fungera som en påminnelse om att fylla i viktiga delar av mallen. Standardtext anges med syntaxen ``${<number>:default text}``.

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::
sv: Den andra nyheten är asterisken efter den andra platshållaren (``${2*}``). Den innebär att text som var markerad innan mallen expanderades infogas i platshållaren. Prova genom att markera text i redigeraren, trycka på |ct|, skriva ``<a`` och trycka på |ct| igen. Mallen expanderas då till::

en: Inserting an HTML image tag [<i]
sv: Infoga en HTML-bildtagg [<i]

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::
sv: Detta fungerar ungefär som att infoga en HTML-länk, vilket vi såg ovan. Du kan snabbt infoga taggen ``<img src="filename" alt="description" />`` och hoppa mellan attributen ``src`` och ``alt``::

en: Insert an arbitrary HTML tag [<<]
sv: Infoga en godtycklig HTML-tagg [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. If you want to wrap selected text, first select the text, press |ct| then type ``<<`` and press |ct| again. The editor will expand it to::
sv: Med detta kodavsnitt kan du infoga en valfri fullständig HTML-tagg eller omsluta tidigare markerad text med taggen. Skriv ``<<`` och tryck på |ct|. Om du vill omsluta markerad text markerar du den först, trycker på |ct|, skriver ``<<`` och trycker på |ct| igen. Redigeraren expanderar kodavsnittet till::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
sv: Skriv taggnamnet, till exempel ``span``, och tryck på |ct|. Resultatet blir::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the same placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
sv: Du märker att sluttaggen automatiskt har fyllts i med ``span``. Det görs med en annan platshållarfunktion: *spegling*. Om samma platshållare anges flera gånger i en mall fylls den andra och alla senare förekomster automatiskt i med det du skrev vid den första positionen när du trycker på |ct|. Kodavsnittet definieras så här::

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.
sv: Som du ser har den första platshållaren ($1) angetts två gånger. Den andra förekomsten finns i sluttaggen och kopierar helt enkelt det du skriver i starttaggen.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
sv: Infoga en godtycklig HTML-tagg med ett klassattribut [<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::
sv: Detta är mycket likt infogningen av godtycklig tagg i exemplet ovan, förutom att det förutsätter att du vill ange en klass för taggen::

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.
sv: Du kan först skriva taggnamnet, trycka på |ct|, skriva klassnamnet, trycka på |ct|, skriva taggens innehåll och slutligen trycka på |ct| för att flytta markören utanför taggen. Sluttaggen fylls i automatiskt.

en: Creating your own snippets
sv: Skapa dina egna kodavsnitt

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:
sv: Kodavsnitt blir särskilt användbara eftersom du kan skapa egna som passar ditt arbetssätt. Gå till :guilabel:`Redigera->Inställningar->Redigerarinställningar->Hantera kodavsnitt` i redigeraren. Då öppnas en lättanvänd dialogruta. Klicka på :guilabel:`Lägg till kodavsnitt` för att visa följande dialogruta:

en: The create your own snippets tool
sv: Verktyget för att skapa egna kodavsnitt

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.
sv: Ge först kodavsnittet ett beskrivande namn så att du kan identifiera det senare. Ange sedan *utlösaren*, alltså den text som ska skrivas i redigeraren innan du trycker på |ct| för att expandera kodavsnittet.

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.
sv: Ange sedan kodavsnittets mall. Utgå gärna från något av exemplen ovan och anpassa det efter dina behov. Ange slutligen vilka filtyper kodavsnittet ska vara aktivt för. På så sätt kan flera kodavsnitt ha samma utlösartext men fungera olika i olika filtyper.

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.
sv: Nästa steg är att testa det nya kodavsnittet. Använd rutan :guilabel:`Test` längst ned. Skriv utlösartexten och tryck på |ct| för att expandera kodavsnittet och hoppa mellan platshållarna.
