(c)2004, 2005 Peter 'Roxton' Semiletov
Oficiální stránky TEA: http://tea.linux.kiev.ua
TEA je licencována jako GPL.

# TEA MANUÁL

Tibi et igni

# Obsah

Nezbytný úvod
Rozhraní
Menu
Soubor
Souborový manažer Kwas
Úpravy
Hledat
Značky
Značky > HTML nástroje
Funkce
IDE
Pro [hlížeč]
Nav [igace]//dočtete se i o editaci SRT titulků!
Nástroje
Zobrazit
Jak pracuje TEA s různými znakovými sadami
Nastavení
Možnosti příkazového řádku
O mně

# Nezbytný úvod

Na podzim roku 2000 jsem začal vyvíjet textový editor (pro Windows), který se jmenoval TEA (něco jako "Text Editing and Authoring program"). Byl populární v postsovětských zemích (Ukrajina, Rusko, Bělorusko a další) a do roku 2004 jsem vytvořil 11 verzí. Pak jsem vývoj "TEA pro Windows" ukončil za začal pracovat na "TEA pro Linux". Je to můj první linuxový program a můj vůbec první program psaný v C :) Nejsem jenom programátor. Jsem spisovatel a novinář a tak potřebuji textový editor, který mi bude vyhovovat. A tak se snažím takový napsat.

Pokud máte jakékoli dotazy, nápady, návrhy nebo záplaty, napište mi na roxton@ua.fm.

Prosím, přečtěte si celý tento manuál, protože v jistých ohledech je TEA velice nestandardní.

♫ současná muzika: Nirvana - I Hate Myself And I Want To Die

# Rozhraní

Několik slov k rozhraní. Pozor, prosím! Naše letadlo je bezpečné, jenom trochu neobvyklé.
Tady je rozložení ovládacích prvků TEA odshora dolu:

1. Window bar (sic!).
2. Menu. //hmm, opravdové menu...
3. Oblast textových karet.
4. Textové pole zvané "log_memo" pro informační výstup.
5. Textový vstupní řádek (Nazývám jej "the famous text entry") pro různé hodnoty jako např. text pro vyhledání, tagy pro ohrazení výběru, atd. Tlačítko "Spustit" provádí stejnou funkci jako stisk klávesy ENTER v textovém vstupním řádku.
6. Stavový řádek, pěkný a široký. Stojí za pozornost!

O drag and drop. Když dropnete nějaký textový soubor[y] do okna TEA, tak se tento soubor[y] otevře v editoru. Pokud je tím souborem obrázek, vloží se do otevřeného dokumentu jako IMG tag. Funguje to s Konquerorem, Gqview atd. Pokud použijete drag and drop, TEA předpokládá, že soubor bude v kódování, které je zvoleno v Nastavení > Kódování > Výchozí znaková stránka pro otevírání souborů.

♫ současná muzika: Scorn - Logghi Barogghi - Weakener

# Menu

## Soubor

Nový - vytvoří nový prázdný dokument v kódování UTF-8.

Nový Kwas - otevře nové okno Kwas. Detaily

Crapbook - Crapbook je jednoduše textový soubor uložený v $HOME/.tea/crapbook.txt. Můžete ho zavolat stisknutím kombinace kláves Alt-M. TEA ukládá tento soubor automaticky při ukončení programu TEA nebo při uzavření samotného souboru crapbook.txt. Myslím si, že je to užitečné při psaní poznámek, citátů atp.

Přidat do... > Přidat do záložek - přidá nový záznam do seznamu Záložek. Každý záznam obsahuje název souboru, znakovou sadu a informaci o pozici. Pro úpravu souboru záložek (což je jednoduchý textový soubor se seznamem položek) přejděte na Soubor > Spravovat konfigurační soubory > Soubor záložek.

Přidat do... > Přidat do seznamu automatického uložení - přidá současný soubor do speciálního seznamu souborů. Tyto soubory jsou automaticky ukládány při jejich uzavření. Pro úpravu souboru se seznamem přejděte na Soubor > Spravovat konfigurační soubory > Seznam automatického uložení.

Tato vlastnost je užitečná, pokud chcete používat nějaké soubory jako sklad různých informací. Můžete třeba vytvořit zástupce v KDE, který spustí "tea ~/my_links.txt", a dát tento my_links.txt do seznamu automatického uložení.

Otevřít - otevře soubor[y]. V dialogovém okně je možnost výběru znakové sady. Vyberte správné kódování, jinak se opravdu pobavíte. Detailní informace o tom, jak TEA zachází s různými znakovými sadami se dočtete tady.

Při otevírání více souborů musí být tyto soubory stejné kódování (vybranou znakovou stránku), nebo se stane průšvih. Nemůžu říct nic o povaze toho hypotetického průšvihu, ale byli jste varováni.

TEA používá dialog pro otevírání souborů uvedený v GTK+ 2.4. Podporuje některé klávesové zkratky pro různé akce:

Otevřít umístění - CTRL-L
Otevřít rodiče - ALT-Up
Adresář dolů - ALT-Down
Přejít domů - ALT-Home

O RTF souborech.
Ano, TEA je umí OTEVŘÍT. Neumí je ukládat. Pro správné otevření RTF souboru můžete definovat výchozí kódování RTF dokumentů. To provedete v Nastavení > Kódování > Výchozí znaková sada pro RTF. Pokud jste anglicky mluvící uživatel, potom vás toto nastavení moc neovlivní.

