Yudit: HOWTO-configure.txt ===================================================================== Verze: 2.2 Autor: Gaspar Sinai 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: /share/yudit/config/yudit-properties, kde 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 '\', 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 /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 /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.. 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. 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 .my, lze mu přiřadit volitelný parametr: yudit.font.:něc.ttf: 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 /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 /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, /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 . 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 /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 /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.