Yudit: HOWTO-configure.txt
=====================================================================
Verze: 2.2
Autor: Gaspar Sinai <gsinai@yudit.org>
Datum: Tokyo 2001-02-06

Tento dokument popisuje, jak konfigurovat Yudit. 
=====================================================================
1 Načítání konfiguračního souboru

 Při spuštění načítá Yudit konfigurační soubor:
  <prefix>/share/yudit/config/yudit-properties,
 kde <prefix> je instalační prefix, obvykle /usr.
 To je systémový konfigurační soubor. Pokud je soubor nalezen, jeho
 položky jsou sloučeny se základní konfigurací zabudovanou v programu.
 Po startu se pokusí vytvořit adresáře:
   ~/.yudit
   ~/.yudit/fonts
   ~/.yudit/data,
 pokud ještě neexistují. ~/ znamená domovský adresář uživatele,
 například '/home/gsinai'. Pokusí se načíst soubor
   ~/.yudit/yudit.properties.
 Existující položky v tomto souboru přepíší dříve načtené
 položky systémové konfigurace.

 Při ukončení Yuditu se pokusí sloučit určité parametry v tomto souboru
 s některými parametry, které může uživatel změnit v prostředí Yuditu.
 V současnosti jsou nahrazovány tyto parametry:
  yudit.editor.font
  yudit.editor.fontsize
  yudit.editor.input
  yudit.filetypes.

=====================================================================
2 Formát konfiguračního souboru

 Konfigurační soubory obsahují takovéto řádky:
  hierarchical.key.string=value
 nebo
  hierarchical.key.string=value1,value2,value3
 Je velmi důležité, že nikde nemají být žádné mezery navíc.
 Dvě samostatné řádky lze spojit znakem '\<newline>', ale není to
 žádoucí, zejména v uživatelově konfiguračním souboru. Yudit spojí
 tyto řádky v souboru.
 
 Mějte na paměti: je-li specifikováno pole v systémovém konfiguračním
 souboru s prvky hodnota1,hodnota2,hodnota3 a stejné pole je i v konfiguračním
 souboru uživatele s prvky máhodnota1,máhodnota2, všechny prvky pole
 budou načteny z konfiguračního souboru uživatele: máhodnota1,máhodnota2.

=====================================================================
3 Základní konfigurační parametry

Jsou to parametry, které mají podstatný vliv na yudit. Můžete
přidat virtuální písma, volby okna editoru, jako je velikost písma,
+vstupní metody.

---------------------------------------------------------------------
3.1 yudit.datapath

 Parametr pole. Příklad: 
  yudit.datapath=/usr/share/yudit/data,/home/gsinai/data,...
 Je to velmi důležitý parametr. Definuje vyhledávací cestu,
 Yudit zde bude hledat soubory-my, které potřebuje k mapování písem,
 vytváření vstupních metod, a převodníky.
 Všimněte si, že adresáře
  <prefix>/yudit/data
  ~/.yudit/data
 budou vždy přidány do seznamu.

---------------------------------------------------------------------
3.2 yudit.fontpath

 Parameter pole. Příklad:
  yudit.fontpath=/usr/share/yudit/fonts,/usr/share/truetype/,...
 Tento parametr definuje vyhledávací cestu pro písma True Type.
 Všimněte si, že adresáře
  <prefix>/yudit/fonts
  ~/.yudit/fonts
 budou vždy přidány do seznamu.

