diff options
Diffstat (limited to 'Master/texmf-dist/tex/luatex/optex/base/bib-iso690.opm')
-rw-r--r-- | Master/texmf-dist/tex/luatex/optex/base/bib-iso690.opm | 906 |
1 files changed, 0 insertions, 906 deletions
diff --git a/Master/texmf-dist/tex/luatex/optex/base/bib-iso690.opm b/Master/texmf-dist/tex/luatex/optex/base/bib-iso690.opm deleted file mode 100644 index c58709ce835..00000000000 --- a/Master/texmf-dist/tex/luatex/optex/base/bib-iso690.opm +++ /dev/null @@ -1,906 +0,0 @@ -% This is part of the OpTeX project, see http://petr.olsak.net/optex - -% bibliography style (iso690), version <2020-03-10>, loaded on demand by \usebib - -\_ifx\_optexbibstyle\_undefined \_errmessage - {This file can be read by: \_string\usebib/? (iso690) bibfiles command only} - \_endinput \_fi - - \_doc ----------------------------- - \`\_maybetod` (alias `\.` in the style file group) does not put the second dot. - \_cod ----------------------------- - -\_def\_maybedot{\_ifnum\_spacefactor=\_sfcode`\.\_relax\_else.\_fi} -\_tmpnum=\_sfcode`\. \_advance\_tmpnum by-2 \_sfcode`\.=\_tmpnum -\_sfcode`\?=\_tmpnum \_sfcode`\!=\_tmpnum -\_let\.=\_maybedot % prevents from double periods - - \_doc ----------------------------- - Option field. - \_cod ----------------------------- - -\_CreateField {option} -\_def\_isbiboption#1#2{\_edef\_tmp{\_noexpand\_isbiboptionA{#1}}\_tmp} -\_def\_isbiboptionA#1{\_def\_tmp##1 #1 ##2\_relax{% - \_if^##2^\_csname iffalse\_ea\_endcsname \_else\_csname iftrue\_ea\_endcsname \_fi}% - \_ea\_tmp\_biboptionsi #1 \_relax} -\_def\_bibopt[#1]#2#3{\_isbiboption{#1}\_iftrue\_def\_tmp{#2}\_else\_def\_tmp{#3}\_fi\_tmp} -\_def\_biboptionvalue#1#2{\_def\_tmp##1 #1:##2 ##3\_relax{\_def#2{##2}}% - \_ea\_tmp\_biboptionsi #1: \_relax} - -\_def\_readbiboptions{% - \_RetrieveFieldIn{option}\_biboptionsi - \_toks1=\_ea{\_biboptionsi}% - \_edef\_biboptionsi{\_space \_the\_toks1 \_space \_the\_biboptions \_space}% -} -\_newtoks\_biboptions -\_public \biboptions ; - - \_doc ----------------------------- - Formating of Author/Editor lists. - \_cod ----------------------------- - -\_def\_firstauthorformat{% - \_upper{\_Lastname}\_bprintc\_Firstname{, *}\_bprintc\_Von{ *}\_bprintc\_Junior{, *}% -} -\_def\_otherauthorformat{% - \_bprintc\_Firstname{* }\_bprintc\_Von{* }\_upper{\_Lastname}\_bprintc\_Junior{, *}% -} -\_def\_commonname{% - \_ifnum\_NameCount=1 - \_firstauthorformat - \_ifx\_dobibmark\_undefined \_edef\_dobibmark{\_Lastname}\_fi - \_else - \_ifnum0\_namecount=\_NameCount - \_ifx\_maybeetal\_empty \_bibconjunctionand\_else , \_fi - \_else , \_fi - \_otherauthorformat - \_fi -} -\_def\_authorname{% - \_ifnum\_NameCount>0\_namecount\_relax\_else \_commonname \_fi - \_ifnum\_NameCount=0\_namecount\_relax \_maybeetal \_fi -} -\_let\_editorname=\_authorname - -\_def\_prepareauedoptions#1{% - \_def\_mabyetal{}\_csname lb@abbreviatefalse\_endcsname - \_biboptionvalue{#1max}\_authormax - \_biboptionvalue{#1min}\_authormin - \_biboptionvalue{#1pre}\_authorpre - \_biboptionvalue{#1print}\_authorprint - \_isbiboption{#1etal}\_iftrue \_def\_maybeetal{\_Mtext{bib.etal}}\_fi - \_biboptionvalue{#1trim}\_autrim - \_let\_namecountraw=\_namecount - \_ifx\_authormax\_empty \_else - \_ifnum 0\_authormax<0\_namecount - \_edef\_namecount{\_ifx\_authormin\_empty\_authormax\_else\_authormin\_fi}% - \_def\_maybeetal{\_Mtext{bib.etal}}% - \_fi\_fi - \_ifx\_autrim\_empty \_def\_autrim{10000}\_fi - \_ifnum\_autrim=0 \_def\_autrim{10000}\_fi - \_ifnum 0\_namecount<\_autrim\_relax \_else \_AbbreviateFirstname \_fi -} -\_def\_maybeetal{} - -\_ifx\upper\_undefined - \_ifx\caps \_undefined \_def\upper{\_uppercase\_ea}\_else - \_def\upper#1{{\caps\_rm #1}}\_fi -\_fi -\_let\_upper=\upper - - \_doc ----------------------------- - Preparing bib-mark (used when `\nonumcitations` is set). - \_cod ----------------------------- - -\_def\_setbibmark{% - \_ifx\_dobibmark\_undefined \_def\_dobibmark{}\_fi - \_RetrieveFieldIn{bibmark}\_tmp - \_ifx\_tmp\_empty \_RetrieveFieldIn{year}\_tmp \_edef\_tmp{\_dobibmark, \_tmp}\_fi - \_bibmark=\_ea{\_tmp}% -} - - \_doc ----------------------------- - Setting phrases. - \_cod ----------------------------- - -\_def\_bibconjunctionand{\_Mtext{bib.and}} -\_def\_preurl{\_Mtext{bib.available}} -\_let\_predoi=\_preurl -\_def\_postedition{\_mtext{bib.edition}} -\_def\_Inclause{In:~} -\_def\_prevolume{\_mtext{bib.volume}} -\_def\_prenumber{\_mtext{bib.number}} -\_def\_prepages{\_mtext{bib.prepages}} -\_def\_posteditor{\_ifnum0\_namecountraw>1 \_Mtext{bib.editors}\_else\_Mtext{bib.editor}\_fi} - - \_doc ---------------------------- - \`\_Mtext``{<identifier>}` expands to a - phrase by outer document language (no entry language). - \_cod ----------------------------- - -\_chardef\_documentlanguage=\_language -\_def\_Mtext#1{\_csname _mt:#1:\_csname _lan:\_the\_documentlanguage\_endcsname\_endcsname} - -\_CreateField {lang} -\_def\_setlang#1{\_ifx#1\_empty \_else - \_ifcsname _mt:bib.and:#1\_endcsname \_language=\_csname _#1Patt\_endcsname \_relax - \_else \_opwarning{No phrases for "#1" used by [\EntryKey] in .bib}% - \_fi\_fi -} - - \_doc ----------------------------- - Non-standard field names. - \_cod ----------------------------- - -\_CreateField {ednote} -\_CreateField {citedate} -\_CreateField {numbering} -\_CreateField {isbn} -\_CreateField {issn} -\_CreateField {doi} -\_CreateField {url} -\_CreateField {bibmark} - - \_doc ----------------------------- - Sorting. - \_cod ----------------------------- - -\_SortingOrder{name,year}{lfvj} -\_SpecialSort {key} - - \_doc ----------------------------- - Supporting macros. - \_cod ----------------------------- - -\_def\_bibwarninga{\_bibwarning} -\_def\_bibwarningb{\_bibwarning} - -\_def\_docitedate #1/#2/#3/#4\_relax{[\_Mtext{bib.citedate}% - \_if^#2^#1\_else - \_if^#3^#1/#2\_else - \_cs{_\_cs{_lan:\_the\_documentlanguage}dateformat}#1/#2/#3\relax - \_fi\_fi ]% -} -\_def\_doyear#1{ - \_biboptionvalue{yearprint}\_yearprint - \_ifx\_yearprint\_empty#1\_else\_def\YEAR{#1}\_yearprint\_fi -} -\_def\_preparenumbering{% - \_def\VOL{\_RetrieveField{volume}}% - \_def\NO{\_RetrieveField{number}}% - \_def\PP{\_RetrieveField{pages}}% -} -\_def\_prepareednote{% - \_def\EDN{\_RetrieveField{edition}}% - \_def\ADDR{\_RetrieveField{address}}% - \_def\PUBL{\_RetrieveField{publisher}}% - \_def\YEAR{\_RetrieveField{year}}% - \_def\AU{\_bprintb[!author]{\_doauthor0{####1}}{}}% - \_def\ED{\_bprintb[!editor]{\_doeditor0{####1}}{}}% - \_preparenumbering -} -\_def\_doedition#1{% - \_biboptionvalue{editionprint}\_editionprint - \_ifx\_editionprint\_empty#1\_postedition\_else\_def\ED{#1}\_editionprint\_fi -} -\_def\_doauthor#1#2{\_prepareauedoptions{au}\_let\_iseditorlist=\_undefined - \_if1#1\_def\AU{#2}\_else\_let\_authorprint=\_empty\_fi - \_ifx\_authorprint\_empty #2\_else \_authorprint\_fi -} -\_def\_doeditor#1#2{\_prepareauedoptions{ed}\_let\_firstauthorformat=\_otherauthorformat - \_if1#1\_def\ED{#2}\_else\_let\_authorprint=\_empty\_fi - \_ifx\_authorprint\_empty #2\_posteditor\_else \_authorprint\_fi -} - - \_doc ----------------------------- - Entry types. - \_cod ----------------------------- - -\_sdef{_print:BEGIN}{% - \_readbiboptions - \_biboptionvalue{titlepost}\_titlepost - \_isbiboption{unpublished}\_iftrue \_let\_bibwarninga=\_relax \_let\_bibwarningb=\_relax \_fi - \_isbiboption{nowarn}\_iftrue \_let\_bibwarning=\_relax \_fi - \_isbiboption{urlalso}\_iftrue \_def\_preurl{\_Mtext{bib.availablealso}}\_fi - \_RetrieveFieldIn{lang}\_langentry \_setlang\_langentry -} -\_sdef{_print:END}{% - \_bprinta [note] {*.}{}% - \_setbibmark -} -\_def\_bookgeneric#1{% - \_bprinta [howpublished] {[*].\ }{}% - \_bprintb [edition] {\_doedition{##1}\.\ }{}% - \_bprinta [ednote] {*.\ }{}% - \_bprinta [address] {*\_bprintv[publisher]{:}{\_bprintv[year]{,}{.}}\ }{\_bibwarninga}% - \_bprinta [publisher] {*\_bprintv[year]{,}{.}\ }{\_bibwarninga}% - \_bprintb [year] {\_doyear{##1}\_bprintv[citedate]{\_bprintv[numbering]{.}{}}{.}\ }% - {\_bibwarning}% - \_bprinta [numbering] {\_preparenumbering*\_bprintv[citedate]{}{\.}\ }{}% - \_bprinta [citedate] {\_docitedate*///\_relax.\ }{}% - #1% - \_bprinta [series] {*.\ }{}% - \_bprinta [isbn] {ISBN~*.\ }{\_bibwarningb}% - \_bprinta [issn] {ISSN~*.\ }{}% - \_bprintb [doi] {\_predoi DOI \_ulink[http://dx.doi.org/##1]{##1}.\ }{}% - \_bprintb [url] {\_preurl\_url{##1}. }{}% -} -\_sdef{_print:book}{% - \_bprintb [!author] {\_doauthor1{##1}\.\ }{\_bibwarning}% - \_bprintb [title] {{\_em##1}\_bprintc\_titlepost{\.\ *}\_bprintv[howpublished]{}{\.}\ }% - {\_bibwarning}% - \_bookgeneric{}% -} -\_sdef{_print:article}{% - \_biboptionvalue{journalpost}\_journalpost - \_bprintb [!author] {\_doauthor1{##1}\.\ }{\_bibwarning}% - \_bprinta [title] {*.\ \_bprintc\_titlepost{*.\ }}{\_bibwarning}% - \_bprintb [journal] {{\_em##1}\_bprintc\_journalpost{\.\ *}\_bprintv[howpublished]{}{\.}\ }% - {\_bibwarninga}% - \_bprinta [howpublished] {[*].\ }{}% - \_bprinta [address] {*\_bprintb[publisher]{:}{,}\ }{}% - \_bprinta [publisher] {*, }{}% - \_bprinta [month] {*, }{}% - \_bprintb [year] {\_doyear{##1}\_bprintv[volume,number,pages]{,}{\.}\ }{}% - \_bprinta [numbering] {\_preparenumbering*\_bprintv[citedate]{}{\.}\ } - {\_bprinta [volume] {\_prevolume*\_bprintv[number,pages]{,}{\.}\ }{}% - \_bprinta [number] {\_prenumber*\_bprintv[pages]{,}{\.}\ }{}% - \_bprintb [pages] {\_prepages\_hbox{##1}\_bprintv[citedate]{}{\.}\ }% - {\_bibwarninga}}% - \_bprinta [citedate] {\_docitedate*///\_relax.\ }{}% - \_bprinta [issn] {ISSN~*.\ }{}% - \_bprintb [doi] {\_predoi DOI \_ulink[http://dx.doi.org/##1]{##1}.\ }{}% - \_bprintb [url] {\_preurl\_url{##1}. }{}% -} -\_sdef{_print:inbook}{% - \_let\_bibwarningb=\_relax - \_bprintb [!author] {\_doauthor1{##1}\.\ }{\_bibwarning}% - \_bprinta [title] {*.\ }{\_bibwarning}% - \_Inclause - \_bprintb [!editor] {\_doeditor1{##1}\.\ }{}% - \_bprintb [booktitle] {{\_em##1}\_bprintc\_titlepost{\.\ *}\_bprintv[howpublished]{}{\.}\ }% - {\_bibwarning}% - \_bookgeneric{\_bprintb [pages] {\_prepages\_hbox{##1}. }{}}% -} -\_slet{_print:inproceedings}{_print:inbook} -\_slet{_print:conference}{_print:inbook} - -\_sdef{_print:thesis}{% - \_bprintb [!author] {\_doauthor1{##1}\.\ }{\_bibwarning}% - \_bprintb [title] {{\_em##1}\_bprintc\_titlepost{\.\ *}\_bprintv[howpublished]{}{\.}\ }% - {\_bibwarning}% - \_bprinta [howpublished] {[*].\ }{}% - \_bprinta [address] {*\_bprintv[school]{:}{\_bprintv[year]{,}{.}}\ }{\_bibwarning}% - \_bprinta [school] {*\_bprintv[year]{,}{.}\ }{\_bibwarning}% - \_bprinta [month] {*, }{}% - \_bprintb [year] {\_doyear{##1}\_bprintv[citedate]{}{.}\ }{\_bibwarninga}% - \_bprinta [citedate] {\_docitedate*///\_relax.\ }{}% - \_bprinta [type] {*\_bprintv[ednote]{,}{.}\ }% - {\_ifx\_thesistype\_undefined\_bibwarning - \_else\_thesistype\_bprintv[ednote]{,}{.}\ \_fi}% - \_bprinta [ednote] {*.\ }{}% - \_bprintb [doi] {\_predoi DOI \_ulink[http://dx.doi.org/##1]{##1}.\ }{}% - \_bprintb [url] {\_preurl\_url{##1}. }{}% -} -\_sdef{_print:phdthesis}{\_def\_thesistype{\_Mtext{bib.phdthesis}}\_cs{_print:thesis}} -\_sdef{_print:mastershesis}{\_def\_thesistype{\_Mtext{bib.masthesis}}\_cs{_print:thesis}} -\_sdef{_print:bachelorsthesis}{\_def\_thesistype{\_Mtext{bib.bachthesis}}\_cs{_print:thesis}} - -\_sdef{_print:generic}{% - \_bprintb [!author] {\_doauthor1{##1}\.\ }{\_bibwarning}% - \_bprintb [title] {{\_em##1}\_bprintc\_titlepost{\.\ *}\_bprintv[howpublished]{}{\.}\ }% - {\_bibwarning}% - \_bprinta [howpublished] {[*].\ }{}% - \_bprinta [ednote] {\_prepareednote*\_bprintv[citedate]{}{.}\ }{\_bibwarning}% - \_bprinta [year] {}{\_bibwarning}% - \_bprinta [citedate] {\_docitedate*///\_relax.\ }{}% - \_bprintb [doi] {\_predoi DOI \_ulink[http://dx.doi.org/##1]{##1}.\ }{}% - \_bprintb [url] {\_preurl\_url{##1}. }{}% -} -\_slet{_print:booklet}{_print:generic} -\_slet{_print:incolleciton}{_print:generic} -\_slet{_print:manual}{_print:generic} -\_slet{_print:proceedings}{_print:generic} -\_slet{_print:techreport}{_print:generic} -\_slet{_print:unpublished}{_print:generic} - -\_sdef{_print:misc}{\_let\_bibwarning=\_relax \_cs{_print:generic}} - -\_endcode - - -This is the iso690 bibliographic style used by \OpTeX/. - -See `op-biblist.bib` for an example of the `.bib` input. You can try it by: - -\begtt -\fontfam[LMfonts] -\nocite[*] -\usebib/s (iso690) op-biblist -\end -\endtt - -\seccc Common rules in \code{.bib} files - -There are entries of type `@FOO{...}` in the `.bib` file. Each entry consists of -fields in the form `name = "value"`, or `name = {value}`. No matter which form is -used. If the value is pure numeric then you can say simply `name = value`. -Warning: the comma after each field value is mandatory! If it is missing then the -next field is ignored or badly interpreted. - -The entry names and field names are case insensitive. If there exists a data -field no mentioned here then it is simply ignored. You can use it to store -more information (abstract, for example). - -There are \"standard fields" used in ancient bib\TeX/ (author, title, editor, edition, -etc., see \url{http://en.wikipedia.org/wiki/BibTeX}). The `iso690` style introduces -several \"non-standard" fields: ednote, numbering, isbn, issn, doi, url, -citedate, key, bibmark. They are documented here. - -Moreover, there are two optional special fields: - -\begitems -* lang = language of the entry. The hyphenation plus autogenerated phrases and - abbreviations will be typeset by this language. -* option = options by which you can control a special printing of various fields. -\enditems - -There can be only one option field per each entry with (maybe) more options -separated by spaces. You can declare the global option(s) in your document -applied for each entry by `\biboptions={...}`. - - -\seccc The author field - -All names in the author list have to be separated by \"\code{ and }". -Each author can be written in various formats (the `von` part is typically missing): - -\begtt -Firstname(s) von Lastname -or -von Lastname, Firstname(s) -or -von Lastname, After, Firstname(s) -\endtt -Only the Lastname part is mandatory. Examples: -\begtt -Petr Olšák -or -Olšák, Petr - -Leonardo Piero da Vinci -or -da Vinci, Leonardo Piero -or -da Vinci, painter, Leonardo Piero -\endtt -The separator \"\code{ and }" between authors -will be converted to comma during -printing, but between the semifinal and final author the word \"and" (or something -different depending on the current language) is printed. - -The first author is printed in reverse order: \"LASTNAME, Firstname(s) von, -After" and the other authors are printed in normal order: \"Firstname(s) -von LASTNAME, After". This feature follows the ISO 690 norm. The Lastname -is capitalized using uppercase letters. But if the `\caps` font modifier is defined, -then it is used and printed `{\caps\_rm Lastname}`. - -You can specify the option `aumax:<number>`. The `<number>` denotes the -maximum authors to be printed. The rest of the authors are ignored and the -`et~al.` is appended to the list of printed authors. This text is -printed only if the `aumax` value is less than the real number of authors. -If you have the same number of authors in the .bib file as you need to print -but you want to append `et~al.` then you can use `auetal` option. - -There is an `aumin:<number>` option which denotes the definitive number of -printed authors if the author list is not fully printed due to `aumax`. -If `aumin` is unused then `aumax` authors are printed in this case. - -All authors are printed if `aumax:<number>` option isn't given. -There is no internal limit. But you can set the global options in -your document by setting the `\biboptions` tokens list. For example: - -\begtt -\biboptions={aumax:7 aumin:1} -% if there are 8 or more authors then only the first author is printed. -\entdd - -Examples: -\begtt -author = "John Green and Bob Brown and Alice Black", -\endtt -output: GREEN, John, Bob BROWN, and Alice BLACK. - -\begtt -author = "John Green and Bob Brown and Alice Black", -option = "aumax:1", -\endtt -output: GREEN, John~et~al. - -\begtt -author = "John Green and Bob Brown and Alice Black", -option = "aumax:2", -\endtt -output: GREEN, John, Bob BROWN~et~al. - -\begtt -author = "John Green and Bob Brown and Alice Black", -option = "aumax:3", -\endtt -output: GREEN, John, Bob BROWN, and Alice BLACK. - -\begtt -author = "John Green and Bob Brown and Alice Black", -option = "auetal", -\endtt -output: GREEN, John, Bob BROWN, Alice BLACK~et~al. - -If you need to add a text before or after the author's list, you can use -the `auprint:{<value>}` option. The <value> will be printed instead of the -authors list. The <value> can include `\AU` macro which expands to the authors -list. Example: - -\begtt -author = "Robert Calbraith", -option = "auprint:{\AU\space [pseudonym of J. K. Rowling]}", -\endtt -output: CALBRAITH Robert [pseudonym of J. K. Rowling]. - -You can use the `autrim:<number>` option. All Firstnames of all authors -are trimmed (i. e. reduced to initials) iff the number of authors in the -author field is greater than or equal to `<number>`. There is an exception: -`autrim:0` means that no Firstnames are trimmed. This is the default behavior. -Another example: `autrim:1` means that all Firstnames are trimmed. - -\begtt -author = "John Green and Bob Brown and Alice Black", -option = "auetal autrim:1", -\endtt -output: GREEN, J., B. BROWN, A. BLACK~et~al. - -If you need to write a team name or institution instead of authors, replace all -spaces by `\ ` in this name. Such text is interpreted as Lastname. You -can add the secondary name (interpreted as Firstname) after the comma. Example: - -\begtt - author = "Czech\ Technical\ University\ in\ Prague, - Faculty\ of\ Electrical\ Engeneering", -\endtt -output: CZECH TECHNICAL UNIVERSITY IN PRAGUE, Faculty of Electrical Engeneering. - - -\seccc The editor field - -The editor field is used for the list of the authors of the collection. The -analogous rules as in author field are used here. It means that the -authors are separated by \"\code{ and }", the Firstnames, Lastnames, etc. are -interpreted and you can use the options `edmax:<number>`, `edmin:<number>`, -`edetal`, `edtrim:<number>` and `edprint:{<value>}` (with `\ED` macro). -Example: -\begtt -editor = "Jan Tomek and Petr Karas", -option = "edprint:{\ED, editors.} edtrim:1", -\endtt -Output: J. TOMEK and P. KARAS, editors. - -If `edprint` option is not set then `{\ED, eds.}` or `{\ED, ed.}` is used -depending on the entry language and on the singular or plural of -the editor(s). - - -\seccc The ednote field - -The ednote field is used as the secondary authors and more editional info. The -value is read as raw data without any interpretation of Lastname, Firstname -etc. -\begtt -ednote = "Illustrations by Robert \upper{Agarwal}, edited by Tom \upper{Nowak}", -\endtt -output: Illustrations by Robert AGARWAL, edited by Tom NOWAK. - -The `\upper` command has to be used for Lastnames in the ednote field. - - -\seccc The title field - -This is the title of the work. It will be printed (in common entry types) by -italics. The ISO 690 norm declares, that the title plus optional subtitle -are in italics and they are separated by a colon. Next, the optional secondary -title has to be printed in an upright font. This can be added by -`titlepost:{<value>}`. Example: - -\begtt -title = "The Simple Title of The Work", -or -title = "Main Title: Subtitle", -or -title = "Main Title: Subtitle", -option = "titlepost:{Secondary title}", -\endtt -The output of the last example: -{\it Main Title: Subtitle}. Secondary title. - - -\seccc The edition field - -This field is used only for second or more edition of cited work. Write -only the number without the word "edition". The shortcut "ed." (or something -else depending on the current language) is added automatically. Examples: - -\begtt -edition = "Second", -edition = "2nd", -edition = "2$^{\rm nd}$", -edition = "2.", -\endtt -Output of the last example: 2. ed. - -\begtt -edition = "2." -lang = "cs", -\endtt -Output: 2. vyd. - -Note, that the example `edition = "Second"` may cause problems. If you are -using language "cs" then the output is bad: Second vyd. -But you can use `editionprint:{<value>}` option. The the <value> is printed -instead of edition field and shortcut. The edition field must be set. Example: - -\begtt -edition = "whatever", -option = "editionprint:{Second full revised edition}", -\endtt -Output: Second full revised edition. - -You can use `\EDN` macro in `editionprint` value. This macro is expanded -to the edition value. Example: - -\begtt -edition = "Second", -option = "editionprint:{\EDN\space full revised edition}", -or -edition = "Second full revised edition", -option = "editionprint:{\EDN}", -\endtt - - -\seccc The address, publisher, year fields - -This is an anachronism from ancient Bib\TeX/ (unfortunately no exclusive) that -the address field includes only the city of the publisher's residence. No more -data are here. The publisher field includes the name of the publisher. - -\begtt -address = "Berlin", -publisher = "Springer Verlag", -year = 2012, -\endtt -Output: Berlin: Springer Verlag, 2012. - -Note, that the year needn't to be inserted into quotes because it is pure -numeric. - -The letter a, b, etc. are appended to the year automatically if two or more -subsequent entries in the bibliography list are not distinct by the first -author and year fields. If you needn't this feature, you can use the -`noautoletters` option. - -You can use "yearprint:{<value>}" option. If it is set then the <value> -is used for printing year instead the real field value. The reason: year is -sort sensitive, maybe you need to print something else than only sorting key. -Example: - -\begtt -year = 2000, -option = "yearpint:{© 2000}", -\endtt -Output: © 2000, sorted by: 2000. - -\begtt -year = "2012a", -option = "yearprint:{2012}", -\endtt -Output: 2012, sorted by: 2012a. - -The address, publisher, and year are typically mandatory fields. If they are -missing then the warning occurs. But you can set `unpublished` -option. Then this warning is suppressed. There is no difference in the -printed output. - - -\seccc The url field - -Use it without `\url` macro, but with `http://` prefix. Example: - -\begtt -url = "http://petr.olsak.net/opmac.html", -\endtt - -The ISO 690 norm recommends to add the text \"Available from" (or -something else if a different current language is used) before URL. -It means, that the output of the previous example is: - -Available from \url{http://petr.olsak.net/opmac.html}. - -If the `cs` language is the current one than the output is: - -Dostupné z: \url{http://petr.olsak.net/opmac.html}. - -If the `urlalso` option is used, then the added text has the form -\"Available also from" or \"Dostupné také z:" (if `cs` language is -current). - - -\seccc The citedate field - -This is the citation date. The field must be in the form year/month/day. It -means, that the two slashes must be written here. The output depends on the -current language. Example: - -\begtt -citedate = "2004/05/21", -\endtt -Output when `en` is current: [cit. 2004-05-21].\nl -Output when `cs` is current: [vid. 21.~5.~2004]. - - -\seccc The howpublished field - -This declares the available medium for the cited document if it is not in printed -form. Alternatives: online, CD, DVD, etc. Example: - -\begtt -howpublished = "online", -\endtt -Output: [online]. - - -\seccc The volume, number, pages and numbering fields - -The volume is the \"big mark" of the journal issue and the number is the -\"small mark" of the journal issue and pages includes the page range of -the cited article in the journal. The volume is prefixed by Vol.~, -the number by No.~, and the pages by pp.~. But these prefixes depends on the -language of the entry. - -Example: - -\begtt -volume = 31, -number = 3, -pages = "37--42", -\endtt -Output: Vol.~31, No.~3, pp.~37--42. - -\begtt -volume = 31, -number = 3, -pages = "37--42", -lang = "cs", -\endtt -Output: ročník~31, č.~3, s.~37--42. - -If you disagree with the default prefixes, you can use the numbering field. -When it is set then it is used instead of volume, number, pages fields -and instead of any mentioned prefixes. The numbering can include macros -`\VOL`, `\NO`, `\PP`, which are expanded to the respective values of fields. Example: - -\begtt -volume = 31, -number = 3, -pages = "37--42" -numbering = "Issue~\VOL/\NO, pages~\PP", -\endtt -Output: Issue~31/3, pages~37--42 - -Note: The volume, numbers, and pages fields are printed without numbering -filed only in the `@ARTICLE` entry. It means, that if you need to visible them -in the `@INBOOK`, `@INPROCEEDINGS` etc. entries, then you must use the numbering field. - - -\seccc Common notes about entries - -The order of the fields in the entry is irrelevant. We use the printed order -in this manual. The exclamation mark (!) denotes the mandatory field. If -the field is missing then a warning occurs during processing. - -If the `unpublished` option is set then the fields address, publisher, year, -isbn, and pages are not mandatory. If the `nowarn` option is set then no -warnings about missing mandatory fields occur. - -If the field is used but not mentioned in the entry documentation below then -it is silently ignored. - -\secccc The `@BOOK` entry - -This is used for book-like entries. - -Fields: author(!), title(!), howpublished, edition, ednote, address(!), -publisher(!), year(!), citedate, series, isbn(!), doi, url, note. - -The ednote field here means the secondary authors (illustrator, cover design -etc.). - -\secccc The `@ARTICLE` entry - -This is used for articles published in a journal. - -Fields: author(!), title(!), journal(!), howpublished, address, publisher, -month, year, [numbering or volume, number, pages(!)], citedate, issn, -doi, url, note. - -If the numbering is used then it is used instead volume, number, pages. - - -\secccc The `@INBOOK` entry - -This is used for the part of a book. - -Fields: author(!), title(!), booktitle(!), howpublished, edition, ednote, -address(!), publisher(!), year(!), numbering, citedate, series, isbn or -issn, doi, url, note. - -The author field is used for author(s) of the part, the editor field -includes author(s) or editor(s) of the whole document. The pages field specifies -the page range of the part. The series field can include more information -about the part (chapter numbers etc.). - -The `@INPROCEEDINGS` and `@CONFERENCE` entries are equivalent to `@INBOOK` entry. - -\secccc The `@THESIS` entry - -This is used for the student's thesis. - -Fields: author(!), title(!), howpublished, address(!), school(!), -month, year(!), citedate, type(!), ednote, doi, url, note. - -The type field must include the text \"Master's Thesis" or something -similar (depending on the language of the outer document). - -There are nearly equivalent entries: `@BACHELORSTHESIS`, `@MASTERSTHESIS` and -`@PHDTHESIS`. These entries set the type field to an appropriate value -automatically. The type field is optional in this case. If it is used then -it has precedence before the default setting. - -\secccc The @MISC entry - -It is intended for various usage. - -Fields: author, title, howpublished, ednote, citedate, doi, url, note. - -You can use `\AU`, `\ED`, `\EDN`, `\VOL`, `\NO`, `\PP`, `\ADDR`, `\PUBL`, -`\YEAR` macros in ednote field. These macros print authors list, editors list, -edition, volume, number, pages, address, publisher, and year field values -respectively. - -The reason for this entry is to give to you the possibility to set the format of -entry by your own decision. The most of data are concentrated in the ednote field. - -\secccc The `@BOOKLET`, `@INCOLLECION`, `@MANUAL`, `@PROCEEDINGS`, `@TECHREPORT`, `@UNPUBLISHED` entries - -These entries are equivalent to `@MICS` entry because we need to save the -simplicity. They are implemented only for (almost) backward compatibility -with the ancient Bib\TeX/. But the ednote is mandatory field here, so you -cannot use these entries from the old databases without warnings and without -some additional work with the `.bib` file. - -\seccc The cite-marks (bibmark) used when \code{\\nonumcitations} is set - -When `\nonumcitations` is set then `\cite` prints text-oriented -bib-marks instead of numbers. This style file auto-generates these marks in the -form \"Lastname of the first author, comma, space, the year" if the bibmark field -isn't declared. If you need to set an exception from this common format, -then you can use bibmark field. - -The OPmac trick \url{http://petr.olsak.net/opmac-tricks-e.html\#bibmark} -describes how to redefine the algorithm for bibmark auto-generating when you -need the short form of the type [Au13]. - - -\seccc Sorting - -If `\usebib/c` is used then entries are sorted by citation order in the text. -If `\usebib/s` is used then entries are sorted by \"Lastname, Firstname(s)" of -the first author and if more entries have this value equal, then the year is -used (from older to newer). This feature follows the recommendation of the -ISO 690 norm. - -If you have the same authors and the same year, you can control the sorting -by setting years like 2013, 2013a, 2013b, etc. You can print something -different to the list using `yearprint{<value>}` option, see the section about -address, publisher, and year above. The real value of year field (i.e.\ not -yearprint value) is also used in the text-oriented bib-marks when -`\nonumcitations` is set. - -If you have some problems with name sorting, you can use the hidden field -`key`, which is used for sorting instead of the \"Lastname Firstname(s)" -of authors. If the `key` field is unset then the \"Lastname Firstname(s)" -is used for sorting normally. Example: - -\begtt -author = "Světla Čmejrková", -key = "Czzmejrkova Svetla", -\endtt - -This entry is now sorted between C and D. - -The norm recommends placing the auto-citations at the top of the list of -references. You can do this by setting `key = "@"`, to each entry with your -name because the `@` character is sorted before `A`. - - -\seccc Languages - -There is the language of the outer document and the languages of each entry. -The ISO 690 norm recommends that the technical notes (the prefix before URL, -the media type, the \"and" conjunction between the semifinal and final author) -maybe printed in the language of the outer document. The data of the entry -have to be printed in the entry language (edition ed./vyd., Vol./ročník, -No./č. etc.). Finally, there are the phrases independent of the language -(for example In:). Unfortunately, the bib\TeX/ supposes that the entry data -are not fully included in the fields so the automaton has to add some -text during processing (\"ed.", \"Vol.", \"see also", etc.). -But what language has to be chosen? - -The current value of the `\language` register at the start of the `.bib` -processing is described as the language of the outer document. This language -is used for technical notes regardless of the entry language. Moreover, -each entry can have the `lang` field (short name of the language). This -language is used for ed./vyd., vol./ročník, etc. and it is used for -hyphenation too. If the `lang` is not set then the outer document -language is used. - -You can use \^`\_Mtext{bib.<identifier>}` if you want to use a phrase -dependent on outer document language (no on entry language). -Example: - -\begtt -howpublished = "\_Mtext{bib.blue-ray}" -\endtt - -Now, you can set the variants of `bib.blue-ray` phrase for various -languages: - -\begtt -\_sdef{_mt:bib.blue-ray:en} {Blue-ray disc} -\_sdef{_mt:bib.blue-ray:cs} {Blue-ray disk} -\endtt - - -\seccc Summary of non-standard fields - -This style uses the following fields unknown by bib\TeX/: - -\begtt -option ... options separated by spaces -lang ... the language two-letter code of one entry -ednote ... edition info (secondary authors etc.) or - global data in @MISC-like entries -citedate ... the date of the citation in year/month/day format -numbering ... format for volume, number, pages -isbn ... ISBN -issn ... ISSN -doi ... DOI -url ... URL -\endtt - - -\seccc Summary of options - -\begtt \catcode`\<=13 -aumax:<number> ... maximum number of printed authors -aumin:<number> ... number of printed authors if aumax exceeds -autrim:<number> ... full Firstnames iff number of authors are less than this -auprint:{<value>} ... text instead authors list (\AU macro may be used) -edmax, edmin, edtrim ... similar as above for editors list -edprint:{<value>} ... text instead editors list (\ED macro may be used) -titlepost:{<value>} ... text after title -yearprint:{<value>} ... text instead real year (\YEAR macro may be used) -editionprint:{<value>} .. text instead of real edition (\EDN macro may be used) -urlalso ... the ``available also from'' is used instead ``available from'' -unpublished ... the publisher etc. fields are not mandatory -nowarn ... no mandatory fields -\endtt - -Other options in the option field are silently ignored. |