Pou‘it¡ programu CSBibTeX 0.99c [3c]/0.1 CS Petr Novotn˜ (NOVOTNYP@earn.cvut.cz) Program CSBibTeX je nadstavbou programu BibTeX od Orena Patashnika. Program BibTeX slou‘¡ ke zpracov v n¡ odkaz– na literaturu v textech zpracov van˜ch syst‚mem LaTeX pomoc¡ extern¡ch datab z¡ literatury (extenze .BIB) a pomoc¡ extern¡ch stylov˜ch soubor– (extenze .BST), kter‚ mˆn¡ nap©. t©¡d¡c¡ krit‚ria, formu v˜pisu jmen autor– apod. Program CSBibTeX je proti BibTeXu roz¨¡©en o podporu osmibitov‚ho k¢dov n¡ vstupn¡ch/v˜stupn¡ch soubor– se zvl ¨tn¡m zamˆ©en¡m ka ‡e¨tinu a sloven¨tinu. Program CSBibTeX je nadstavbou BibTeXu verze 0.99 v tom smyslu, ‘e za pou‘it¡ command-line p©ep¡na‡– /noch /and /c a p©i nastaven¡ jm‚na adres ©e, v nˆm‘ se vyskytuje soubor CORK.ALP, do environment variable CSBIBALP, bude v˜stup programu CSBibTeX ekvivalentn¡ v˜stupu programu BibTeX. (Je¨tˆ to nen¡ £plnˆ p©esnˆ pravda; BibTeX toti‘ v z vislosti na implementaci ignoruje osm˜ bit vstupn¡ch znak– (ASCII k¢d 128-255 se p©ekl d  na 0-127), zat¡mco CSBibTeX tyto znaky norm lnˆ zpracov v . P©esnˆj¨¡ formulace je, ‘e p–vodn¡ BibTeX m–‘eme nahradit CSBibTeXem s uveden˜mi parametry.) Tato instalace CSBibTeXu obsahuje n sleduj¡c¡ soubory: CSBIBTEX.EXE - vlastn¡ spustiteln˜ soubor pro DOS, OS/2 real i protected mode KAMENIK.ALP CORK.ALP PCLATIN2.ALP *.ALP - k¢dovac¡ soubory, kter‚ CSBibTeX pou‘¡v  pro ‡esk‚ t©¡dˆn¡; KAMENIK.A CORK.A PCLATIN2.A *.A - "zdroj ky" k *.ALP soubor–m (nejsou pro bˆh CSBibTeXu nutn‚) MAKEALP.EXE - program pro p©evod *.A soubor– do *.ALP soubor– (nen¡ pro bˆh CSBibTeXu nutn˜) README.TXT - tento soubor Command-line syntax: csbibtex [/k|/c|/p|/f[:][=]filename] [/ch|/noch] [/and] [/pv[:][=]] ! Program vy‘aduje nastaven¡ environment promˆnn‚ CSBIBALP ! Spu¨tˆn¡ programu CSBibTeX bez jedin‚ho command-line p©¡kazu zp–sob¡ vyps n¡ zkr cen‚ho n vodu k pou‘it¡. * Parametry /k, /c, /p a /f ©¡d¡ pou‘it‚ k¢dov n¡ vstupn¡ho a v˜stupn¡ho souboru. Vzhledem k tomu, ‘e existuje nep©ebern‚ mno‘stv¡ norem, pseudonorem, konvenc¡ a pseudokonvenc¡ k¢dov n¡ ‡e¨tiny/sloven¨tiny, rozhodl jsem se, ‘e m¡sto povnˆ zvolen‚ho k¢dov n¡ bude program pou‘¡vat vnˆj¨¡ k¢dovac¡ soubor, kde si m–‘e ka‘d˜ (nebo radˆji ka‘d˜, kdo to nutnˆ pot©ebuje) definovat sv–j vlastn¡ k¢d ‡e¨tiny. Program CSBIBTEX ‡te k¢dov n¡ ze souboru s extenz¡ .ALP (ten je velmi podobn˜ svou strukturou souboru .TCP). Proto‘e je v¨ak soubor .ALP pro norm ln¡ho ‡lovˆka ne‡iteln˜, nab¡z¡ se mo‘nost zapsat k¢dov n¡ v ‡iteln‚ podobˆ a pak je programem MAKEALP p©ev‚st do ne‡iteln‚ podoby pro CSBibTeX srozumiteln‚. Soubor .ALP vytvo©¡me ze souboru .A p©¡kazem MAKEALP (Pozor! Program MAKEALP nen¡ user-friendly a nen¡ ur‡en norm ln¡m u‘ivatel–m; je ur‡en hlavnˆ spr vc–m syst‚mu a dal¨¡m gurus. V¨echny uveden‚ syntaxe jsou povinn‚ a nejsou programem o¨et©en‚, tak‘e nedodr‘en¡ m–‘e generovat zd nlivˆ nesmysln‚ chyby. Doporu‡oval bych v¨em u‘ivatel–m, aby svoje po‘adavky na vytvo©en¡ .ALP soubor– adresovali mnˆ na e-mail adresu NOVOTNYP@earn.cvut.cz nebo na adresu CSTUGu.) Oba n zvy soubor– mus¡ b˜t uvedeny i s extenz¡. Format .A souboru je povinn˜: Koment ©ov‚ © dky se uvozuj¡ (p©ekvapivˆ) znakem %. Na rozd¡l od TeXu v¨ak znak % mus¡ b˜t uz v prvn¡m sloupci. Vlastn¡ data uveden  v souboru .A maj¡ formu dvou sloupc–, ka‘d˜ ¨¡©ky 3 znaky, mezi nimi jedna mezera nav¡c. V prvn¡m sloupci musi byt naps na (v¨echna) ‡¡sla 0..255 v p©irozen‚m po©ad¡ (0,1,2,...,254,255). Tato ‡¡sla p©edstavuj¡ k¢dy jednotliv˜ch znak– podle horn¡ tabulky DC font– (k¢dov n¡ Cork, viz soubor CORK.LST). V druh‚m sloupci pak jsou uvedeny odpov¡daj¡c¡ ekvivalenty tˆchto p¡smen v definovan‚m k¢du. Tak nap©¡klad © dek 131 128 ze souboru KAMENIK.A znamen , ‘e znak € (Cork k¢d 131) m  v definovan‚m k¢du (Kamenick˜ch) k¢d 128. Speci lnˆ k¢dov n¡ CORK.A bude obsahovat v prvn¡m a druh‚m sloupci stejn  ‡¡sla. Parametr /f ( mus¡ b˜t uvedeno s extenz¡ .ALP) ur‡uje jm‚no .ALP souboru. —pln  cesta .ALP souboru je pak d na adres ©em uveden˜m v environment variable CSBIBALP a jm‚nem souboru. P©eddefinovan‚ n zvy .ALP soubor– jsou CORK.ALP (pro parametr /c), KAMENIK.ALP (parametr /k) a PCLATIN2.ALP (/p). To tedy znamen , ‘e nap©¡klad parametr /c je ekvivalentn¡ s parametrem /f=CORK.ALP. Default volba je CORK.ALP (/c). * Vzhledem k tomu, ‘e ‡e¨tina a sloven¨tina obsahuj¡ speci ln¡ hl sku (‡i dvouhl sku) "ch", kter  se ©ad¡ nˆkam mezi "h" a "i", zat¡mco standardn¡ (anglick‚) ©azen¡ je pod "c", dodal jsem CSBibTeXu volbu /ch ‡i /noch. Volba /ch zajist¡ zpracov n¡ "ch" jako jedn‚ hl sky (‡e¨tina/sloven¨tina); volba /noch naopak zajist¡ zpracov n¡ "ch" jako dvou hl sek "c" a "h" (angli‡tina). Default volba je /ch. * BibTeX (i CSBibTeX) jsou schopny rozpoznat a speci ln¡m zp–sobem zpracov vat "and" ‡i ‡esk˜ ekvivalent "a" (spojka sou©ad¡c¡ oddˆluj¡c¡ dva spoluautory). Podrobnˆji viz dokumentace k BibTeXu. CSBibTeX defaultovˆ pova‘uje "a" za oddˆlen¡ jmen autor–. Volba /and zp–sob¡, ‘e "a" ji‘ neoddˆluje jm‚na autor– a m¡sto nˆj je hled no "and". * Parametr /pv= m  stejn˜ v˜znam jako envirnment promˆnn  EMTEXDRV v n sleduj¡c¡m smyslu: Je-li na command-line nastaveno /pv, je pou‘ita tato hodnota. Nen¡-li /pv nastaveno, je pou‘ita hodnota promˆnn‚ EMTEXDRV. Nen¡-li nastavena ani jedna z tˆchto hodnot, je pou‘ita hodnota 'C'. * je jm‚no zpracov van‚ho souboru. Spolupr ce CSBibTeXu s LaTeXem: Prvn¡m spu¨tˆn¡m LaTeXu je vytvo©en .AUX soubor, kter˜ obsahuje odkazy na literaturu. Tento soubor je zpracov n CSBibTeXem, kter˜ ‡te soubory .AUX, .BIB a .BST a vytvo©¡ soubory .BBL (vlastn¡ citace) a .BLG (logfile). Druh˜m spu¨tˆn¡m LaTeXu je .BBL soubor zpracov n a informace z nˆj p©eps ny i do .AUX souboru. T©et¡m spu¨tˆn¡m LaTeXu jsou pak do©e¨eny i cross-reference (\cite p©¡kazy). Pros¡m o zasl n¡ jak˜chkoliv p©ipom¡nek, dotaz– ‡i po‘adavk– pro dal¨¡ revizi CSBibTeXu. Petr Novotn˜ 23.1.1994 NOVOTNYP@CSEARN.bitnet (preferred) NOVOTNYP@troja.fjfi.cvut.cz (pro vˆt¨¡ soubory ‡i UUENCODEd po¨ty)