# Användaranpassad meny

## Anpassning

&kile; stöder en användaranpassad meny, som visas som en del av &kile;s meny. Menyn kan ställas in med &kile;s inställningsdialogruta med Inställningar Anpassa Kile Användarmeny.

Anpassa användarmenyn
Anpassa användarmenyn

Det finns två alternativ där menyn kan placeras:

- antingen visas menyalternativet Användarmeny i huvudmenyn mellan menyalternativen Latex och Guide, och inställningsguiden Redigera användarmeny i menyn Guide

  Användarmenyn är placerad i huvudmenyn
  Användarmenyn är placerad i huvudmenyn

- eller båda alternativen visas längst ner i menyalternativet Latex.

  Användarmenyn som en del av menyn Latex
  Användarmenyn som en del av menyn Latex

Redan befintliga användardefinierade taggar från äldre versioner av &kile; omvandlas automatiskt till den nya användaranpassade menyn. Taggarna sparas i en fil som heter `usertags.xml` och liksom alla menydefinitionsfiler, finns den i &kile;s lokala katalog för användarmenyer `KILE_PGM_KAT/usermenu/`, t.ex. `/home/användare/.kde/share/apps/kile/usermenu/`.

Olika menydefinitionsfiler kan användas för olika uppgifter. Använd användarmenyguiden Guide Redigera användarmeny eller Latex Redigera användarmeny för att installera eller redigera en menydefinitionsfil.

## Guide

Du kan skapa nya eller ändra befintliga menyer med en bekväm guide för anpassning av användarmenyer som finns under Guide Redigera användarmeny.

Användarmenyguiden
Användarmenyguiden

På vänster sida visas ett befintligt menyträd. Liksom i en vanlig meny är tre olika sorters menyalternativ tillgängliga:

- vanliga menyalternativ, som tilldelas en åtgärd

- undermenyer, som innehåller fler menyalternativ

- avskiljare, för att ge alla poster en synlig struktur.

Använd de sex knapparna på väster sida för att ändra menyn. Fler möjliga åtgärder är tillgängliga i den sammanhangsberoende menyn för de befintliga menyalternativen.

Användardefinierat menyträd
Användardefinierat menyträd

Varje vanligt menyalternativ tilldelas en av de tre åtgärdstyperna, där var och en av dem har olika egenskaper som kan anges:

- Text: &kile; ger dig möjlighet att skapa egna taggar. En tagg liknar en genväg som startar något kommando eller skriver in texter som ofta används, t.ex. använder medelsvensson ofta meningen `Hej, jag har blivit infogad ...`. Taggen infogas på nuvarande markörposition när åtgärden utförs (se ovan). Metatecken är också tillgängliga (se ).

- Infoga filinnehåll: Infogar det fullständiga innehållet i en angiven fil.

  Infoga filinnehåll
  Infoga filinnehåll

- Kör ett externt program: Utdata från programmet kan infogas i det öppnade dokumentet. Metatecknet `%M` är också möjligt att använda i kommandoraden till programmet, eftersom den markerade texten sparas i en tillfällig fil. Använd `%M` för den tillfälliga filens filnamn.

  Kör ett externt program
  Kör ett externt program

Om någon viktig information för en åtgärd saknas, markeras menyalternativ med rött. Det kan vara en fil som inte finns.

Saknad fil
Saknad fil

eller att rubriken saknas för menyalternativet, vilket visas med frågetecken som `???`.

Saknad rubrik för ett menyalternativ
Saknad rubrik för ett menyalternativ

Om den sammanhangsberoende menyn för ett sådant rödfärgat menyalternativ öppnas, får du alternativet ytterligare information med mer information som rör felet.

Ytterligare information
Ytterligare information

Mer information kan också vara tillgänglig genom att använda funktionen Vad är det här i de flesta grafiska komponenter.

## Platsmarkörer

### Infoga text

Det finns ett antal platsmarkörer som kan användas i användardefinierade taggar: `%C`, `%B`, `%M`, `%E`, `%R` och `%T`.