Jiná otázka je jak TEA otevírá RTF soubory :) Zvláštně, ale funguje to. Pokud chcete pouze rychle číst RTF, použijte TEA. Pokud je ale chcete upravovat, použijte OOO, nebo KWord, nebo AbiWord, nebo cokoli jiného.

Otevřít jiné - z tohoto menu můžete rychle otevřít ústřižky, sezení a šablony pro úpravu.

Šablony - z tohoto menu jsou dostupné uživatelské šablony. Všechny šablony jsou uloženy v $HOME/.tea/templates. Pro uložení souboru jako šablony použijte Uložit jiné > Uložit jako šablonu.

Sezení - inspirováno prohlížečem Opera - můžete uložit seznam souborů a pak tyto soubory znovu otevřít. Existuje i jedna položka v menu - Otevřít jiné > Otevřít soubor sezení - která otevře soubor sezení v TEA jako normální textový soubor bez načtení seznamu souborů.
TEA ukládá do sezení 3 položky pro každý soubor - název souboru, kódování a pozici kurzoru.

Pro uložení souborů jako sezení, použijte Uložit jiné > Uložit sezení.

♫ současná muzika: Yab Yum - Dead Moon Ritual (Source Mutation Mix)

Uložit jiné > Záloha - TEA vytváří kopii právě uloženého souboru, nikoli právě editovaného textu.

Uložit - asi víte, co? Jenom poznámka - dokument bude uložen ve stejném kódování, v jakém jste jej otevřeli.

Uložit jako - mimochodem, v tomto dialogu můžete vybrat ze seznamu dostupných kódování. Pokud chcete převést svůj soubor do jiné znakové sady, použijte tento způsob. Všimněte si, že menu Co nabízí pouze znovu-načtení souboru s vybraným kódováním, nikoli pro jeho konverzi.

Uložit jiné > Uložit jako šablonu - uloží současný soubor jako šablonu do výchozího adresáře šablon: $HOME/.tea/templates.

Uložit jiné > Uložit verzi - uloží kopii současného dokumentu pod názvem založeným na původním názvu souboru, současném datu a čase.

Spravovat konfigurační soubory - odsud můžete přímo otevřít všechny konfigurační soubory programu TEA (uložené v $HOME/.tea/). Změny se použijí po úpravě a uložení. Nedoporučuji vám upravovat soubor Hlavní konfigurace, protože TEA má na tuto konfiguraci nástroj - Nastavení. Ovšem, dělejte si, co chcete.

Spravovat konfigurační soubory > Soubor automatického nahrazení slov - tady můžete otevřít soubor se seznamem slov pro automatické nahrazení (což můžete zapnout v Nastavení > Spoluautor > Automatické nahrazení). Tento soubor obsahuje řádky ve velice jednoduchém formátu: string1=string2.
Například:

Linux=GNU/Linux
sxe=straight edge
FSOL=Future Sound Of London
hl=highlighting

Po uložení tohoto souboru bude vnitřní seznam auto-nahrazení aktualizován. Pro použití této funkce zapněte automatické nahrazení a začněte psát text. Při psaní krátkého ekvivalentu budou všechna slova ze seznamu budou nahrazena/expandována. Potom stiskněte buď mezerník, nebo jakoukoli interpunkční klávesu. Automatické nahrazení rozlišuje velikost písmen.

Spravovat konfigurační soubory > Konfigurace zkratek - použitím tohoto souboru můžete přiřadit klávesovou zkratku pro jakoukoli položku menu. Všechny zkratky jsou uloženy v souboru $HOME/.tea/tea_hotkeys. Tento soubor musí obsahovat pouze a jenom data v kódování UTF-8. Všechny změny budou použity po uložení tohoto souboru. Pokud se nová zkratka pro položku menu kryje s nějakou starší, budou změny použity po restartu TEA. Předdefinované zkratky se nedají změnit.

Každý řádek tea_hotkeys má jednoduchý formát:
popis položky menu=zkratka
Například:

Obrátit=Alt Shift R
Číst úplný manuál=F1

Poznámky: v popisech položek se rozlišuje velikost písmen. Proto je musíte napsat přesně tak, jak jsou zapsány v menu TEA. Naopak ve zkratce se nerozlišuje velikost a tak můžete zapsat třeba: "shift ctrl F5". Dostupné modifikátory jsou : Alt, Ctrl, Shift. Oddělují se mezerami.

Zkratku můžete přiřadit jakékoli položce menu, dokonce i pro dynamicky vytvářené (např. záložky).

## Kwas

Kwas je navržen jako náhrada standardního dialogu "Otevřít soubor", proto od tohoto souborového manažeru nečekejte mnoho. Můžete jej otevřít v několika oknech, můžete procházet adresáře, můžete otevírat souboru v požadovaném kódování a také můžete prohlížet obrázky. V budoucnu rozšířím jeho možnosti, ale prozatím je to vše.

Pro adresu v Kwas můžete použít textové vstupní pole. Napište do něj cestu a stiskněte klávesu Enter. Backspace v seznamu souborů otevře nadřazený adresář.

Kwas má svoje menu. Z menu Akce můžete:

Obnovit Kwas - aktualizuje seznam souborů. Kwas toto automaticky neumí.

Přidat adresář k záložkám - přidá současný adresář do menu Záložky v okně Kwas. Pro úpravu záložek přejděte do hlavního menu TEA, Soubor > Spravovat konfigurační soubory > Konfigurace záložek Kwas. V případě vymazání záložky bude menu aktualizováno při vytvoření nového okna Kwas.

