# Menu tworzone przez użytkownika

## Ustawienia

&kile; obsługuje menu tworzone przez użytkownika, które będzie się ukazywać jako menu &kile;. Menu to można utworzyć przy użyciu okna dialogowego tworzenia &kile; poprzez Ustawienia Ustawienia Kile Menu użytkownika.

Ustawianie menu użytkownika
Ustawianie menu użytkownika

Menu można umieścić w jednym z dwóch miejsc:

- albo Menu użytkownika będzie wyświetlane na głównym pasku menu pomiędzy menu LaTeX i Pomocnik, a pomocnik do Edytowania menu użytkownika w menu Pomocnik

  Menu użytkownika jest umieszczane w menu głównym
  Menu użytkownika jest umieszczane w menu głównym

- albo oba elementy będą wyświetlane na dole menu LaTeX.

  Menu użytkownika jako część menu LaTeX
  Menu użytkownika jako część menu LaTeX

Istniejące znaczniki określone przez użytkownika w starszych wersjach &kile; zostaną samoczynnie przekształcone na nowe menu ustawialne przez użytkownika. Znaczniki zostaną zapisane w pliku o nazwie `usertags.xml` i jak wszystkie pliki od menu, można będzie je znaleźć w lokalnym katalogu menu użytkownika &kile;: `KILE_APP_DIR/usermenu/`, np. `/home/user/.kde/share/apps/kile/usermenu/`.

Można używać różnych plików określających menu dla różnych zadań. Wywołaj pomocnika menu poprzez Pomocnik Edycja menu użytkownika lub LaTeX Edycja menu użytkownika , aby wgrać lub edytować plik definicji menu.

## Pomocnik

Można utworzyć lub zmienić istniejące menu przy użyciu pomocnika tworzenia menu użytkownika, którego można znaleźć w menu Pomocnik Edycja menu użytkownika.

Pomocnik menu użytkownika
Pomocnik menu użytkownika

Po lewej stronie widać istniejące drzewo menu. Jako standardowe menu, zawiera ono trzy różne rodzaje elementów menu:

- standardowe wpisy menu, które są przypisywane do działań

- podmenu, które zawierają więcej elementów menu

- rozdzielniki, do uzyskania przejrzystej struktury wszystkich wpisów.

Do zmieniania tego menu, używaj sześciu przycisków po lewej. Więcej możliwości jest dostępnych z menu podręcznego już istniejących elementów menu.

Własne drzewo menu
Własne drzewo menu

Każdy standardowy element menu jest przypisany do jednego z trzech rodzajów działań, gdzie każdy z nich ma różne atrybuty, które można ustawić:

- Tekst: &kile; daje możliwość tworzenia własnych znaczników. Znacznik jest podobny do skrótu, który uruchamia pewne polecenie lub zapisuje często używane teksty, np. Jan Kowalski często używa zdań `Cześć, zostałem wstawiony ...`. Znacznik ten zostanie wstawiony w bieżącym położeniu kursora, przy wywołaniu działania (zobacz rysunek powyżej). Metaznaki są również dostępne (zobacz ).

- Wstawianie treści pliku: Wstawia pełną treść danego pliku.

  Wstawianie treści pliku
  Wstawianie treści pliku

- Wykonanie zewnętrznego programu: Wynik wykonywania takiego programu można wstawić do otwartego dokumentu. W wierszu poleceń można także używać metaznaku `%M`, a wtedy zaznaczony tekst zostanie zapisany do pliku tymczasowego. Użyj `%M` do nadania nazwy plikowi tymczasowemu.

  Wykonywanie programu zewnętrznego
  Wykonywanie programu zewnętrznego

Jeśli brakuje jakiejś ważnej informacji dla działania, to elementy menu zostaną zabarwione na czerwony. Powodem może być na przykład nieistniejący plik

Nieistniejący plik
Nieistniejący plik

lub brakujący tytuł dla wpisu menu, co zostanie wyświetlone jako trzy znaki zapytania: `???`

Brakujący tytuł wpisu menu
Brakujący tytuł wpisu menu

Po otwarciu menu podręcznego zabarwionego na czerwono elementu menu, pojawią się dodatkowe informacje dotyczące tego błędu.

Dodatkowe informacje
Dodatkowe informacje

Więcej informacji można uzyskać poprzez użycie funkcji większości elementów interfejsu o nazwie Co to jest?.

## Znaki wieloznaczne

