diff options
Diffstat (limited to 'support/digestif/data/amsrefs.sty.tags')
-rw-r--r-- | support/digestif/data/amsrefs.sty.tags | 612 |
1 files changed, 612 insertions, 0 deletions
diff --git a/support/digestif/data/amsrefs.sty.tags b/support/digestif/data/amsrefs.sty.tags new file mode 100644 index 0000000000..21bcad5c01 --- /dev/null +++ b/support/digestif/data/amsrefs.sty.tags @@ -0,0 +1,612 @@ +-- Copyright 2001-2004, 2007, 2008, 2010-2013 American Mathematical Society +-- Copyright 2022 Augusto Stoffel +-- SPDX-License-Identifier: LPPL-1.3c+ +-- +-- Adapted from the amsrefs package documentation, which can be found +-- at https://ctan.org/pkg/amsrefs. +ctan_package = "amsrefs" +package = { + options = { + alphabetic = { + details = [[ +This generates alphabetic labels similar to the `alpha` BibTeX +style, consisting of the first letter(s) of each author name plus the +year of publication. +]] + }, + shortalphabetic = { + details = [[ +This generates a shorter alphabetic label using only the first letter +of each author name. +]] + }, + ["author-year"] = { + details = [[ +This switches to the popular author-year citation format, similar to +that described in The Chicago Manual of Style. +]] + }, + y2k = { + details = [[ +When using the `alphabetic` option, normally only the last two digits +of the year are used in the label. The `y2k` option instructs amsrefs +to use the full year. +]] + }, + ["non-compressed-cites"] = { + details = [[ +Turn off range compression; citations will still be sorted. Range +compression is also automatically turned off if amsrefs detects that +the hyperref package has been loaded. (In order for this to work +correctly, the hyperref package must be loaded after the amsrefs +package.) +]] + }, + ["non-sorted-cites"] = { + details = [[ +Turn off range sorting. This also turns off range compression as a +side-effect. +]] + }, + abbrev = { + details = [[ +This is equivalent to requesting all four of the options `initials`, +`short-journals`,`short-months` and `short-publishers`. +]] + }, + initials = { + details = [[ +Replace the given names of all authors, editors, and translators with +their initials. +]] + }, + ["short-journals"] = { + details = [[ +Print short form instead of full form for journal names. This works +only with abbreviations defined with the `\DefineJournal` command. +]] + }, + ["short-months"] = { + details = [[ +Print short version of month names (e.g., Jan. instead of January). +This works only when you write all dates in ISO 8601 format. +]] + }, + ["short-publishers"] = { + details = [[ +Print short form instead of full form for publisher names. This works +only with abbreviations defined with the `\DefinePublisher` command. +]] + }, + backrefs = { + details = [[ +This option causes “back-references” to be printed at the end of each +bibliography entry to show what page it was cited on. This option +will work only if the hyperref package is installed. +]] + }, + ["bibtex-style"] = { + details = [[ +By default, amsrefs formats references using the AMS house style. The +`bibtex-style` option instructs it to use a format that is very +similar to the one implemented by the standard BibTeX styles (plain, +alpha, abbrv, and unsrt). +]] + }, + ["citation-order"] = { + details = [[ +This option applies only when using amsrefs in conjunction with +BibTeX. Consequently, changing this option will have no effect until +after the next bibtex run. + +The `citation-order` option corresponds to the standard BibTeX style +unsrt, where items are printed in the reference list in the order in +which they are cited in the document. +]] + }, + lite = { + details = [[ +Suppress the loading of the following packages, which amsrefs +will normally automatically load: + + - mathscinet: Define a number of special characters and accents that + are sometimes encountered when downloading data from MathSciNet. + + - txtcmds: Provide shorthand commands for a number of characters + that are usually specified via ligatures (e.g., -- for an en-dash + or ?` for ?. Using these ligatures can cause problems if you're + using fonts other than the Computer Modern Roman family or if you + want to make it easy to convert your document to, say, HTML. + LaTeX does provide macros for these characters, but their names + tend to be rather unwieldy (e.g., `\textendash` and + `\textquestiondown`, so txtcmds provides shorter names (`\ndash` + and `\qd` in this case). +]] + }, + ["msc-links"] = { + details = [[ +Redefine the `\MR` command to create hypertext links to the +MathSciNet database. This option will work only if the hyperref +package is installed. +]] + }, + nobysame = { + details = [[ +If two or more consecutive bibliography items have the same authors, +amsrefs will normally replace the author names in the second and +succeeding entries by a horizontal rule. This option disables this +feature, causing the full author names to always be printed. +]] + } + } +} +commands= { + bibselect = { + summary = "Read \\bib entries from an ltb file.", + action = "input", + filename = "?.ltb", + arguments = { + { + meta = "*", + summary = "If present, print all bibliography items, including not cited.", + optional = true, + type = "literal" + }, + { + meta = "files", + summary = "A list of files with ltb extension." + } + } + }, + bib = { + action = "amsrefs_bib", + summary = "Create a bibliogprahy item.", + arguments = { + { + meta = "label" + }, + { + meta = "type", + keys = { + article = { + details = [[ +A relatively short but self-contained item that is typically published +as part of a larger collection, such as a journal, a conference +proceedings, an edited collection published as a book, or even as part +of a World Wide Web document. +]] + }, + book = { + details = [[ +A written work by one or more authors where the authors share credit +for the work as a whole. For compatibility with BibTeX, the following +entry types are available as aliases for book: collection, +proceedings, manual, and unpublished. +]] + }, + misc = { + details = [[ +Anything that doesn’t fit into one of the other types. +]] + }, + report = { + details = [[ +A technical report, white paper, or the like. Similar to an article +but usually published and distributed by an organization such as a +university or corporation whose primary business is usually not +publishing. Also known as a techreport. +]] + }, + thesis = { + details = [[ +Like report but produced by the author for an educational institution +to satisfy the requirements for a degree. Not (normally) produced by +a commercial publisher for sale. +]] + }, + webpage = { + details = [[ +An online resource. It is limited to the following fields: accessdate, +author, date, note, subtitle, title, url. +]] + } + } + }, + { + meta = "fields", + keys = { + accessdate = { + details = [[ +Used to specify the date on which a webpage was viewed, as opposed to +the date on which the resource was last modified, which would be put +in the date field. +]] + }, + address = { + details = [[ +Usually the address of the publisher or other issuing organization, +but inside the conference compound field it refers to the address of +the conference. +]] + }, + booktitle = { + details = [[ +Used in the article type to specify the title of the book in which the +article appeared. If anything other than a simple book title is +required, the book compound field should be used instead. +]] + }, + date = { + details = [[ +Usually the date of publication, except inside the conference field, +where it is the date of the conference. + +This replaces BibTeX's year and month fields. Its value should be +written in ISO 8601 format, e.g., 1967-02-24. The day and/or month +can be omitted, so all of the following are valid representations of +February 24, 1967: +``` +date={1967-02-24} +date={1967-02} +date={1967} +``` +Using this format allows amsrefs maximum flexibility in formatting +dates, for example, by allowing month names to be printed in full or +abbreviated as necessary. + +For Winter, Spring, Summer, Fall, either use month numbers of 13, 14, +15, 16 (respectively) or just put in the text before the year: +``` +date={Summer 1987}, +``` +For compatibility, year is provided as an alias for date, but its use +is discouraged. +]] + }, + edition = { + details = [[ +For books or reports. If the value of this field is a simple number, +bib will convert it to cardinal form and add “ed.” (or alternative +text if specified by the bibliography style). Otherwise it will be +printed as is. +]] + }, + eprint = { + details = [[ +Electronic preprint information such as for <www.arXiv.org>. See +<http://xxx.lanl.gov/help/faq/references> for recommended form. +]] + }, + hyphenation = { + details = [[ +This corresponds to the Babel package notion of language. The +hyphenation language used for a given bib entry is determined from +various clues, which are checked in the following order: + +- The Babel language specified by the hyphenation field. + +- The Babel language specified by the \emph{first word} of the + language field (after lowercasing). + +- The current Babel language that was in effect before the \cn{bib} + command started. + +- The current hyphenation patterns of the document, if there are no + Babel language modules loaded. + +The hyphenation field applies to an entire entry. To change the Babel +language for a single field, see the discussion of the language +attribute. +]] + }, + journal = {}, + label = { + details = [[ +When the alphabetic or shortalphabetic options are used, amsrefs will +usually try to generate the label on its own. If necessary, you can +override the automatically generated label by specifying a label +field. +]] + }, + language = { + details = [[ +Language of the work. The language name should be the printed form, +not a Babel-style language name, since in principle this field could +contain more complicated remarks such as “Russian, with French +abstract”. +]] + }, + note = { + details = [[ +Any additional information that does not fit into one of the other +fields. +]] + }, + number = { + details = [[ +The issue number of the journal for an article or the technical report +number for a report. +]] + }, + organization = { + details = [[ +The school, university, corporation, or other nonpublisher +organization that issued the document. +]] + }, + pages = {}, + part = {}, + publisher = {}, + series = {}, + setup = { + details = [[ +This is a special field that can be used to give arbitrary commands to +be executed at the beginning of the current bib entry, after all the +fields have been read. The idea is that one can alter the formatting +of an individual entry through this field to handle special cases. +]] + }, + status = { + details = [[ +Typically used for notes such as “to appear” or “in preparation” +or “unpublished” with journal articles. +]] + }, + subtitle = { + details = [[ +Typically used with a multipart journal article to give a subtitle for +each part, but it can also be used for books. +]] + }, + type = { + details = [[ +The type of a thesis, e.g., “Master's Thesis” or “Ph.D. Thesis”. +]] + }, + xref = { + }, + author = { + details = [[ +The authors of the item. If there are other contributors that should +be acknowledged, they should be listed in contribution fields. +]] + }, + editor = { + details = [[ +The editors of the item. If there are other contributors that should +be acknowledged, they should be listed in contribution fields. +]] + }, + translator = { + details = [[ +The translators of the item. If there are other contributors that +should be acknowledged, they should be listed in contribution fields. +]] + }, + isbn, issn = { + details = [[ +An International Standard Book or Serial Number. (These are not +printed by the standard styles, but are reserved for future use.) +]] + }, + review = { + details = [[ +A review number or similar pointer to, for example, Mathematical +Reviews or Zentralblatt. You must supply any special markup for the +number; i.e., you should write + + review={\MR{2015463}} + +instead of + + review={2015463} +]] + }, + book = { + details = [[ +This is used for conference articles to make it easier to +differentiate between an article and the book or proceedings that it +appeared in. The book field can contain any of the following +subfields: title, part, subtitle, edition, editor, translator, +contribution, series, volume, publisher, organization, address, date, +note. + +It is often used in conjunction with the conference field. +]] + }, + conference = { + details = [[ +The conference field can contain a title, address, and date. + + \bib{Burkholder1986a}{article}{ + author={Burkholder, Donald L.}, + title={Martingales and Fourier analysis in Banach spaces}, + conference={ + title={C.I.M.E. Lectures}, + address={Varenna, Italy}, + date={1985} + }, + book={ + series={Lecture Notes in Math.}, + volume={1206}, + publisher={Springer-Verlag}, + address={Berlin and New York}, + date={1986}, + }, + pages={61--108}, + review={\MR{0864712}} + } +]] + }, + contribution = { + details = [[ +This field can be repeated as many times as necessary to list any +contributors other than authors, editors, or translators. + + contribution={ + type={illustrations}, + author={Gorey, Edward} + } + +which in the default style produces + + with illustrations by Edward Gorey + +Since contributions are potentially complicated, so is the +contribution field: + +- Sometimes it is necessary to add additional material to the type in + order to produce intelligible text: + + contribution={ + type={an appendix}, + author={Doe, John} + } + +- amsrefs tries very hard to format multiple contributions, each of + which may have multiple authors, in an appropriate way. However, + there might be cases where the default rules aren't flexible enough, + in which case you can instead use the contribution field as a simple + field and format it exactly the way you want: + + contribution={some arbitrary text about contributions} + +This feature should only be used as a last resort, though. +]] + }, + partial = { + details = [[ +This is used with the article type for multipart articles. Like the +contribution field, it is repeatable. It can contain any of the +following fields: part, subtitle, contribution, journal, volume, date, +number, pages. + + \bib{Zho-fan1972}{article}{ + author={Zho-fan, Z.}, + title={Monomials}, + partial={ + part={I}, + journal={Tot. Math.}, + volume={19}, + date={1972}, + pages={335--350} + }, + partial={ + part={II}, + journal={Tot. Math.}, + volume={20}, + date={1973}, + pages={19--37} + } + } +]] + }, + reprint = { + details = [[ +This can be used inside an article to indicate another place (usually +a book) where the article can also be found. It can contain any field +that the book type can. + + \bib{Sokal96}{article}{ + title={Trangressing the boundaries}, + subtitle={Toward a transformative hermeneutics of quantum + gravity}, + author={Sokal, Alan}, + journal={Social Text}, + volume={46/47}, + date={1996}, + pages={217--252}, + reprint={ + title={Fashionable Nonsense}, + subtitle={Postmodern Intellectuals' Abuse of Science}, + author={Sokal, Alan}, + author={Bricmont, Jean}, + publisher={Picador USA}, + address={New York}, + date={1998} + } + } +]] + }, + translation = { + details = [[ +This is the only compound field that can be used with any bibliography +type. It can contain any field that its parent type can contain. +]] + } + } + } + } + }, + citelist = { + details = [[ +This is used to group a number of individual `\cite` commands into a +single citation. Among other things, this makes it possible to add an +optional argument to any of the `\cite` commands unambiguously: + + \citelist{\cite{xx} \cite{yy}*{Theorem 4.9} \cite{zz}} + +Note that there is no punctuation or other text between the `\cite +commands. Any necessary commas or other punctuation will be supplied +automatically. Any attempts to supply it by hand will backfire. +]] + }, + cites = { + action = "cite", + arguments = {{meta = "labels"}}, + details = [[ +This is a variant of citelist, provided for convenience: + + \cites{aa,bb,cc} + +is equivalent to + + \citelist{\cite{aa}\cite{bb}\cite{cc}} + +Note that cites does not take an optional arguments. +]] + }, + nocite = { + action = "cite", + arguments = {{meta = "labels"}}, + details = [[ +This continues to work the same way that it does in standard LaTeX +when used with BibTeX, but see the manual for limitations when it is +used with bibselect and ltb files. +]] + }, + ocite = { + action = "cite", + arguments = {{meta = "label"}}, + summary = "Cite as an object.", + action = "cite" + }, + ycite = { + action = "cite", + arguments = {{meta = "label"}}, + summary = "Cite year.", + action = "cite", + }, + DefineName = { + arguments = { + {meta = "label"}, + {meta = "text"} + } + }, + DefinePublisher = { + arguments = { + {meta = "label"}, + {meta = "text"} + } + }, + DefineJournal = { + arguments = { + {meta = "label"}, + {meta = "text"} + } + } +} +environments = { + bibdiv = {}, + biblist = {} +} |