Získat info o souboru - získá informace o současném (vybraném) souboru. Výstup bude v okně log memo. TEA používá standardní utilitu file.

Spustit s... - spustí současný (ano, vybraný) soubor v požadovaném programu. Napište příkaz do FAMOUS TEXT ENTRY. Příkazem musí být pouze název programu, tedy jenom opera nebo xmms.

♫ současná muzika: Scorn - Anamnesis - Rarities 1994-1997 - Maker Of Angels

Nabízí se i menu Vložit do editoru:

Vložit obrázek - vloží vybraný (aktivní) soubor s obrázkem jako IMG tag do současného textového dokumentu.

Vložit odkaz - vloží vybraný (aktivní) soubor jako HREF tag do současného textového dokumentu.

## Úpravy

Odsadit/Zrušit odsazení - přesouvá text doprava či doleva o jeden znak tabulátoru, nebo o několik mezer (podívejte se na Nastavení, Editor). Pro odsazení můžete použít i klávesu TAB. Obě funkce pracují buď s jedním nebo více řádky.

Připojit ke Crapbooku - přidá výběr do Crapbooku. Není podstatné jestli je Crapbook otevřený nebo ne, tato funkce funguje pořád.

Swop - přehodí vybraný text s obsahem schránky. Tedy, vybraný text se přesune do schránky a současně se původní obsah schránky přesune na místo výběru.

Kopírovat vše - kopíruje celý text do schránky.

Kopírovat současnou URL - před použitím této funkce musíte nastavit kurzor na URL v textu.

## Hledat

Samozřejmě, že můžete. TEA může dokonce najít tu nejmenší hvězdičku na nebi - stačí mu jen předhodit text do FAMOUS textového vstupního pole. Žádný dialog, žádná tlačítka OK/Zrušit a další tradiční postupy. Proč? Proto :)
Jednoduše napište text, který chcete najít a stiskněte Enter nebo CTRL-F. K nalezení dalšího výskytu stiskněte F3.
Ve všech případech začíná hledání od současné pozice kurzoru.

Najít/Najít další - co k tomu dodat.

Pokud chcete tradičnější nástroj k vyhledávání, můžete použít Okno Hledat a Nahradit. Má daleko od ideálního stavu, ale je jakž-takž použitelné.

Jít na řádek - napište číslo řádku na FAMOUS textového vstupního pole a použijte tuto funkci.

Nahradit vše - a teď něco naprosto odlišného - "and now for something completely different" (c)Monty Python's Flying Circus.
Znovu se pracuje s FAMOUS textovým vstupním polem. Teď ovšem ve speciálním formátu:
text k nalezení~text k nahrazení
Například:

hell~heck

Skenovat místní odkazy - najde v dokumentu href odkazy na místní soubory a přidá je (pokud jsou) do menu Nav > Odkazy, ze kterého můžete textové soubory otevřít v TEA a obrázky ve vestavěném, nebo externím prohlížeči (stejně jako Otevřít na kurzoru).

Skenovat SRC's - podobné jako Skenovat místní odkazy, ale teď vyplní menu Nav > Odkazy všemi místními SRC položkami - ve většině případů obrázky. To je velmi užitečné pokud chcete vidět banner nebo nějaký další obrázek a nechcete ho hledat v kódu.

## Značky > HTML nástroje

Document weight - spočítá celkovou váhu dokumentu včetně všech SRC položek (tedy obrázků, flash animací atd.). Pro výsledek se podívejte do log memo okna.

Vytvořit tabulku - Nesnáším jakékoli průvodce, ale vždycky jsem snil o nástroji na rychlé vytvoření prázdných tabulek. A udělal jsem ho. Opět použijeme FAMOUS textové vstupní pole. Je to velice jednoduché. Napište jen:
počet řádků~počet sloupců
A použijte tuto funkci...
Chceme například vytvořit tabulku 2x4 - 2 řádky se 4 buňkami v každém řádku. Naše šablona bude vypadat takto:

2~4

Máte to? A teď něco naprosto odlišného.

Zabudované šablony - vloží pevnou HTML šablonu do dokumentu.

Uzavřít vybraný odkaz do tagu - přesně to dělá. Pokud chcete uzavřít www.foo.bar nebo ftp.foo.bar, nebo mailto:foo@bar.com do "a href"-tagu, použijete tuto funkci a budete šťastní ;) .

Odstranit tagy - odstraní všechny tagy z HTML dokumentu.

Převést tagy na entity - pokud chcete ukázat nějaký HTML kód ve vašem HTML dokumentu, vyberte kus kódu a použijte tuto funkci. Výstup bude například:

&lt;b&gt;demo&lt;/b&gt;

## Značky > Další

Některé z níže popsaných funkcí fungují dvoucestně - pokud není vybraný text, bude vložen pár tagů, jinak se vybraný text uzavře do tagů.

Komentář - uzavře výběr do komentáře. Funguje se soubory HTML, CSS, Pascalem a C/C++, podle pravidel jejich syntaxe.

Barva - otevře dialog pro výběr barvy. Pokud není vybraný text, potom se na pozici kurzoru vloží HTML barva, pokud je text vybrán, uzavře se do tagu SPAN s CSS vlastností barvy.

Obrázek - otevře dialog pro otevření souboru. Můžete vybrat obrázek[ky], které se vloží jako img tagy (s vyplněnými atributy height a width) do současného dokumentu. Podporované jsou všechny typy obrázků, kterým GTK+ 2 obvykle rozumí - PNG, JPEG, GIF, WBMP atd.

