diff options
Diffstat (limited to 'Master/texmf-dist/doc/cstex/opmac-u.tex')
| -rw-r--r-- | Master/texmf-dist/doc/cstex/opmac-u.tex | 129 |
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) |