# Meni, ki ga lahko konfigurira uporabnik

## Konfiguracija

&kile; podpira uporabniško nastavljiv meni, ki bo prikazan kot del menija &kile;. Ta meni lahko nastavite s konfiguracijo &kile; dialog zNastavitve Konfiguriraj Kile Uporabniški meni.

Konfiguriraj uporabniški meni Konfiguriraj uporabniški meni

Na voljo imate dve možnosti, kam postaviti ta meni:

- bodisi da se Uporabniški meni prikaže v glavni menijski vrstici med meniji LaTeX in Čarovnik inbodisi v čarovniku za konfiguracijo Urejanje uporabniškega menija v meniju Čarovnik

  Uporabniški meni je postavljen v glavni meni Uporabniški meni je postavljen v glavni meni

- ali pa se bosta oba elementa pojavila na dnu menija LaTeX.

  Uporabniški meni kot del menija LaTeX Uporabniški meni kot del menija LaTeX

Že obstoječe uporabniško definirane oznake iz starejših različic &kile; samodejno preoblikuje v nov uporabniško nastavljiv meni. Oznake so shranjene v datoteko, imenovano `usertags.xml` in kot vse datoteke z definicijami menijev tudi to najdete v imeniku lokalnega uporabniškega menija &kile;: `KILE_APP_DIR/usermenu/`, ⪚ `/home/user/.kde/share/apps/kile/usermenu/`.

Za različna opravila lahko uporabite različne datoteke z definicijami menija. Pokličite čarovnika za uporabniški meni Čarovnik Uredi uporabniški meni ali LaTeX Uredi uporabniški meni za namestitev ali urejanje datoteke z definicijo menija.

## Čarovnik

Z udobnim uporabniškim menijem lahko ustvarite nove ali spremenite obstoječe menije čarovnika za konfiguracijo najdete v Čarovnik Uredi uporabniški meni.

Čarovnik za uporabniški meni Čarovnik za uporabniški meni

Na levi strani boste videli obstoječe drevo menijev. Kot standardni meni so na voljo tri različne vrste elementov menija:

- standardni menijski vnosi, ki so dodeljeni dejanju

- podmeniji, ki vsebujejo več elementov menija

- ločilniki, da dobite vidno strukturo vseh vnosov.

Če želite spremeniti ta meni, uporabite šest gumbov na levi strani. Več možnih dejanj je na voljo v kontekstnem meniju že obstoječih elementov menija.

Uporabniško definirano drevo menijev Uporabniško definirano drevo menijev

Vsaka standardna menijska postavka je dodeljena eni od treh vrst dejanj, kjer ima vsaka od njih različne atribute, ki jih je mogoče nastaviti:

- Besedilo: &kile; vam daje možnost, da naredite svoje lastne oznake. Oznaka je podobna bližnjici, ki zažene nek ukaz oz. piše pogosto uporabljenobesedilo, npr. Joe Sixpack pogosto uporablja stavke `Živjo, bil sem vstavljen...`. Ta oznaka bo vstavljena na trenutni položaj kazalca, ko je to dejanje klicano (glejte zgoraj). Na voljo so tudi metaznaki (glejte id_usermenu_placeholders).

- Vstavi vsebino datoteke: Vstavi celotno vsebino dane datoteke.

  Vstavi vsebino datoteke Vstavi vsebino datoteke

- Izvedi zunanji program: Rezultat tega programa lahko vstavite v odprt dokument. Metaznak `%M` je tudi mogoč v ukazni vrstici tega programa, kot bo izbrano besedilo shranjeno v začasni datoteki. Za ime te začasne datoteke uporabite `%M`.

  Izvedi zunanji program Izvedi zunanji program

Če nekatere pomembne informacije za dejanje manjkajo, se menijski elementi obarvajo rdeče. To je lahko neobstoječa datoteka

Neobstoječa datoteka Neobstoječa datoteka

ali manjkajoči naslov za menijski vnos, ki bo prikazan z vprašaji kot `???`.

Manjka naslov menijskega vnosa Manjka naslov vnosa v meniju

Če odprete kontekstni meni take rdeče obarvane postavke menija, boste prejeli dodatno možnost za več informacij o tej napaki.

Dodatne informacije Dodatne informacije

Več informacij je lahko na voljo tudi s funkcijo Kaj je to večine gradnikov.

## Oznake mesta

### Vstavi besedilo