## Funkce

Kontrola pravopisu - TEA používá pro kontrolu pravopisu Aspell. V tomto menu najdete seznam slovníků instalovaných s aspell. Funguje s celým textem, nikoli jenom s výběrem.

Pravděpodobně chybná slova budou označena barvou, kterou specifikujete v Nastavení > Barvy.

TEA umí jenom zobrazit chyby. Opravit je musíte ručně. Když opravíte chybu, bude opravené slovo zbarveno jako předtím. To je kvůli povaze TEA - aktualizuje se manuálně, proto musíte použít kontrolu pravopisu znova. Pokud chcete vypnout zobrazení chyb, použijte Zobrazit > Skrýt zvýrazňování.

Statistika dokumentu - vypíše statistiku celého či vybraného textu do log memo.

UNIverzální Textový AnalyZér.

Co je UNITAZ? Je to nástroj pro analýzu textu. Umí zobrazit seznam slov ze současného dokumentu a zobrazit počet jednotlivých slov. Zavolat UNITAZ s tříděním abc - provede analýzu a potom seřadí seznam slov, Zavolat UNITAZ - provede analýzu bez řazení. Zavolat UNITAZ s tříděním podle počtu - to samé, jenom s řazením podle počtu slov.

Extrahovat slova - extrahuje všechna slova ze současného dokumentu. To je užitečné v případě, ze chcete vytvořit třeba nějaký druh slovníku. Varování! Všechny tyto funkce jsou relativně pomalé, buďte trpěliví a nemyslete se, že TEA zamrzl.

UNITAZ také zobrazuje kolik slov je celkem a množství unikátních slov - počet slov BEZ opakování těchto slov.

K použití funkcí pro zpracování textu musíte nějaký text vybrat.

Uživatelské menu - v TEA můžete vytvořit své vlastní menu pro spouštění programů nebo pro spuštění současného souboru s těmito programy. K úpravě uživatelského menu přejděte do Soubor > Spravovat konfigurační soubory > Konfigurace uživatelského menu. Otevře se soubor s konfigurací uživatelského menu. Upravte jej a uložte. Menu se aktualizuje. Formát tohoto souboru je jednoduchý. Je to seznam s něčím jako:

Opera=opera %s &
Kwrite=kwrite %s &

Takže, jak vidíte, "%s"-makro znamená název současného souboru. Pokud chcete spustit program jako proces v pozadí, musíte přidat znak & na konec řádku.

Ústřižky.
Ústřižek je kousek kódu, který můžete vložit do textu. TEA ukládá každý ústřižek jako soubor v adresáři $HOME/.tea/snippets. Název souboru s ústřižkem je zároveň položkou menu Ústřižky, neboli, obsah menu Ústřižky je seznamem souborů v adresáři $HOME/.tea/snippets. Pro vytvoření ústřižku musíte:

1. Napsat text.
2. Soubor > Uložit jiné > Uložit jako ústřižek. Pouze UTF-8!
3. Užijte si to :)

Můžete také vytvořit ústřižek, který nějak pracuje s výběrem textu. Například, chcete vytvořit ústřižek, který uzavře vybraný text do nějakého HTML tagu. Makro "%s" reprezentuje vybraný text. Tady je příklad takového ústřižku:

<a href="%s">%s</a>

Pokud se takový ústřižek použije, %s bude nahrazeno vybraným textem. Pokud není vybraný text, vloží se do dokumentu obsah ústřižku.

Formát > Odstranit formátování - odstraní formátování (tabulátory, nové řádky, jednoduché mezery atd.)

Formát > Zalomit na pozici - zalomí řádek na pozici, kterou specifikujete ve FAMOUS.

Formát > Zalomit na mezerách v pozici - zalomí řádek na pozici, kterou specifikujete ve FAMOUS, ovšem zachová rozdělování slov.

Vložit > Dumpnout menu - zapíše všechny položky menu do nového souboru. To je užitečné, pokud chcete přidat nějaký záznam do konfigurace zkratek.

Vložit > Datum/Čas - vloží datum/čas ve specifikovaném formátu. Formát musíte definovat v Nastavení > Funkce > Formát data a času

A quote from Edition 0.10, last updated 2001-07-06, of The GNU C Library Reference Manual, for Version 2.2.x of the GNU C Library (the quoted text is edited, to make it short, by Roxton):

