summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/cstex/opmac-u.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/cstex/opmac-u.tex')
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u.tex129
1 files changed, 102 insertions, 27 deletions
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.tex b/Master/texmf-dist/doc/cstex/opmac-u.tex
index ec321439e99..d005632afdd 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u.tex
@@ -20,7 +20,7 @@
\tit OPmac -- rozšiřující makra plain\TeX{}u
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\centerline{\it Petr Olšák, listopad, prosinec 2012}
+\centerline{\it Petr Olšák, 2012, 2013, 2014}
\bigskip
\centerline{\url{http://petr.olsak.net/opmac.html}}
@@ -748,7 +748,11 @@ Vyskytují-li se v~argumentu "\url" znaky
"%", "\", "#", "$", "{" a "}", je třeba použít
"\%", "\\", "\#", "\$", "\{" a "\}".
Ostatní speciální znaky "~", "_", "^", "&" lze napsat do parametru "\url"
-přímo. Libovolný text odkazovaný na webovou stránku lze vložit pomocí
+přímo.
+Dále je možno do parametru "\url" napsat "\|" k označení místa, kde
+je dovoleno zlomit řádek.
+%
+Libovolný text odkazovaný na webovou stránku lze vložit pomocí
"\ulink[<URL>]{<text>}". Například odkaz na
\ulink[http://petr.olsak.net/opmac.html]{stránky OPmac} jsou vytvořeny
pomocí "\ulink[http://petr.olsak.net/opmac.html]{stránky OPmac}".
@@ -1193,39 +1197,77 @@ nahoru. Při záporné hodnotě se posune dolů. Například
\sec Bibliografické údaje
%%%%%%%%%%%%%%%%%%%%%%%%%
+{\bf Odkazy.}
Pomocí "\cite[<lejblík>]" nebo "\cite[<lejbík1>,<lejblík2>,<lejblík3>]"
-(atd.) vytvoříme v textu odkazy na položky v seznamu literatury. V seznamu
-literatury je třeba uvést záznamy, které mají odkazované lejblíky. Tyto
-záznamy dostanou v seznamu automaticky vygenerovaná čísla a sekvence "\cite"
-se pak promění na číselné odkazy, například [27] nebo [18,~24,~42] (atd.).
-Souvislé řady čísel [1,~2,~3,~5,~6] se promění v~intervaly [1--3,~5--6~]
-jen tehdy, když je v úvodní deklaraci dokumentu napsáno "\shortcitations".
-
-Seznam literatury je možné vložit do dokumentu třemi různými
+atd. vytvoříme v~textu odkazy na položky v seznamu literatury. V
+seznamu literatury je třeba uvést záznamy, které mají odkazované lejblíky.
+Tyto záznamy dostanou v seznamu automaticky vygenerovaná čísla a sekvence
+"\cite" se pak promění na číselné odkazy, například [27] nebo [18,~24,~42]
+atd. Souvislé řady čísel [1,~2,~3,~5,~6] se promění v~intervaly
+[1--3,~5--6] jen tehdy, když je v úvodní deklaraci dokumentu napsáno
+"\shortcitations". A seřadí se podle velikosti při "\sortcitations".
+
+Při "\nonumcitations" se odkazy nepřevádějí na čísla. K tomu je potřeba
+použít navazující Bib\TeX{}ový styl (např. "alpha", "apalike") nebo
+rozšířenou formu příkazu "\bib", viz níže. Odkazy vypadají při stylu
+"alpha" takto [Nov08] a při stylu "apalike"
+takto [Novák, 2008].
+
+Příkaz "\rcite[<lejblíky>]" funguje jako "\cite[<lejblíky>]", ale kolem odkazů
+nejsou přidány závorky. Možnost využití: "[\rcite[novak08],~s.~213]" vytvoří
+například odkaz [17,~s.~213]. Závorky kolem musíte napsat sami.
+
+Příkaz "\ecite[<lejblík>]{<text>}" vytiskne pouhý "<text>", který se chová
+jako odkaz na literaturu.
+Příklad použití: "z~výsledů Nováka [\ecite[novak08]{2008},~s.~213] plyne..."
+z~výsledků Nováka [2008, s. 213] plyne\dots\ Přitom "novak08" je registrován do
+seznamu citovaných položek a třeba při "\hyperlinks" bude číslo 2008 prolinkováno
+s odpovídající položkou v~seznamu literatury.
+
+Příklady redefinice "\cite" pro alternativní formátování odkazů:
+
+\begtt
+\def\cite[#1]{(\rcite[#1])} % \cite[lejblík] vytvoří (27)
+\def\cite[#1]{$^{\rcite[#1]}$} % \cite[lejblík] vytvoří^{27}
+\endtt
+
+\noindent {\bf Seznam literatury} je možné vložit do dokumentu čtyřmi různými
způsoby:
\begitems
* Manuálně: pomocí jednotlivých položek "\bib[<lejblík>]" přímo v dokumentu.
* S využitím Bib\TeX{}u makrem "\usebibtex{<bib-báze>}{<bst-styl>}".
* Využitím jednou vygenerované databáze makrem "\usebbl/<typ> <bbl-báze>".
+* Přímým čtením ".bib" databáze makry \TeX{}u bez využití Bib\TeX{}u.
\enditems
Jednotlivé způsoby jsou níže probrány podrobněji.
\medskip\noindent
{\bf Manuálně vložený seznam literatury} v dokumentu vypadá například takto:
+\par\nobreak
\begtt
-\bib[tbn] P. Olšák. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
-\bib[tst] P. Olšák. {\it Typografický systém \TeX.}
- 269~s. Praha: CSTUG, 1995.
+\bib [tbn] Petr Olšák. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\bib [tst] Petr Olšák. {\it Typografický systém \TeX.}
+ 269~s. Praha: CSTUG, 1995.
\endtt
%
Výše uvedená ukázka dá následující výstup:
\medskip
-\bib[tbn] P. Olšák. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
-\bib[tst] P. Olšák. {\it Typografický systém \TeX.}
+\bib[tbn] Petr Olšák. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\bib[tst] Petr Olšák. {\it Typografický systém \TeX.}
269~s. Praha: CSTUG, 1995.
+\medskip
+Je možné použít rozšířený způsob zápisu
+"\bib [<lejblík>] = {<značka>} <text záznamu>". Údaj "<značka>" se
+použije do odkazů při zapnutém "\nonumcitations". Kolem rovnítka musejí být mezery.
+Například:
+
+\begtt
+\bib [tbn] = {Olšák, 1997}
+ OLŠÁK, P. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\endtt
\medskip\noindent
{\bf Využití Bib\TeX{}u.} Předpokládá se, že uživatel disponuje souborem
@@ -1248,13 +1290,8 @@ stylového souboru bez přípony ".bst", který použije Bib\TeX{} pro konverzi
"<bib-báze>.bib" do výstupu "<dokument>.bbl". Tento výstup pak bude makrem
"\usebibtex" přečten a vložen do dokumentu. Typicky používané <bst-styly>
jsou "plain", "alpha", "apalike", "ieeetr", "unsrt".
-Styl "alpha" způsobí, že se místo čísel začnou zjevovat v dokumentu zkratky,
-a to jednak v seznamu literatury a jednak v místě výskytu příkazů "\cite".
-V takovém případě pochopitelně "\shortcitations" nefunguje a pokud byste se
-o něj pokusili, tak makro havaruje.
Existují desítky, možná stovky dalších ".bst" stylů, viz internet.
-
Při prvním zpracování dokumentu \TeX{}em makro "\usebibtex" připraví vstupní
pokyny pro Bib\TeX{} do souboru "<dokument>.aux" a zjistí, že soubor
"<dokument>.bbl" zatím neexistuje. To dá najevo na terminálu:
@@ -1338,7 +1375,6 @@ Makro OPmac navrhuje řešení, při kterém stačí použít Bib\TeX{} pro mnoh
\removelastskip
\enditems
-
Kroky 2 až 4 budete muset opakovat pouze tehdy, když budete chtít přidat do
"<mojebáze>.bbl" další údaj, tj. po upgradu souboru "<bib-báze>.bib".
Prudí-li různí odběratelé vaší vědecké činnosti požadavky na různé
@@ -1346,6 +1382,45 @@ Prudí-li různí odběratelé vaší vědecké činnosti požadavky na různé
podle různých stylů různé soubory typu "mybbl-plain.bbl",
"mybbl-ieeetr.bbl".
+\medskip
+\noindent
+{\bf Přímé čtení ".bib" databáze} je možné po "\input opmac-bib.tex".
+Tato přídavná makra navíc používají externí balíček na čtení ".bib" souborů
+"librarian.tex" od Paula Isamberta. Užití je podobné, jako při "\usebbl":
+
+\begtt
+\usebib/c (<style>) <bib-báze> % řadit podle pořadí citace (c=cite),
+\usebib/s (<style>) <bib-báze> % řadit podle klíče ve stylu (s=style).
+\endtt
+
+Zde "<bib-báze>" je jeden nebo více ".bib" souborů oddělených čárkou bez
+mezery a bez přípony. Prametr "<style>" udává část jména souboru
+"opmac-bib-<style>.tex", ve kterém je specifikace formátování položek.
+Součástí balíčku je styl "simple", tedy soubor "opmac-bib-simple.tex",
+který si může uživatel zkopírovat na jiný název a modifikovat dle svých
+představ. Více informací je na konci souboru "opmac-bib.tex".
+
+\medskip
+\noindent
+{\bf Formátování seznamu literatury} je řízeno makrem "\printbib",
+které je vloženo na začátek každé položky v seznamu.
+Implicitní hodnota makra tiskne čísla položek do
+hranatých závorek a při použití "\nonumcitations" předsadí první řádek
+položky a nepřidává nic. Makro může využít "\the\bibnum" pro tisk
+čísla nebo "\the\bibmark" pro tisk značky (při "\nonumcitations").
+Příklady:
+
+\begtt
+% Číslování položek bez hranatých závorek:
+\def\printbib{\hangindent=\parindent \indent \llap{\the\bibnum. }}
+
+% Tisk zkratek při použití bibTeXového stylu alpha a \nonumcitations:
+\def\printbib{\hangindent=\parindent \noindent [\the\bibmark]\quad}
+\endtt
+
+Další příklady (třeba jak \TeX{} změří šířku největšího čísla a podle toho
+vypočítá odsazení celého seznamu) jsou uvedeny na
+\url{http://petr.olsak.net/opmac-tricks.html}.
\sec Matematická sazba
%%%%%%%%%%%%%%%%%%%%%%
@@ -1477,12 +1552,11 @@ Není-li soubor REF otevřen, je hodnota registru "\lastpage" rovna nule.
\footline={\hss \rm \thefontsize[10]\the\pageno/\the\lastpage \hss}
\endtt
-\vfill\break
\sec Shrnutí
%%%%%%%%%%%%
-Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
+%Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
\def\tthook{\adef!{\string\endtt}\adef&{\kern.25em}}
\begtt
@@ -1497,7 +1571,6 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
\label[<lejblík>] % deklarace před cílem odkazu
\ref[<lejblík>] % odkaz na kapitolu, sekci nebo podsekci
-\cite[<lejblík>] % odkaz do seznamu literatury
\pgref[<lejblík>] % odkaz na stránku
\caption/t % číslovaný popisek tabulky
@@ -1513,11 +1586,14 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
\begmulti % začátek vícesloupcové sazby
\endmulti % konec vícesloupcové sazby
-\bib[<lejblík>] % položka v seznamu literatury
-\cite[<lejblík>] % místo, odkud se odkazuje do seznamu literatury
+\cite[<lejblíky>] % místo, odkud se odkazuje do seznamu literatury
+\rcite[<lejblíky>] % jako \cite, ale bez závorek kolem
+\sortcitations \shortcitations \nonumcitations % deklarace typu odkazů
+\bib[<lejblík>] % položka v seznamu literatury
\usebibtex{<bib-báze>}{<bst-styl>} % použití bibTeXu pro seznam literatury
\genbbl{<bib-báze>}{<bst-styl>} % předgenerování seznamu literatury
\usebbl/? <bbl-báze> % použití předgenerované databáze, ? je z {a,b,c}
+\usebib/? (<style>) <bib-báze> % přímé čtení .bib bez BibTeXu, ? je z {c,s}
\typosize[<font-velikost>/<řádkování>] % nastavení velikosti sazby
\typoscale[<faktor-font>/<faktor-řádkování>] % škálování velikosti sazby
@@ -1526,7 +1602,6 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
\inspic <soubor>.<přípona> % vložení obrázku, přípony: jpg, png, pdf
\table{<pravidlo>}{<data>} &% makro pro tabulku
\frame{<text>} % orámovaný text
-
\fnote{<text>} % poznámka pod čarou (lokální číslování na každé stránce)
\mnote{<text>} % poznámka na okraji (pravém nebo levém podle stránky)