---------------------------------------------------------------------
3.3 yudit.fonts, yudit.editor.fonts (4.1)

 Parametry pole. Oba definují dostupná písma. 
 yudit.editor.fonts(4.1) definuje dostupná písma, která mohou být zvolena
 v editačním okně Yuditu. Písma dostupná v dalších částech rozhraní
 (popisky, tlačítka) jsou množinou obou.

 Příklad:
  yudit.editor.fonts=default,TrueType,Bitmap
  yudit.fonts=buttonfont,labelfont
 Pak budou dostupná následující virtuální písma:

 Shift-F1 - default
 Shift-F2 - TrueType
 Shift-F3 - Bitmap

 Lze použít jakékoli názvy. Názvy "None" nebo "none" jsou speciální.
 Znamenají, že nejsou žádány žádné změny písma, i když byla stisknuta
 odpovídající kombinace kláves Shift-Fxx.

 Tyto názvy virtuálních písem by měly být definovány později parametrem
  yudit.font.<fontname>.
 Název default je definován interně a není požadováno, aby byl definován
 v parametru yudit.font.default, pokud to neděláte úmyslně se znalostí
 věci. Písmo default má na první řádce unicode.hex. Takže, pokud
 vložíte unifont.hex do ~/.yudit/fonts můžete okamžitě editovat soubory.
---------------------------------------------------------------------
3.4 yudit.font.<fontname>

 Pole. Tento parametr definuje virtuální písmo, které bylo specifikováno v 3.3.
 Příklad:
  yudit.font.TrueType=arial.ttf,cyberbit.ttf,*-iso8859-1
 Takto se definuje a virtuální písmo, na které se lze odkazovat aliasem
 TrueType. Toto virtuální písmo se pokouší nalézt 3 soubory písem v cestách
 fontpath (3.2), a pokud je nenalezne, pokouší se je načíst jako písma x11.
 Nejpravděpodobněji najde:
  /usr/share/yudit/font/arial.ttf
  /usr/share/yudit/font/cyberbit.ttf,
 a nenajde žádný soubor jména *-iso8859-1, takže se pokusí najít
 nejbližší shodu u X11 serveru, písmo jako:
    -adobe-courier-bold-o-normal--12-120-75-75-m-70-iso8859-1,
 v případě, že použitá velikost písma byla 12. Deklarace *-iso8859-1 byla
 dost neúplná, může být definována mnohem přesněji.

 Yudit má zabudované převodníky pro většinu standardních kódování
 písem X11. (zdroj swindow/sx11/SX11Font.cpp)
  *-iso10646-1
  *-iso10646p2-<1-16>
  *-iso8859-<1-9>
  *-koi8-1
  *-koi8-r
  *-ksc5601*
  *-jisx0208*
  *-jisx0201*
  *-jisx0212*-0
  *-big5*
  *-gb2312*
  *-iso646*
 Písma dostupná ve vašem X11 serveru ověříte příkazem
  xlsfonts
 na příkazové řádce shellu.

 Yudit má zabudovaný převodník ucs-2 pro písma True Type.
 To je užitečné pro písma True Type, která mají atributy
 platform=3 encoding=1, platform=2 encoding=1 nebo platform=1.
 Pokud máte písmo, které neobsahuje unikódovou tabulku, musím
 upravit encodingVector v swindow/SFontTTF.cpp ve zdrojovém
 stromu yuditu a přidat převodník.
 Prosím, pošlete mi vaše případné úpravy.

 Pokud písmo není unikódové a existuje převodník <encoding>.my,
 lze mu přiřadit volitelný parametr:

 yudit.font.<fontname>:něc.ttf:<encoding>

 Speciální klíčové slovo 'unicode' lze připojit k písmům kódovaným
 v unikódu.

 Ještě další parametr lze připojit k písmům, která
 specifikují svůj počáteční směr, např.:

 yudit.ttf:unicode:LR - směr zleva-doprava
 yudit.ttf:unicode:RL - směr zprava-doleva.

 To je důležité jen tehdy, když potřebujete zrcadlit glyfy,
 jako Old Italic nebo Old Hungarian.

 GNU Unifont může být použit přímo zadáním jména s příponou
 .hex, takto: unifont.hex.


=====================================================================
4 Konfigurační parametry menu

Tyto konfigurační parametry vytvoří možnosti v editoru.

---------------------------------------------------------------------
4.1 yudit.editor.fonts

 Pole. Definuje volby písma pro grafické rozhraní. Viz též
 
  yudit.fonts