%a - The abbreviated weekday name according to the current locale.
%A - The full weekday name according to the current locale.
%b - The abbreviated month name according to the current locale.
%B - The full month name according to the current locale.
%c - The preferred calendar time representation for the current locale.
%C - The century of the year. This is equivalent to the greatest integer not greater than the year divided by 100.
%d - The day of the month as a decimal number (range 01 through 31).
%D - The date using the format %m/%d/%y.
%e - The day of the month like with %d, but padded with blank (range 1 through 31).
%F - The date using the format %Y-%m-%d. This is the form specified in the ISO 8601 standard and is the preferred form for all uses.
%g - The year corresponding to the ISO week number, but without the century (range 00 through 99). This has the same format and value as %y, except that if the ISO week number (see %V) belongs to the previous or next year, that year is used instead.
%G - The year corresponding to the ISO week number. This has the same format and value as %Y, except that if the ISO week number (see %V) belongs to the previous or next year, that year is used instead.
%h - The abbreviated month name according to the current locale. The action is the same as for %b.
%H - The hour as a decimal number, using a 24-hour clock (range 00 through 23).
%I - The hour as a decimal number, using a 12-hour clock (range 01 through 12).
%j - The day of the year as a decimal number (range 001 through 366).
%k - The hour as a decimal number, using a 24-hour clock like %H, but padded with blank (range 0 through 23). This format is a GNU extension.
%l - The hour as a decimal number, using a 12-hour clock like %I, but padded with blank (range 1 through 12). This format is a GNU extension.
%m - The month as a decimal number (range 01 through 12).
%M - The minute as a decimal number (range 00 through 59).
%n - A single \n (newline) character.
%p - Either AM or PM, according to the given time value; or the corresponding strings for the current locale. Noon is treated as PM and midnight as AM.
%P - Either am or pm, according to the given time value; or the corresponding strings for the current locale, printed in lowercase characters. Noon is treated as pm and midnight as am.
%r - The complete calendar time using the AM/PM format of the current locale.
%R - The hour and minute in decimal numbers using the format %H:%M.
%s - The number of seconds since the epoch, i.e., since 1970-01-01 00:00:00 UTC. Leap seconds are not counted unless leap second support is available. This format is a GNU extension.
%S - The seconds as a decimal number (range 00 through 60).
%t - A single \t (tabulator) character.
%T - The time of day using decimal numbers using the format %H:%M:%S.
%u - The day of the week as a decimal number (range 1 through 7), Monday being 1.
%U - The week number of the current year as a decimal number (range 00 through 53), starting with the first Sunday as the first day of the first week. Days preceding the first Sunday in the year are considered to be in week 00.
%V - The ISO 8601:1988 week number as a decimal number (range 01 through 53). ISO weeks start with Monday and end with Sunday. Week 01 of a year is the first week which has the majority of its days in that year; this is equivalent to the week containing the year's first Thursday, and it is also equivalent to the week containing January 4. Week 01 of a year can contain days from the previous year. The week before week 01 of a year is the last week (52 or 53) of the previous year even if it contains days from the new year.
%w - The day of the week as a decimal number (range 0 through 6), Sunday being 0.
%W - The week number of the current year as a decimal number (range 00 through 53), starting with the first Monday as the first day of the first week. All days preceding the first Monday in the year are considered to be in week 00.
%x - The preferred date representation for the current locale.
%X - The preferred time of day representation for the current locale.
%y - The year without a century as a decimal number (range 00 through 99). This is equivalent to the year modulo 100.
%Y - The year as a decimal number, using the Gregorian calendar. Years before the year 1 are numbered 0, -1, and so on.
%z - RFC 822/ISO 8601:1988 style numeric time zone (e.g., -0600 or +0100), or nothing if no time zone is determinable.A full RFC 822 timestamp is generated by the format "%a, %d %b %Y %H:%M:%S %z" (or the equivalent "%a, %d %b %Y %T %z").
%Z - The time zone abbreviation (empty if the time zone can't be determined).
%% - A literal % character.

Jako výchozí používá TEA formátovací řetězec "%d/%m/%Y %T", takže
date_time=%d/%m/%Y %T

Velikost > VELKÝMI/malými - provede akci s vybraným textem, nebo slovem pod kurzorem.

Čísla > Arabské na římské - například z 1977 bude MCMLXXVII.

Čísla > Počítadlo - generuje seznam čísel. Formát musíte definovat ve FAMOUS textovém vstupním poli. Formát je:
startovní_hodnota~koncová_hodnota~[krok]
Například:

1~10~5

A jako výsledek dostaneme:

5
10
15
20
25
30
35
40
45
50

Mimochodem, výchozí hodnota pro "krok" = 1

Řetězec > Očíslovat řádky.
Očísluje vybrané řádky. Formát číslování musíte specifikovat ve FAMOUS poli. Formát je trochu podivný:
printf-formátovací řetězec~krok počítadla~počáteční hodnota počítadla
Poslední dva parametry jsou nepovinné a jako výchozí jsou nastaveny na 1. Pro příklad si uvedeme seznam názvů kapel:

Nirvana
Scorn
Napalm Death
Defecation
Neck
JR Ewing
Fall
Meathook Seed
The Doors
Led Zeppelin

Teď chcete přidat číslování v uživatelském formátu. TEA do provede za vás. Napíšete formátovací řetězec do FAMOUS. Formát řetězce vychází z printf, můžete tedy použít dvě makra - %d pro počítadlo a %s pro řetězec.

Příklady formátovacího řetězce:

%d.)%s
%d.)%s~10
%d.)%s~10~4<

Druhý řádek reprezentuje formátovací řetězec s parametrem krok. 10 je hodnota kroku. Třetí řádek formátovací řetězec s krokem a počáteční hodnotou počítadla. 10 je krok a 4 je počáteční hodnota.

%d můžete použít i po %s, takže "%s (%d)" zobrazí výsledek:

Nirvana (1)
Scorn (2)
Napalm Death (3)
Defecation (4)
Neck (5)
JR Ewing (6)
Fall (7)
Meathook Seed (8)
The Doors (9)
Led Zeppelin (10)

Řetězec > Převést tabulátory na mezery.
Ujistěte se, že jste před použitím funkce napsali šířku tabulátoru do FAMOUS. Hodnota šířky tabulátoru je počet znaků na tabulátor.

Řetězec > Převést mezery na tabulátory.
Obsah FAMOUS se rovná počtu mezer, které se mají najít a nahradit tabulátorem.

