                  Pouit 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 zpracovvn odkaz na literaturu v textech zpracovvanch
systmem LaTeX pomoc externch databz literatury (extenze .BIB) a pomoc
externch stylovch soubor (extenze .BST), kter mn nap. tdc kritria,
formu vpisu jmen autor apod. Program CSBibTeX je proti BibTeXu rozen o
podporu osmibitovho kdovn vstupnch/vstupnch soubor se zvltnm
zamenm ka etinu a sloventinu.

Program CSBibTeX je nadstavbou BibTeXu verze 0.99 v tom smyslu, e za pouit
command-line pepna /noch /and /c a pi nastaven jmna adrese, v nm se
vyskytuje soubor CORK.ALP, do environment variable CSBIBALP, bude vstup
programu CSBibTeX ekvivalentn vstupu programu BibTeX. (Jet to nen pln
pesn pravda; BibTeX toti v zvislosti na implementaci ignoruje osm bit
vstupnch znak (ASCII kd 128-255 se pekld na 0-127), zatmco CSBibTeX tyto
znaky normln zpracovv. Pesnj formulace je, e pvodn BibTeX meme
nahradit CSBibTeXem s uvedenmi parametry.)

Tato instalace CSBibTeXu obsahuje nsledujc soubory:

CSBIBTEX.EXE - vlastn spustiteln soubor pro DOS, OS/2 real i protected mode
KAMENIK.ALP CORK.ALP PCLATIN2.ALP *.ALP - kdovac soubory, kter CSBibTeX      
  pouv pro esk tdn; 

KAMENIK.A CORK.A PCLATIN2.A *.A - "zdrojky" k *.ALP souborm (nejsou pro bh   
  CSBibTeXu nutn)
MAKEALP.EXE - program pro pevod *.A soubor do *.ALP soubor (nen pro bh     
  CSBibTeXu nutn)

README.TXT - tento soubor


Command-line syntax:

csbibtex [/k|/c|/p|/f[:][=]filename] [/ch|/noch] [/and] 
                                       [/pv[:][=]<drive] [<filename>]

! Program vyaduje nastaven environment promnn CSBIBALP !

Sputn programu CSBibTeX bez jedinho command-line pkazu zpsob vypsn
zkrcenho nvodu k pouit.

* Parametry /k, /c, /p a /f<filename> d pouit kdovn vstupnho a
vstupnho souboru. Vzhledem k tomu, e existuje nepebern mnostv norem,
pseudonorem, konvenc a pseudokonvenc kdovn etiny/sloventiny, rozhodl
jsem se, e msto povn zvolenho kdovn bude program pouvat vnj kdovac
soubor, kde si me kad (nebo radji kad, kdo to nutn potebuje) definovat
svj vlastn kd etiny. Program CSBIBTEX te kdovn ze souboru s extenz
.ALP (ten je velmi podobn svou strukturou souboru .TCP). Protoe je vak soubor
.ALP pro normlnho lovka neiteln, nabz se monost zapsat kdovn v
iteln podob a pak je programem MAKEALP pevst do neiteln podoby pro
CSBibTeX srozumiteln. Soubor .ALP vytvome ze souboru .A pkazem
           MAKEALP <vstupn-soubor> <vstupn-soubor>
(Pozor! Program MAKEALP nen user-friendly a nen uren normlnm uivatelm; je
uren hlavn sprvcm systmu a dalm gurus. Vechny uveden syntaxe jsou
povinn a nejsou programem oeten, take nedodren me generovat zdnliv
nesmysln chyby. Doporuoval bych vem uivatelm, aby svoje poadavky na
vytvoen .ALP soubor adresovali mn na e-mail adresu NOVOTNYP@earn.cvut.cz
nebo na adresu CSTUGu.) Oba nzvy soubor mus bt uvedeny i s extenz. Format
.A souboru je povinn: Komentov dky se uvozuj (pekvapiv) znakem %. Na
rozdl od TeXu vak znak % mus bt uz v prvnm sloupci. Vlastn data uveden v
souboru .A maj formu dvou sloupc, kad ky 3 znaky, mezi nimi jedna mezera
navc. V prvnm sloupci musi byt napsna (vechna) sla 0..255 v pirozenm
poad (0,1,2,...,254,255). Tato sla pedstavuj kdy jednotlivch znak podle
horn tabulky DC font (kdovn Cork, viz soubor CORK.LST). V druhm sloupci
pak jsou uvedeny odpovdajc ekvivalenty tchto psmen v definovanm kdu. Tak
napklad dek
131 128
ze souboru KAMENIK.A znamen, e znak  (Cork kd 131) m v definovanm kdu
(Kamenickch) kd 128. Speciln kdovn CORK.A bude obsahovat v prvnm a
druhm sloupci stejn sla.

Parametr /f<filename> (<filename> mus bt uvedeno s extenz .ALP) uruje jmno
.ALP souboru. pln cesta .ALP souboru je pak dna adresem uvedenm v
environment variable CSBIBALP a jmnem souboru.
Peddefinovan nzvy .ALP soubor jsou CORK.ALP (pro parametr /c), KAMENIK.ALP
(parametr /k) a PCLATIN2.ALP (/p). To tedy znamen, e napklad parametr /c je
ekvivalentn s parametrem /f=CORK.ALP. Default volba je CORK.ALP (/c).

* Vzhledem k tomu, e etina a sloventina obsahuj speciln hlsku (i
dvouhlsku) "ch", kter se ad nkam mezi "h" a "i", zatmco standardn
(anglick) azen je pod "c", dodal jsem CSBibTeXu volbu /ch i /noch. Volba /ch
zajist zpracovn "ch" jako jedn hlsky (etina/sloventina); volba /noch
naopak zajist zpracovn "ch" jako dvou hlsek "c" a "h" (anglitina). Default
volba je /ch.

* BibTeX (i CSBibTeX) jsou schopny rozpoznat a specilnm zpsobem zpracovvat
"and" i esk ekvivalent "a" (spojka souadc oddlujc dva spoluautory).
Podrobnji viz dokumentace k BibTeXu. CSBibTeX defaultov povauje "a" za
oddlen jmen autor. Volba /and zpsob, e "a" ji neoddluje jmna autor a
msto nj je hledno "and".

* Parametr /pv=<drive> m stejn vznam jako envirnment promnn EMTEXDRV v
nsledujcm smyslu: Je-li na command-line nastaveno /pv, je pouita tato
hodnota. Nen-li /pv nastaveno, je pouita hodnota promnn EMTEXDRV. Nen-li
nastavena ani jedna z tchto hodnot, je pouita hodnota 'C'.

* <filename> je jmno zpracovvanho souboru.


Spoluprce CSBibTeXu s LaTeXem:

Prvnm sputnm LaTeXu je vytvoen .AUX soubor, kter obsahuje odkazy na
literaturu. Tento soubor je zpracovn CSBibTeXem, kter te soubory .AUX, .BIB a
.BST a vytvo soubory .BBL (vlastn citace) a .BLG (logfile). Druhm sputnm
LaTeXu je .BBL soubor zpracovn a informace z nj pepsny i do .AUX souboru.
Tetm sputnm LaTeXu jsou pak doeeny i cross-reference (\cite pkazy).



Prosm o zasln jakchkoliv pipomnek, dotaz i poadavk pro dal revizi
CSBibTeXu.


Petr Novotn                                                        23.1.1994
NOVOTNYP@CSEARN.bitnet (preferred)
NOVOTNYP@troja.fjfi.cvut.cz (pro vt soubory i UUENCODEd poty)