Obstaja nekaj oznak mest, ki jih lahko uporabite v svojih uporabniško določenih oznakah: `%C`, `%B`, `%M`, `%E`, `%R` in `%T`.

- `%C`: tukaj bo postavljen kazalec po vstavitvi uporabniško določene oznake.

  Položaj kazalca (%C) Položaj kazalca (%C)

- `%B`: bo nadomeščena s točko naštevanja (glejte editing_bullets).

  Točka naštevanja (%B) Točka naštevanja (%B)

- `%M`: bo nadomestilo izbrano besedilo.

  Izbrano besedilo (%M) Izbrano besedilo (%M)

- `%E`: označuje globino zamika besedila znotraj okolja.

  Zamik okolja besedila (%E) Zamik okolja besedila (%E)

- `%R`: bo poklical referenčno pogovorno okno za izbiro oznake, ki je že definirana. To se lahko uporablja za sklicevanje na vnaprej določeno oznako, ki jo lahko izbirate s spustnega seznama (glejte tudi LaTeX Reference ref oz.LaTeX Reference pageref).

  Reference (%R) Reference (%R)

- `%T`: bo poklical pogovorno okno za navajanje, da izbere že definiran citat. Enako kot pri uporabi LaTeX Reference cit se pojavi seznam z vsemi ključi za navedbe.

  Ključi navedb (%T) Ključi navedb (%T)

Oglejmo si še en primer z naslednjim makrom `\frac{%M}{%C}`. Najprej izberemo številko v svojem besedilu, recimo `42`. Zdaj pokličemo ta makro in pridobimo `\frac{42}{}` s kazalcem v drugem paru oklepajev.

### Vstavi vsebino datoteke

Če želite vstaviti vsebino besedilne datoteke, lahko uporabite iste oznake mest.

### Izvedi program

Če želite izvesti zunanji program, je za izbrano besedilo prepoznan samo `%M` v ukazni vrstici. Izbor bo shranjen v začasno datoteko in nadomestni znak `%M` je nadomeščen s tem imenom datoteke.

Izvedi zunanji program (%M) Izvedi zunanji program (%M)

Druga nadomestni znak je `%S`, ki je nadomeščen s celotnim osnovnim imenom trenutnega dokumenta brez poti. To osnovno ime sestoji iz vsehznakov v datoteki do (vendar brez) zadnje pike '.'.

## Parameter

Večina menijskih vnosov ima lahko dodatne samorazlagajoče parametre, ki jih je lahko preveriti. Če nekateri od teh parametrov niso na voljo za neko vrsto dejanja, soonemogočeni.

Parameter uporabniškega menija Parameter uporabniškega menija

Tukaj je en primer za izvajanje zunanjega programa:

Primer parametra Primer parametra

Vidite lahko, da je poklican skript `perl`, kar bi moralo delovati s trenutno izbiro. Parameter Potrebuje izbrano besedilo je preverjen, da zagotovite izbiro. Izhod tega skripta bo vstavljen (Vstavi izhod izbranega programa) in zamenjaj trenutni izbor (Zamenjaj izbrano besedilo), vendar ni sam izbran.

Seveda lahko pokličete tudi svoje programe ali skripte. Na primer izberite seznam številk, ločenih s presledki, in pokličite skript ali program Perl, ki preoblikuje ta izbor v &latex; kodo za matriko. Ne glede na vaše zamisli, jih lahko realizirate z naslednjim vnosom v uporabniškem meniju.

Primer parametra 2 Primer parametra 2

## Datoteke z definicijami menija

Med izvajanjem lahko namestite različne menije za različna opravila. Ko pokličete čarovnika za uporabniški meni, se naloži trenutna datoteka z definicijo menija. Če ga spremenite in zaprete pogovorno okno z gumbom V redu, bodo vaše spremembe shranjene in nameščene kot nov uporabniški meni. Zapiranje pogovornega okna z Prekličibo zavrglo vse spremembe.

Datoteke z definicijami menija Datoteke z definicijami menija

Prav tako lahko spremenjeno datoteko shranite v imenik uporabniškega menija ali naložite drugo datoteko z definicijo menija in jo namestite. Definicije vseh uporabniških menijev datotek mora biti shranjena v imeniku lokalnega uporabniškega menija &kile;: `KILE_APP_DIR/usermenu/`.

Oglejte si datoteko z definicijo menija `example.xml`, da vidite več vnosov menija z njihovimi parametri.