### Wstawianie tekstu

W znacznikach określonych przez użytkownika można wykorzystywać pewne znaki wieloznaczne: `%C`, `%B`, `%M`, `%E`, `%R` oraz `%T`.

- `%C`: jest to miejsce, w którym zostanie wstawiony kursor po wstawieniu znacznika określonego przez użytkownika.

  Położenie kursora (%C)
  Położenie kursora (%C)

- `%B`: zostanie zastąpione przez punktor (zobacz ).

  Punktor (%B)
  Punktor (%B)

- `%M`: zostanie zastąpione zaznaczonym tekstem.

  Zaznaczony tekst (%M)
  Zaznaczony tekst (%M)

- `%E`: określa głębokość wcięcia tekstu wewnątrz otoczenia.

  Wcięcie tekstu otoczenia (%E)
  Wcięcie tekstu otoczenia (%E)

- `%R`: wywoła okno dialogowe odsyłaczy do wybrania wcześniej określonej etykiety. Można go używać do odwoływania się do wcześniej określonych etykiet, które można wybrać z listy rozwijanej (zajrzyj także do LaTeX Odsyłaczeref lub LaTeX Odsyłaczepageref).

  Odsyłacze (%R)
  Odsyłacze (%R)

- `%T`: wywoła okno dialogowe cytowania do wybrania wcześniej określonego cytatu. Tak samo jak w przypadku odwołań LaTeX Odsyłaczecite przywoła listę ze wszystkimi kluczami cytowań.

  Klucze cytowań (%T)
  Klucze cytowań (%T)

Rozważmy przypadek następującego makra `\frac{%M}{%C}`. Najpierw, wybierzemy liczbę w naszym tekście, powiedzmy `42`. teraz wywołamy to makro i otrzymamy `\frac{42}{}` z kursorem położonym w drugiej parze nawiasów.

### Wstawianie treści pliku

Przy wstawianiu treści plików tekstowych, można wykorzystać te same znaki wieloznaczne.

### Wykonywanie programu

Przy wykonywaniu zewnętrznego programu, rozpoznawany jest tylko `%M` dla zaznaczonego tekstu w wierszu poleceń. Zaznaczenie zostanie zapisane w pliku tymczasowym, a znak wieloznaczny `%M` zostanie zastąpiony nazwą tego pliku tymczasowego.

Wykonywanie programu zewnętrznego (%M)
Wykonywanie programu zewnętrznego (%M)

Kolejnym znakiem wieloznacznym jest `%S`, który jest zastępowany przez nazwę pliku bieżącego dokumentu bez ścieżki. Ta nazwa składa się ze znaków aż do ostatniego znaku '.' lecz nie jest on dodawany do tej nazwy.

## Parametr

Większość ze wpisów menu może mieć dodatkowe parametry, które można zaznaczyć. Jeśli niektóre z tych parametrów nie są dostępne dla pewnych działań, to będą one wyłączone.

Parametr menu użytkownika
Parametr menu użytkownika

Oto przykład na wykonywanie programu zewnętrznego:

Przykład z parametrem
Przykład z parametrem

Można zauważyć, że wywoływany jest skrypt `perl`, który powinien zadziałać z bieżącym zaznaczeniem. Parametr Wymaga zaznaczonego tekstu jest zaznaczony, aby zapewnić istnienie zaznaczenia. Wynik tego skryptu zostanie wstawiony (Wstawienie wyjścia wybranego programu) i zastąpi bieżące zaznaczenie (Zastąpienie zaznaczonego tekstu), lecz nie zaznaczy go.

## Plik określające menu

W czasie działania programu można wgrać różne menu dla różnych działań. Po wywołaniu pomocnika menu użytkownika, wczytywany jest plik określający bieżące menu. Jeśli je zmienisz i zamkniesz okno dialogowe poprzez OK, to zmiany zostaną zapisane i wgrane jako nowe menu użytkownika. Zamknięcie okna dialogowego poprzez Anuluj porzuci zmiany.

Pliki określające menu
Pliki określające menu

Można także zapisać zmienione pliki w katalogu menu użytkownika lub wczytać i wgrać inny plik określający menu. Wszystkie pliki określające menu muszą być zapisane w katalogu lokalnym menu użytkownika &kile;: `KILE_APP_DIR/usermenu/`.

Spójrz na przykładowy plik określający menu `example.xml`, aby zobaczyć więcej wpisów menu z ich parametrami.