Řetězec > Obrátit - obrátí text. Například, co bylo roxton, je nyní notxor.

Řetězec > Antispam e-mail - vybraný mailto odkaz se převede do pravděpodobně neviditelného formátu pro spamovací roboty, když zkonvertuje adresu do entit. Když se například podíváte do zdroje dokumentu, uvidíte tento odkaz bude vypadat jako halda odpadu. Jak doufám, tak spamovací roboti tomuto formátu nerozumí. Tento nápad jsem vybral z vydání LinuxGazette.

Řetězec > Odstranit prázdné řádky - odstraní prázdné řádky z vybraného textu. Nemyslím si, že je to podstatná funkce, ale... Možná jí někdo využije.

Řetězec > Odstranit duplikáty - odstraní duplikované řádky.

Řetězec > Obrátit pořadí řádků - lepší bude příklad:
Máme:

Řádek 1
Řádek 2
Řádek 3

Bude:

Řádek 3
Řádek 2
Řádek 1

Řetězec > Použít šablonu na každý řádek - a znova použijeme FAMOUS. Například, když chci přidat tag BR na konec každého řádku, napíšu do vstupu:

%s<br>

A potom použiji tuto funkci. Získám tag BR, který je přidán na konec každého řádku. V jiném případě chci uzavřít každý řádek mezi tagy LI. Napíšu:

<li>%s</li>

A použiji funkci. Jak jistě chápete, makro %s = text řádku. A další případ:

<a href="%s">%s</a>

Seřadit > Seřadit řádky - Seřadí řádky v abecedním pořádku.

Filtry > Odstranit řádky obsahující frázi
Vyberte text. Napište nějakou frázi do FAMOUS. Použijte tuto funkci. Všechny řádky obsahují vaší frázi budou odstraněny.

Filtry > Odstranit řádky neobsahující frázi
Vyberte text. Napište nějakou frázi do FAMOUS. Použijte tuto funkci. Všechny řádky neobsahující vaši frázi budou odstraněny.

Filtry > Odstranit všechny řádky < N znaků
Odstraní ve výběru všechny řádky kratší než N (hodnota ve FAMOUS) znaků.

Filtry > Odstranit všechny řádky > N znaků
Odstraní ve výběru všechny řádky delší než N (hodnota ve FAMOUS) znaků.

Morseovka > Kódovat do morseovky
Nejsem guru morseovky, ale doufám, že moje úsilí v implementaci této funkce bylo správné. Touto funkcí můžete přeložit anglický text do morseovky. Například:

Drum and bass

Bude:

-.. .-. ..- -- .- -. -.. -... .- ... ...

TEA vkládá mezeru mezi jednotlivé znaky morseovky a dvě mezery mezi slova.

Morseovka > Dekódovat z morseovky
Inverzní akce k předchozí funkci. Můžete dekódovat jakoukoli anglickou zprávu v morseovce. Musíte ovšem vědět, že TEA předpokládá mezeru mezi znaky a dvě mezery mezi slovy.

## IDE

Mimo jiné, TEA podporuje jakési funkce IDE (integrovaného vývojového prostředí), jako například správu projektů. TEA také může volat utilitu make a spouštět projekty.

Jak to funguje? TEA IDE projekt neobsahuje žádné soubory mimo jediného souboru projektu. Pro jeho vytvoření použijte funkci Nový projekt. Zobrazí se vám dialogové okno s položkami:

Název projektu - název vašeho projektu.
Adresář Makefile - adresář, kde má TEA hledat soubor Makefile, který volá utilita make.
Zdrojový adresář - kde máte svoje zdrojové soubory pařící do projektu?
Cílová binárka - název (bez cesty) binárního souboru. TEA předpokládá, že se tento soubor nachází ve Zdrojovém adresáři. TEA spustí cílovou binárku, když aktivujete funkci Spustit.

Vlastnosti projektu - použijte tuto položku menu v případě, že chcete změnit vlastnosti současného projektu (nezapomeňte ovšem uložit změny).

Když spustíte Make v programu TEA, zobrazí se chyby a varování k log memo. Dvouklikem na chybovou zprávu přejdete na odpovídající řádek ve zdrojovém kódu. Barvy chybových hlášení se nastavují v sekci Nastavení > Barvy > IDE.

Jako přídavek IDE funkcí můžete použít položku menu Zobrazit > Přepnout hlavička/zdroj. Toto funguje pouze tehdy, pokud je zdrojový soubor a hlavičkový soubor ve stejném adresáři. Podporovány jsou jenom C/C++ soubory.

## Pro

Toto menu je nazváno krátce z historických důvodů. TEA pro Windows měl VELIKÉ menu, kde nebylo místo na všechny položky, a proto jsem je zkrátil - z "Prohlížeč" na "Pro". Z tohoto menu můžete prohlížet současný soubor v různých prohlížečích. Pro potlačení výchozích příkazových řádků jednotlivých prohlížečů upravte údaje v Nastavení > Prohlížeče. Příklad za všechny: konqueror=konqueror %s &. %s je makro pro název současného souboru.

## Nav

Uložit pozici - uloží pozici kurzoru. Na tuto pozici se později dostanete použitím položky menu Přejít na uloženou pozici.