---------------------------------------------------------------------
4.2 yudit.editor.fontsizes

 Pole. Definuje dostupné velikosti písma.
 Příklad:
  yudit.editor.fontsize=12,14,16,18,24,48

 Protože velikosti písem X11 budou definovány jako celá čísla, nepoužívejte
 zde, prosím, reálné hodnoty. Tato hodnota nahradí velikost písma
 v XLFD pro písma X11. Písma True Type budou používány v měřítku, 
 jako by obrazovka byla v rozlišení 72 dpi.

---------------------------------------------------------------------
4.3 yudit.editor.inputs

 Pole. Definuje uživatelsky volitelné vstupní metody. Tyto vstupní metody
 mohou pocházet ze souboru .my podle parametru yudit.datapath (3.1.).
 Všimněte si, prosím, že soubory kmap v <prefix>/yudit/src jsou nainstalovány
 pouze pro referenci.
 Mohou být použity až po převodu do formátu .my a po správném
 umístění do adresáře v cestě yudit.datapath - většina z nich tam je.

 Konfigurační příklad:
  yudit.editor.inputs=straight,unicode,kinput2,Hungarian,None,Esperanto\
     freehand
  
 Pak se načtou:
 F1 straight: zabudovaná - žádné mapování
 F2 unicode: zabudovaná - \uxxxx oddělovačem uvozené kódy
 F3 kinput2: zabudovaná - _JAPANESE_CONVERSION
 F4 Hungarian: externí soubor Hungarian.my, který je hledán
  a pravděpodobně nalezen v /usr/share/yudit/data/Hungarian.my
 F5 None: při stisku F5 se nic nestane
 F6 Esperanto: externí, jako Hungarian
 F7 freehand: interní, stroj ručního písma s externími popisnými
  soubory ručního písma.

 Pokud si chcete vytvořit vlastní vstupní soubor klávesnice .my, měli
 byste si přečíst soubor <prefix>/share/yudit/doc/keymap-format.txt
 a konzultovat manuálovou stránku programu mytool.

 Protože kmapy mohou být použity jako externí textové převodníky,
 uniconv -h vypíše seznam těch, které nalezne v cestě datapath.

 Můžete si také vytvořit vlastní soubor rozpoznávání ručního písma.
 Přečtěte si, prosím, <prefix>/share/yudit/doc/README-FREEHAND, kde
 najdete návod.