- `%C`: Det är här markören placeras efter en användardefinierad tagg infogas.

  Markörposition (%C)
  Markörposition (%C)

- `%B`: Ersätts av en punkt (se ).

  Punkt (%B)
  Punkt (%B)

- `%M`: Ersätts av den markerade texten.

  Markerad text (%M)
  Markerad text (%M)

- `%E`: Anger indenteringsdjupet för text inne i en omgivning.

  Indentering av miljötext (%E)
  Indentering av omgivningstext (%E)

- `%R`: Anropar en referensdialogruta för att välja en etikett som redan har definierats. Det kan användas för att referera till en fördefinierad etikett, som du kan välja i en kombinationsruta (se också Latex Referenser ref eller Latex Referenser pageref).

  Referenser (%R)
  Referenser (%R)

- `%T`: anropar en hänvisningsdialogruta för att välja en redan definierad hänvisning. På samma sätt som vid användning av Latex Referenser cite dyker en lista med alla hänvisningsnycklar upp.

  Hänvisningsnycklar (%T)
  Hänvisningsnycklar (%T)

Låt oss betrakta ett annat exempel, med följande makro `\frac{%M} {%C}`. Först markerar vi ett tal i texten, låt oss säga `42`. Nu anropar vi makrot och erhåller `\frac{42}{}` med markören placerad innanför det andra paret krullparenteser.

### Infoga filinnehåll

Om du vill infoga innehållet i en textfil skulle du kunna använda samma platsmarkörer.

### Kör ett program

Om du vill köra ett externt program känns bara `%M` för markerad text igen på kommandoraden. Markeringen sparas i en tillfällig fil och platsmarkören `%M` ersätts med filnamnet.

Kör ett externt program (%M)
Kör ett externt program (%M)

En annan platsmarkör är `%S` som ersätts med det nuvarande dokumentets fullständiga basnamn utan sökvägen. Basnamnet består av alla tecken i filen till (men inkluderar inte) det sista punkttecknet '.'.

## Parameter

De flesta menyalternativ kan ha ytterligare självförklarliga parametrar, som kan markeras. Om några av dessa parametrar inte är tillgängliga för en viss typ av åtgärd är de inaktiverade.

Användarmenyparametrar
Användarmenyparametrar

Här är ett exempel på att köra ett externt program:

Parameterexempel
Parameterexempel

Du kan se att ett `perl`-skript anropas, vilket arbetar på den nuvarande markeringen. Parametern Behöver markerad text är markerad för att garantera en markering. Utmatning från skriptet infogas (Infoga utmatning från valt program) och ersätter den nuvarande markeringen (Ersätt markerad text), men blir inte själv markerad.

Du kan naturligtvis också anropa dina egna program eller skript. Markera exempelvis en nummerlista åtskild av mellanslag, och anropa ett skript eller Perl-program, som omvandlar markeringen till &latex;-kod för en matris. Vilka idéer du än har, kan du förverkliga dem genom att använda följande alternativ i användarmenyn.

Parameterexempel 2
Parameterexempel 2

## Menydefinitionsfiler

Du kan installera olika menyer under körning för olika uppgifter. När guiden för användarmenyer anropas, läses den nuvarande menydefinitionsfilen in. Om du ändrar den och stänger dialogrutan med Ok, sparas ändringarna och installeras som en ny användarmeny. Stängs dialogrutan med Avbryt kastas alla ändringar.

Menydefinitionsfiler
Menydefinitionsfiler

Men du har också full frihet att spara den ändrade filen i användarmenykatalogen eller läsa in en annan menydefinitionsfil och installera den. Alla filer med användarmenydefinitioner måste sparas i den lokala användarmenykatalogen i &kile;: `KILE_APP_DIR/usermenu/`.

Titta i exemplet på en menydefinitionsfil, `example.xml`, för att se fler menyalternativ med tillhörande parametrar.