Náhled s Mplayerem.
Tak, jak se vlastně překládají, či upravují titulky v TEA? TEA rozpoznává pouze SRT titulky. Pro správné fungování musíte:
1. Otevřít SRT soubor jako obyčejný text.
2. "Otevřít" film z položky menu Soubor > Otevřít jiné > Otevřít film.
3. Upravit váš SRT soubor.
4. Když aktivujete Náhled s Mplayerem, TEA najde počáteční čas současné sekce titulků a spustí v Mplayeru film, který jste vybrali dialogem Otevřít film. TEA také řekne Mplayeru, aby přeskočil na místo, kde se vyskytuje současná sekce titulků (ve skutečnosti, po takovém přesunu zobrazí Mplayer další titulek po právě požadovaném, takže pro správné zobrazení vybírejte v TEA předchozí titulek. Divná věta, že ano? Ale zkuste to a budete tomu rozumět).

Odkazy - zde jsou názvy místních souborů z odkazů v současném dokumentu - získáte je použitím funkce Hledat > Skenovat místní odkazy (to jsem popsal výše). Navíc, z tohoto menu můžete přepínat mezi otevřenými dokumenty.

Jít na předchozí kartu - přepnout na poslední navštívenou kartu.

Přejít do textu/Přejít do FAMOUS - užitečné, pokud těmto funkcím přiřadíte klávesové zkratky. Přepíná mezi textem a FAMOUS textovým vstupním polem.

Jít na začátek/konec bloku - provede právě tohle :) v jazycích C nebo PHP. Přesune kurzor na začátek či konec současného bloku (znaky { a }). Myslím si, že je to užitečné.

Otevřít na kurzoru - pokud máte v HTML textu odkaz na místní soubor, můžete ho touto funkcí otevřít. Přejděte na tento odkaz a touto funkcí (má přiřazenou zkratku F2) jej otevřete. Pokud je cílovým souborem obrázek, otevře se buď ve vestavěném, nebo externím prohlížeči podle preferencí v Nastavení > Příkazy. Příkazem může být třeba display %s&. V tomto případě ovšem musíte zapnout možnost Nastavení > Přepínače > Použít externí prohlížeč obrázků.

Pokud souborem není obrázek, potom funkce Otevřít na kurzoru otevře soubor v TEA s tím kódováním, které má současný soubor. Pokud je cílový soubor již otevřen, přepne se TEA do jeho karty.

Pokud máte odkaz na nějaké místní návěstí "a name=" - potom stiskem klávesy F2 přeskočíte na místo definice tohoto návěstí.

Upravit na kurzoru - provede totéž jako předchozí funkce, s tím rozdílem, že místo prohlížeče zavolá externí editor. Tento editor nastavíte v Nastavení > Příkazy. Příkladem může být řádek: gimp %s&

## Zobrazit

Mód zvýrazňování - v tomto submenu si můžete vybrat individuální způsob zvýraznění pro současný dokument.

Skrýt zvýrazňování - skryje zvýrazňování dokumentu. Odstraní zvýrazňování syntaxe a rovněž značky kontroly chyb.

Přepnout zobrazení obrázků - zobrazí obrázky v blízkosti jejich IMG tagů přímo v textu.

Obnovit zvýrazňování - schopnosti TEA ve zvýrazňování kódu jsou slabé. S touto funkcí aktualizujete zvýrazňování.

Zalamování řádků - potřebuje vysvětlení? A proč píšu tenhle odstavec?

Čísla řádků - pořád stejná písnička...

# Nastavení

A konečně... V TEA existuje okno Soubor > Nastavení. Už nepotřebujete upravovat textové soubory. Použijte GUI, to není kacířství. Myslím, že nepotřebujete popis všech položek v tomto okně, neboť jejich názvy jsou výmluvné.

Jsou zde karty a dvě veliká tlačítka. Tlačítka jsou: Zavřít a Uložit a použít. První z nich pouze zavře dialogové okno. Druhé tlačítko provede dvě podstatné věci. Jednak uloží všechny změny do konfiguračního souboru a potom znovu načte konfiguraci. Pokud nekliknete na Použít, žádná změna se neuloží. TEA si neukládá konfiguraci při ukončení programu, to provede pouze a jenom po stisknutí tohoto tlačítka.

Tady je několik informací o kartách.

## Přepínače

Různé přepínače. Jsou zde:

Určit zvýrazňování podle obsahu - to je pro zvýrazňování syntaxe. Zapněte, pokud chcete automaticky zvýrazňovat Bash skripty, které nemají příponu .sh.

XHTML mód pro Značky - velice dobrá možnost pro funkce z menu Značky a pro funkce jako Vložit obrázek. Pokud chcete XHTML syntaxi, zapněte tuto položku.

Použít ústřižky - ústřižky fungují jenom když zapnete tuto funkci. Proč to tak je? Někdy se stane, že TEA prochází adresář z ústřižky pomalu a proto jde tato funkce dočasně vypnout.

Zobrazit čísla řádků - jestli se číslování má zobrazovat při spuštění.

Zalamování řádků - zalomit či nezalomit, to je oč tu běží - ano při spuštění.

Skenovat odkazy v při otevření souboru
Pokud je zapnuto, TEA bude skenovat místní odkazy automaticky při otevření souboru. Výchozí je vypnuto.

Zálohovat
Zatrhněte, pokud chcete, aby TEA vytvářel zálohu při uložení souboru.

## Kódování

Zde můžete zapnout autodetekci kódování a vybrat znakové sady, které chcete autodetekovat.

## Funkce

Formát funkce Barva - ovlivní výsledek funkce Značky > Barva. Použijte makro @color pro definování místa, kam se vloží barva a makro @text jako náhradu za vybraný text (tedy, kam se vloží výsledný řetězec).

