Kodavsnitt¶

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å Control+J. Redigeraren expanderar texten till:

<a href="filename"></a>

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 Automatisk komplettering-funktion. När du har skrivit filnamnet trycker du på Control+J igen. Markören flyttas då till platsen mellan <a>-taggarna, där du enkelt kan skriva länktexten.

Kodavsnittssystemet i redigeraren är mycket avancerat. Det finns några inbyggda kodavsnitt, och du kan skapa egna som passar ditt sätt att arbeta.

Genomgången av de inbyggda kodavsnitten nedan visar hur kraftfullt systemet är.

Anteckning

Du kan också använda kodavsnitt i textfälten på panelen Sök och ersätt. Platshållare där du hoppar mellan positioner med Control+J fungerar dock inte där.

Inbyggda kodavsnitt¶

De inbyggda kodavsnitten beskrivs nedan. Observera att du kan åsidosätta dem genom att skapa dina egna kodavsnitt med samma utlösartext.

Infoga fyllnadstext [Lorem]¶

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, 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å Control+J. Texten ersätts då med ett par stycken fyllnadstext.

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.

Infoga en självstängande HTML-tagg [<>]¶

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å Control+J, så expanderar redigeraren kodavsnittet till:

<|/>

Här anger symbolen | markörens aktuella position. Skriv hr och tryck på Control+J för att flytta markören till positionen efter taggen. Kodavsnittet definieras så här:

Trigger: <>
Template: <$1/>$2

Platshållare består av ett dollartecken ($) följt av ett tal. När kodavsnittet expanderas med Control+J placeras markören vid den första platshållaren, alltså den med lägst nummer. Nästa gång du trycker på Control+J flyttas markören till platshållaren med närmast högre nummer.

Infoga en HTML-länktagg [<a]¶

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å Control+J, så expanderar redigeraren kodavsnittet till:

<a href="filename|"></a>

Dessutom markeras ordet filename och markören placeras på det, så att du enkelt kan skriva det verkliga filnamnet med redigerarens praktiska Automatisk komplettering-funktion. När filnamnet är klart trycker du på Control+J igen. Markören flyttas då till positionen mellan <a>-taggarna, där du skriver länktexten. Tryck på Control+J ännu en gång för att flytta markören till positionen efter sluttaggen. Kodavsnittet definieras så här:

Trigger: <a
Template: <a href="${1:filename}">${2*}</a>$3

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 Control+J 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}.

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å Control+J, skriva <a och trycka på Control+J igen. Mallen expanderas då till:

<a href="filename">whatever text you selected</a>

Infoga en HTML-bildtagg [<i]¶

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:

Trigger: <i
Template: <img src="${1:filename}" alt="${2*:description}" />$3

Infoga en godtycklig HTML-tagg [<<]¶

Med detta kodavsnitt kan du infoga en valfri fullständig HTML-tagg eller omsluta tidigare markerad text med taggen. Skriv << och tryck på Control+J. Om du vill omsluta markerad text markerar du den först, trycker på Control+J, skriver << och trycker på Control+J igen. Redigeraren expanderar kodavsnittet till:

<|></>

Skriv taggnamnet, till exempel span, och tryck på Control+J. Resultatet blir:

<span>|</span>

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å Control+J. Kodavsnittet definieras så här:

Trigger: <<
Template: <$1>${2*}</$1>$3

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.

Infoga en godtycklig HTML-tagg med ett klassattribut [<c]¶

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:

Trigger: <c
Template: <$1 class="${2:classname}">${3*}</$1>$4

Du kan först skriva taggnamnet, trycka på Control+J, skriva klassnamnet, trycka på Control+J, skriva taggens innehåll och slutligen trycka på Control+J för att flytta markören utanför taggen. Sluttaggen fylls i automatiskt.

Skapa dina egna kodavsnitt¶

Kodavsnitt blir särskilt användbara eftersom du kan skapa egna som passar ditt arbetssätt. Gå till Redigera → Inställningar → Redigerarinställningar → Hantera kodavsnitt i redigeraren. Då öppnas en lättanvänd dialogruta. Klicka på Lägg till kodavsnitt för att visa följande dialogruta:

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å Control+J för att expandera kodavsnittet.

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.

Nästa steg är att testa det nya kodavsnittet. Använd rutan Test längst ned. Skriv utlösartexten och tryck på Control+J för att expandera kodavsnittet och hoppa mellan platshållarna.