---------------------------------------------------------------------
4.3 yudit.editor.xinputs

 Seznam x vstupních metod ve formě

   jméno:lokalizace,

 kde :lokalizace je volitelná. Vstup se objeví na liště jako x-jméno.

 Příklad: interxim,kinput2:ja_JP.eucJP,xcin:zh_TW.big5,Ami:ko_KR
 

 Speciální metoda:

 utf-8 - předá všechny řetězce X11, jak jsou - v unikódu, pokud
         X11 podporuje utf-8. Jestliže specifikujete lokalizaci,
         např, 'utf-8:hu_HU', pak je lokalizace nastavena před
         přepnutím do tohoto režimu, což umožňuje sestavování
         znaků ve stylu X11.

 Všímněte si, že pokud má lokalizace kódování ve formě: 

    jazyk_VARIANTA.kódovástránka,

 bude pro kódování použit vlastní převodník řetězců Yuditu.
 Také se budou používat některé aliasy: 

 eucjp -> euc-jp; euckr -> euc-kr; big5 -> big-5; 

 V zájmu nahradit vyřazené gb-2312 se také použijí následující
 kompatibilní aliasy:

 gb2312 -> gb-18030; gb-2312 -> gb-18030; gb18030 -> gb-18030

 Samozřejmě můžete úplně vynechat kódování: ko_KR znamená použít
 vyhledávání utf-8.

 Všimněte si, že konverze začíná a končí stiskem <Shift><Mezerník>.

 Spustit kinput2 a canna: kinput2 -canna &
 Spustit Ami: export LC_ALL=ko_KR; ami
 Spustit xcin (režim big5): export LC_ALL=zh_TW.big5; xcin
 Spustit xcin (režim gb2312): export LC_ALL=zh_CN.GB2312; xcin

 Všimněte si, že kinput2 může mít konfigurační soubor ve vašem domovském
 adresáři: nazvaný '.canna'. Pak doporučuji, abyste okomentovali toto:
 ;;(global-set-key "\F1" 'extend-mode),
 jinak se mohou dít podivné věci, když stisknete F1.
  
---------------------------------------------------------------------
4.4 yudit.editor.filetypes

 Pole. Tento seznam se přidá k původnímu seznamu souborových typů
 v dialogu souborů. Normálně by dialog souborů zobrazil jen zabudované
 typy. Jinak se tomu říká kódování (3.6.)
 Příklad:
  yudit.editor.filetypes=Hungarian,Hangul
 Používám tyto klávesnicové mapy k převodu textů maďarštiny nebo hangul.

=====================================================================
5. Výchozí konfigurační parametry

Tyto parametry nastavují některé počáteční hodnoty.

---------------------------------------------------------------------
5.1 yudit.default.filtype

 Řetězec. Definuje, které kódování se použije zpočátku při spuštění Yuditu.
 Úplný seznam podporovaných kódování získáte zadáním
  uniconv -h
 v okně shellu. Jinak se tomu říká typ souborů v dialogu souborů.
 Příklad:
 yudit.default.filetype=utf-8

---------------------------------------------------------------------
5.2 yudit.default.printer.options

 Řetězec. Definuje možnosti, které jsou předány příkazu 'lpr' při tisku.
 Příklad:
  yudit.default.printer.options=-P NázevTiskárny

---------------------------------------------------------------------
5.3 yudit.default.preview.command

 Řetězec. Definuje příkaz použitý, je-li stisknuto tlačítko náhled tisku.
 Jde o úplný unixový příkaz, který se provede takto
  /bin/sh -c 'cokoli jste konfigurovali'
 a postscriptový výstup se předá tomuto příkazu.
 Příklad:
  yudit.default.preview.command=ghostview -

---------------------------------------------------------------------
5.4 yudit.default.clipboard.encoding

 Převodník schránky pro vyjmout a vložit v X11, pokud je požadovaný
 text typu COMPOUND_TEXT. COMPOUND_TEXT by mohl být dekódován yuditem,
 pokud by existoval univerzální dekodér. Na druhé straně kódování není
 jednoznačné, protože existují znaky, které zaujímají stejné místo
 v unikódu, ale liší se v typu COMPOUND_TEXT. Z toho důvodu a proto,
 že yudit nemá univerzální dekodér, je třeba výslovně nastavit tento
 převodník. Zkuste použít nějaký iso-2022-x11 pro japonský nebo
 ksc-5601-x11 pro korejský systém XWindow.

5.5 yudit.default.geometry

 Specifikuje počáteční velikost okna editoru. Předvolená hodnota
 je "780x480". To znamená 780 pixelů šířky a 480 pixelů výšky.

=====================================================================
6 Konfigurační parametry ke změně vzhledu

Tyto parametry mění barvy, písma v grafické rozhraní a editační
oblasti. Všechny tyto parametry jsou řetězce. Všechny barvy mohou být
názvy barev nebo hodnoty #rrggbb, kde rr, gg a bb jsou 8-bitové
šestnáctkové kódy pro červenou, zelenou a modrou barevnou komponentu.
Booleovské hodnoty mohou být true nebo false.

---------------------------------------------------------------------
6.1 yudit.default.language

 Jazyk uživatelského rozhraní. Podívejte se, prosím, do
  <prefix>/share/yudit/locale/,
 kde zjistíte, která dvoupísmenná jména jsou podporována.
 Příklad:
 yudit.default.language=ja
 Pokud tento parametr chybí nebo obsahuje prázdný řetězec použije se
 proměnná prostředí LANG nebo pokud chybí, tak proměnná LANGUAGE.
 Pokud tohle všechno selže, použije se angličtina.
 Pokud máte zájem přeložit yudit do vašeho vlastního jazyka, měli byste
 si přečíst <prefix>/share/yudit/README.TXT.
---------------------------------------------------------------------
6.2 yudit.default.font

 Zatímco yudit.editor.font nastavuje počáteční písmo v editační oblasti,
 tímto se nastaví písmo v dalších komponentách, popiskách a tlačítkách.

---------------------------------------------------------------------
6.3 yudit.default.fontsize

 Zatímco yudit.editor.fontsize nastavuje počáteční velikost písma
 v editační oblasti, tímto se nastaví velikost písma v dalších komponentách,
 popiskách a tlačítkách.
---------------------------------------------------------------------
6.4 yudit.background

 Barva pozadí oken Yuditu.
---------------------------------------------------------------------
6.5 yudit.label.foreground

 Barva popředí oken vzhledu popisků.
---------------------------------------------------------------------
6.6 yudit.title.foreground

 Barva popředí oken vzhledu titulků.
---------------------------------------------------------------------
6.7 yudit.editor.background

 Barva pozadí editační oblasti.
---------------------------------------------------------------------
6.8 yudit.editor.left.foreground

 Barva popředí textu zleva-doprava v okně editoru.
---------------------------------------------------------------------
6.9 yudit.editor.right.foreground

 Barva popředí textu zprava-doleva v okně editoru.
---------------------------------------------------------------------
6.10 yudit.editor.caret.left.foreground

 Barva kurzoru zleva-doprava v okně editoru.

---------------------------------------------------------------------
6.11 yudit.editor.caret.right.foreground
 Barva kurzoru zprava-doleva v okně editoru.

---------------------------------------------------------------------
6.12 yudit.editor.showbreak

 Booleovská hodnota. Akceptované hodnoty: true nebo false.
 Je-li nastavena true, yudit bude vzhledově indikovat znaky konce řádky.

---------------------------------------------------------------------
6.13 yudit.editor.wordwrap

 Booleovská hodnota. Akceptované hodnoty: true nebo false.
 Je-li nastavena true, yudit bude jednoduchým algoritmem lámat slova.

---------------------------------------------------------------------
6.14 yudit.editor.syntax

 Řetězec. Nyní jsou podporovány pouze tyto hodnoty:
   none - žádné zvýrazňování
   simple - čísla: oranžová, oddělovač: modrá
---------------------------------------------------------------------
6.15 yudit.command.background

 Barva pozadí příkazové oblasti.
---------------------------------------------------------------------
6.16 yudit.command.left.foreground

 Barva popředí textu zleva-doprava v příkazové oblasti.

---------------------------------------------------------------------
6.17 yudit.command.right.foreground=yellow

 Barva popředí textu zprava-doleva v příkazové oblasti.
---------------------------------------------------------------------
6.18 yudit.command.caret.left.foreground

 Barva kurzoru zleva-doprava v příkazové oblasti.

---------------------------------------------------------------------
6.19 yudit.command.caret.right.foreground

 Barva kurzoru zprava-doleva v příkazové oblasti.
---------------------------------------------------------------------
6.20 yudit.command.font

 Řetězec. Virtuální písmo v příkazové oblasti.

---------------------------------------------------------------------
6.21 yudit.command.fontsize

 Řetězec. Velikost písma v příkazové oblasti.

---------------------------------------------------------------------
6.22 yudit.slider.background
 Barva posuvníku.

=====================================================================
7 Konfigurační parametry přepisované Yuditem

Následující parametry jsou aktualizovány yuditem, pokud existují.

---------------------------------------------------------------------
7.1 yudit.editor.input

 Řetězec. Poslední použitá vstupní metoda, než byl editor ukončen.
 Viz yudit.editor.inputs.

---------------------------------------------------------------------
7.2 yudit.editor.font

 Řetězec. Virtuální písmo, které bylo naposledy použito před ukončením editoru.
 Viz yudit.editor.fonts.

---------------------------------------------------------------------
7.3 yudit.editor.fontsize

 Řetězec. Velikost písma, která byla naposledy použita před ukončením editoru.
 Viz yudit.editor.fontsizes.