## Rozhraní

Tady můžete nastavit výšku a šířku dialogu Uložit/Otevřít v procentech a také vypnout možnost zobrazení plné cesty v titulku okna. Potom bude zobrazen pouze název souboru.

## Limity

Neomezujte sebe. radši omezte TEA. Zde se nastaví třeba počet položek v seznamu nedávno otevřených souborů a mnoho dalších možností.

## Editor

Tato karta má mnoho možností - zkuste se tady neztratit. Šířka tabulátoru v mezerách - definuje výchozí šířku tabulátoru počtem mezer, takže hodnota 3 bude zhruba odpovídat 3 mezerám.

## Prohlížeče

Tady můžete změnit výchozí příkazy pro spouštění prohlížečů. Položkou Prohlížeč manuálu definujete, čím se má prohlížet manuál TEA. V součinnosti s touto možností zapněte volbu Použít tento prohlížeč.

Mimochodem, pokud není definován prohlížeč dokumentace, TEA se pokusí najít ve vašem systému jeden z těch lepších a použije ho.

## Cesty

Výchozí adresář pro ukládání souborů a Použít výchozí adresář pro ukládání souborů. Použijte tyto možnosti pro potlačení výchozích cest v dialog Uložit jako/Otevřít.

# Možnosti příkazového řádku

--crapbook - spustí TEA s otevřeným Crapbookem.

--charset=nazev_znakove_sady - nastaví znakovou sadu pro otevíraný soubor[y]. Například, pokud chceme otevřít soubor1 se znakovou sadou CP1251 a soubor2 se znakovou sadou UTF-8, napíšeme:

tea --charset=cp1251 soubor1 --charset=utf-8 soubor2

# Jak pracuje TEA s různými znakovými sadami

TEA umí zacházet ze všemi znakovými sadami, které jsou v Linuxu dostupné prostřednictvím knihovny iconv. V základu můžete použít dvě znakové sady pro operace se soubory - UTF-8 a systémovou znakovou sadu. Pro otevírání souborů navíc existuje možnost autodetekce.

Pokud zvolíte autodetekci, TEA se bude snažit určit aktuální kódování dokumentu automaticky a pokud neuspěje, budete muset vybrat správné kódování ručně. Funkce autodetekce má polymorfní povahu a je rozdělena do více než jedné podfunkce. Příklad: TEA má možnosti autodetekce a Japonské autodetekce. Pokud vyberete první možnost, musíte také vybrat znakové sady, ze kterých TEA vybírá. Všechny tyto sady jsou dostupné v sekci Nastavení > Kódování > Autodetekovat.

Takže, pokud otevíráte soubor, můžete si vybrat autodetekci znakové sady a TEA zkusí detekovat kódování vybraná v sekci "Autodetekovat".

Jiný případ je Japonská autodetekce - toto je odděleno od obvyklé funkce autodetekce kvůli odlišné implementaci.

Jak se přidají další znakové sady do seznamu dostupných kódování? Jděte do Soubor > Nastavení > Kódování, přepněte se do karty Konfigurovat znakové sady a uvidíte dva seznamy. Dostupné a Vybrané. Vyberte si znakovou sadu v seznamu Dostupné a klikněte na tlačítko Přidat. Tím přidáte znakovou sadu do seznamu Vybrané. Znakové sady ze seznamu Vybrané budou dostupné v dialogu Otevřít/Uložit soubor, v Kwas atd.

Pro odstranění položky ze seznamu Vybrané stiskněte tlačítko Odstranit. Označená položka se smaže.

TEA má menuZobrazení > Co. Z tohoto menu můžete přepínat kódování současného dokumentu. Kódování jsou stejná jako v dialogu Otevřít soubor/Uložit jako. Když přepnete kódování, znamená to, že se obsah současného souboru znovu načte s odlišným kódováním. Používejte tuto funkci opatrně, pouze v případě, že místo textu vidíte nějaké nesmysly.

# O mně

Peter 'Roxton' Semiletov (1977-20??). Dnes pracuji jako nezávislý novinář na Ukrajině a v Rusku. Vydal jsem asi 300 papírových publikací (od konce roku 2000) a myslím si, že nejsou špatné. Ano, prodávám své články, ale neobchoduji se svými romány a povídkami - všechny jsou dostupné zdarma na Síti (podívejte se na www.roxton.kiev.ua).

Věci, které mám rád: punk, rock, Nirvana, AMD CPU, ruskou klasickou literaturu, psaní, Napalm Death, Scorn, indie-filmy, vegetariánství, KDE, Led Zeppelin, Linux Mandrake, cola, Fallout, RPG, svou vlastní otřesnou hru na kytaru a zpěv, (ó, můj estetický grindcorový zpěv), Mitsumi klávesnice, Sinclairy, NES, Sega MegaDrive/Genesis, Fender mediator .88 mm M/H (takovej zelenej), Monty Python's Flying Circus, H.P. Lovecraftovu prózu, Radiohead, Musorgsky, svobodu volby, GPL, čaj, kwas, černá trika s rockovými tématy, gcc, 3dfx Voodoo 3000 (navždy), mplayer, xmms, Nokia 3100, GIMP, klasické kytary Hohner, laciné EPOX mobos, S3 Virge 4Mb, panamas, chození, staré němé filmy s Busterem Keatonem a Fatty Arbucklem, malby Hieronyma Bosche, moje vlastní realistické sny (ve kterých také vyvíjím TEA).

//poslední update roxton 22 leden 2005