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: calibre e-bokredigeraren stöder *kodavsnitt*. Ett avsnitt är ett stycke text som antingen återanvänds ofta eller innehåller mycket överflödig text. Redigeraren kan du infoga ett kodavsnitt med endast ett fåtal knapptryckningar. Anta till exempel att du ofta infogar länktaggar när du redigerar HTML-filer, då kan du helt enkelt skriva ``<a`` i redigeraren och trycka |ct|. Redigeraren kommer att utöka det 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: Inte bara det, ordet ``filnamn`` kommer att väljas, med markören placeras över den, så att du enkelt kan skriva in det verkliga filnamnet med med redigerarens smidiga :ref:`editor_auto_complete`-funktion. Och när du är klar med att skriva filnamnet, tryck på |ct| igen och markören hoppar till positionen mellan taggarna ``<a>`` så att du enkelt kan skriva in texten för länken.

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 sofistikerad, det finns några inbyggda kodavsnitt och du kan skapa din egen som passar din redigeringsstil.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
sv: Följande diskussion av de inbyggda kodavsnitt bör hjälpa illustrera kraften i kodavsnittssystemet.

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 textinmatningsfält i :guilabel:`Sök och ersätt`-panelen, dock platshållare (med |ct| för att hoppa runt) kommer inte att fungera.

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 kodavsnitt, och det enklaste används för att infoga fyllnadstext i ett dokument. Fyllnadstexten är hämtad från `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ ett filosofiskt verk av Cicero (översatt till engelska). För att använda den, skriv helt enkelt ``Lorem`` i en HTML-fil och tryck |ct|. Det kommer att ersättas av ett par stycken av 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 detta kodavsnitt är mycket enkel, utlösartexten definieras som ``Lorem`` och mallen definieras helt enkelt som den bokstav texten som ska infogas. Du kan enkelt anpassa den för att använda din favorit form av fyllnadstext.

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 ska vi titta på ett enkelt exempel på den kraftfulla begreppet *platshållare*. Säg att du vill infoga självstängande taggen ``<hr/>``. Skriv bara ``<>`` och tryck |ct| så kommer redigeraren utvidga 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 representerar ``|`` symbolen den aktuella markörpositionen. Du kan sedan skriva ``hr`` och trycka |ct| för att flytta markören till efter slutet av taggen. Detta kodavsnitt definieras som::

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 är helt enkelt dollar ($)-tecken följt av ett nummer. När kodavsnittet utvidgas genom att trycka |ct| är markören placerad vid den första platshållaren (platshållaren med det lägsta numret). När du trycker på |ct| igen markören hoppar till nästa platshållare (platshållaren med nästa 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: HTML-länktaggar delar alla en gemensam struktur. De har ett ``href`` attribut och lite text mellan start- och sluttaggen. Ett kodavsnitt att skriva in dem mer effektiva kommer att introducera oss till några fler funktioner i platshållare. För att använda detta kodavsnitt, skriv helt enkelt ``<a`` och tryck |ct|. Redigeraren kommer att utvidga detta 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: Inte bara det, ordet ``filnamn`` kommer att väljas, med markören placeras över den, så att du enkelt kan skriva in det verkliga filnamnet med med redigerarens smidiga :ref:`editor_auto_complete`-funktion. Och när du är klar med att skriva filnamnet, tryck på |ct| igen och markören hoppar till positionen mellan taggarna ``<a>`` så att du enkelt kan skriva in texten för länken. När du är klar med att skriva texten trycker du på |ct| igen för att hoppa till punkten efter den avslutande taggen. Detta kodavsnitt definieras som::

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: Det finns ett par nya funktioner här. Först ``$1`` platshållare har blivit mer komplex. Den innehåller nu en del *standardtext* (ordet `` filename``). Om en platshållare innehåller standardtext, är standardtexten istället för platshållaren när kodavsnittet utvidgas. Även när du hoppar till en platshållare med standardtext som använder |ct|, väljs standardtexten. På detta sätt kan du använda standardtexten som en påminnelse till dig att fylla i viktiga delar av mallen. Du kan ange standardtext för en platshållare genom att använda 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 nya funktionen är att den andra platshållaren har en asterisk efter sig (``${2*}``). Detta innebär att all text som valdes innan mallen utvidgades ersätter platshållaren. För att se detta i handling, välja någon text i redigeraren, tryck |ct|, typ ``<a`` och tryck |ct| igen, mallen kommer att utökas 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 är mycket likt att infoga en HTML-länk, som vi såg ovan. Det gör att du snabbt kan mata in en ``<img src="filename" alt="description" />`` tagg och hoppa mellan ``src`` och ``alt`` attribut::

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: Detta låter dig infoga en godtycklig fullständig HTML-tagg (eller radbryta tidigare markerad text i taggen). För att använda den, skriv helt enkelt ``<<`` och tryck på |ct|. Om du vill radbryta markerad text, markera först texten, tryck på |ct| och skriv sedan ``<<`` och tryck på |ct| igen. Redigeraren kommer att expandera den till::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
sv: Skriv taggnamnet, till exempel: ``span`` och tryck |ct|, som kommer att resultera i::

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 kommer att märka att den avslutande taggen automatiskt har fyllts i med ``span``. Detta uppnås med ytterligare en funktion hos platshållare, *mirroring*. Spegling innebär helt enkelt att om du anger samma platshållare mer än en gång i en mall, kommer den andra och alla senare positioner automatiskt att fyllas i med det du skriver i den första positionen, när du trycker på |ct|. Definitionen för detta kodavsnitt ä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 ni kan se, har den första platshållaren ($1) specificerats två gånger, andra gången i den avslutande taggen, som helt enkelt kommer att kopiera vad du skriver i öppningstaggen.

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: Detta gör att du kan först skriva taggnamnet, tryck |ct|, skriv klassnamnet, tryck |ct|, skriv innehållet i taggen och tryck |ct| en sista gång för att hoppa ur taggen. Den avslutande taggen kommer att automatiskt fyllas.

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 lyser verkligen eftersom du kan skapa dina egna för att passa din redigeringsstil. För att skapa egna kodavsnitt gå till :guilabel:`Redigera->Inställningar->Redigerarinställningar->Hantera kodavsnitt` i redigeraren. Detta kommer att ta fram en lättanvänd dialogruta för att hjälpa dig att skapa dina egna kodavsnitt. Klicka helt enkelt på knappen :guilabel:`Lägg till kodavsnitt` och du kommer att se en dialogruta som ser ut:

en: The create your own snippets tool
sv: Skapa dina egna kodavsnittsverktyg

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: Först ge ditt kodavsnitt ett namn, något beskrivande, för att hjälpa till att identifiera texturvalet i framtiden. Ange sedan *utlösaren*. En utlösare är helt enkelt den text som du måste skriva i redigeraren innan du trycker |ct| för att utöka 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 kodavsnittsmallen. Du bör börja med ett av exemplen ovan och ändra det för att passa dina behov. Slutligen ange vilka filtyper du vill att kodavsnittet ska vara aktivt för. På så sätt kan du ha flera kodavsnitt med samma utlösartext som fungerar annorlunda 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 ditt nyskapade kodavsnitt. Använd tutan :guilabel:`Test` längst ner. Skriv in utlösartexten och tryck |ct| för att utvidga kodavsnittet och hoppa mellan platshållare.
