diff options
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/gost/README.md')
-rw-r--r-- | Master/texmf-dist/doc/bibtex/gost/README.md | 327 |
1 files changed, 327 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex/gost/README.md b/Master/texmf-dist/doc/bibtex/gost/README.md new file mode 100644 index 00000000000..6a70110f211 --- /dev/null +++ b/Master/texmf-dist/doc/bibtex/gost/README.md @@ -0,0 +1,327 @@ +GOST is a bundle of BibTeX styles designed to match the State Standards (GOST) +on information, librarianship and publishing issued by The Russian Federation +and Interstate Committee of former USSR States. + +It may be distributed and/or modified under the conditions of the LaTeX +Project Public License, either version 1.3 of this license or (at your +option) any later version. The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX + version 2005/12/01 or later. + +The System of Standards includes: +GOST 7.0.5-2008 Bibliographic reference. + General requirements and rules of making. +GOST 7.1 -2003 Bibliographic record. + Bibliographic description. + General requirements and rules. +GOST 7.80 -2000 Bibliographic record. + Heading. General requirements and rules. +GOST 7.11 -2004 Bibliographic description and references. + Rules for the abbreviation of words and word combinations + in foreign European languages. +GOST 7.83 -2001 Electronic editions. Basic types and imprint. +Etc. + +GOST comprises 16 BibTeX styles to format bibliography in English, Russian +and Ukrainian according to GOST 7.0.5-2008 and GOST 7.1-2003. Both 8-bit +and Unicode (UTF-8) versions of each BibTeX style, in each case offering +a choice of sorted and unsorted. Further, 2 more styles, |gost780| and +|gost780s| styles (not conforming to effective standards) are retained +for backwards compatibility. + +All BibTeX styles are derived from same master file |gost.dtx| by applying +different set of options as shown in the table below. + +------------------------------------------------------------------------ + Style | utf8 | strict | modern | eprint | long | sort | natbib +------------------------------------------------------------------------ + gost780 | | | | | | | + gost780s | | | | | | + | +------------------------------------------------------------------------ + gost2003 | | + | | + | | | + gost2003s | | + | | + | | + | + gost2008 | | | + | + | | | + gost2008n | | | + | + | | | + + gost2008l | | | + | + | + | | + gost2008s | | | + | + | | + | + gost2008ns | | | + | + | | + | + + gost2008ls | | | + | + | + | + | +------------------------------------------------------------------------ + ugost2003 | + | + | | + | | | + ugost2003s | + | + | | + | | + | + ugost2008 | + | | + | + | | | + ugost2008n | + | | + | + | | | + + ugost2008l | + | | + | + | + | | + ugost2008s | + | | + | + | | + | + ugost2008ns | + | | + | + | | + | + + ugost2008ls | + | | + | + | + | + | +------------------------------------------------------------------------ + Style | utf8 | strict | modern | eprint | long | sort | natbib +------------------------------------------------------------------------ + +|Gost2008| style is recommended for most applications. It corresponds to the +currently effective Standard 7.0.5-2008. Librarians should use the style +|gost2003| instead of |gost2008| to compile a library catalog to meet the +Standard 7.1-2003. Use of other styles is best explained through +the meaning of options used to compile those styles from the master source. + +Two styles, |gost780| and |gost780s|, generated without |modern| and +|strict| options, are retained for backward compatibility. They do not +conform the Standards 7.0.5-2008 and 7.1-2003 cited above. + +The |strict| option provides conformance to the Standard 7.1-2003. The +styles compiled with that option bear the name |gost2003| with possible +suffixes |s|, |l|, |n| as explained below. These styles are intended +primarily for the librarians who compose a library catalog. + +The |modern| option meets the Standard 7.0.5-2008 which can be thought +off as a relaxed version of the Standard 7.1-2003. The styles compiled with +that option bear the name |gost2008| with possible suffixes |s|, |l|, |n|. +The |strict| option has precedence over |modern| so that a style compiled +with both options will resemble mainly the |gost2003| style rather than +|gost2008|. + +If the number of authors exceeds 4, modern styles cut the list of authors +to at most 4 persons as prescibed by the Standards. The option +|long| overrides this rule to provide backward compatibility with the +package disser by Stanislab Kruchinin. Two styles, |gost2008l| and +|gost2008ls|, compiled with the option |long| mimic behavior of the styles +|gost705| and |gost705s| from the disser package. Major +effect of the |long| option is that the list of authors always +precedes book or article title no matter how long is it. +Modern styles compiled without |long| place long list of authors behind +the title. The names of styles compiled with the option |long| has the +suffix |l|. Recall that those styles do not conform effective Standards and +their use is discouraged. + +The |eprint| option enables formatting electronic publications. In particular, +it enables |eprint|, |eprinttype|, |eprintclass|, and |doi| fields for a +bibliographic entry. The styles, generated without the |eprint| option, +just ignore these fields. Starting from the version 1.2 of the GOST package, +all modern styles are compiled with this option included, and therefore the +suffix |e| which designated this option in earlier versions is not appended +to the name of style any more. + +The |natbib| option provides compatibility with the |natbib| package. The names +of styles compiled with the option |natbib| bear the suffix |n|. Currently +4 styles with that option are available for public use. + +The |sort| option enables sorting bibliographic references by author names +and titles of references. The names of styles compiled with the option |sort| +bear the suffix |s|. Sorting does not work as expected for databases in +unicode encoding (see below). + +Finally, the |utf8| option produces bibliographic styles in unicode rather +that in 8-bit encoding. Names of those styles bear the prefix |u|. + + +Beyond bibliographic style, GOST bundle contains CS files (codepage and +sorting order). + +---------------------------------------------------------------- + Encoding | CSF Sorting order +---------------------------------------------------------------- + cp866 | ruscii.csf Cyrillic first, Latin + cp1251 | cp1251.csf Cyrillic first, Latin + koi8-u | koi8u.csf Cyrillic first, Latin + utf8 | utf8cyrillic.csf Cyrillic first, Latin +---------------------------------------------------------------- + +In addition, BibTeX8 distribution comes with few more CSFs. + +---------------------------------------------------------------- + Encoding | CSF Sorting order +---------------------------------------------------------------- + cp866 | cp866rus.csf Latin first, Cyrillic +---------------------------------------------------------------- + + +How to use + +1. Select bibliography style by adding appropriate \bibliographystyle + declaration to your source file <filename>.tex, e.g. + + \bibliographystyle{gost2008} + \bibliography{database} + +2. Add the field language="ukrainian" or language="russian" to the + bibliographic entries in Ukrainian or Russian languages in your + database; English is the default language. German, Italian and + French are partially supported. + +3. To compile list of references from your database use bibtex8.exe + rather than bibtex.exe. Depending on the codepage of your + bibliographic database, indicate one of the CS files + listed above as option to bibtex8.exe. Run LaTeX, then run + bibTeX8 and again LaTeX: + + latex <filename>.tex + bibtex8 -B -c <csf_file>.csf <filename>.aux + latex <filename>.tex + +4. For details on preparing bibliographic database see + examples in |gost*.pdf|. + +5. Ugost*.bst styles are primarily intended for use + with unicode compilers (xelatex and lualatex). They + should be preferred as well when using 8bit compilers + (latex and pdflatex) if source file is in utf8 encoding. + +6. Neither bibtex.exe nor bibtex8.exe provide + correct sorting order of unicode text. It means that using + ugost2008s or any other style ended with `s' in + its name may produce unexpected result for utf8 documents. + +7. Bibtex8 fails to change case of a string if it contains Cyrillic + letter in unicode. Therefore ugost2008* styles do not change case of + titles and other parts of bibliographic record while 8-bit styles + do the case change where appropriate. + +8. Either |bibtex8| or |Bibtex8| fail to cut Cyrillic names to + initials. Therefore |ugost2008*| styles do not modify the name of + authors. + +9. Package |natbib| should be loaded when using styles with + suffix |n| in their names. + + +Customization + +Every GOST style defines few commands to format some parts of a +reference. You can redefine these commands prior to +the \bibliography{<bibtex_style>} command. Initial +definitions are listed below. + + \providecommand*{\url}[1]{{\small #1}} + \providecommand*{\BibUrl}[1]{\url{#1}} + \providecommand{\BibAnnote}[1]{} + \providecommand*{\BibEmph}[1]{#1} + +By default, gost styles separate logical parts of a bibliography +record by a period and cyrdash (. "---). It is legitimate to drop +that dash by overriding the command \BibDash as follows + + \providecommand*{\BibDash}{} + +By default, \BibDash is equivalent to the shorthand "--- +introduced by the babel package with the option russian. +It prints a so called Cyrillic dash (\cyrdash), which is +20% shorter than ordinary LaTeX dash (---), and puts +unbreakable space before \cyrdash so that the dash never +appears at the beginning of a line. + + +Where to get from + +1. http://mirror.ctan.org/biblio/bibtex/contrib/gost/ +2. http://ctan.org/pkg/gost + + +What's new in version 1.2i (2017.01.12) + +1. Documentation and examples update (thanks to Leonid Sinev). + +2, Restored @MastersThesis instead of @MasterThesis (thanks to Leonid Sinev). + +3. Media="eresource" field is introduced in addition to the media="online" and + media="text"; if present, the media field is not ignored any more in + modern bst-styles compiled without the strict option. + +4. Location field is introduced as an alias of address field. + +5. @DSCISTHESIS entry renamed to @DOCTHESIS. + +6. School field is now treated as an alias of institution. + +7. Specialitycode is added for @THESIS and similar entries; number is treated as + alias of specialitycode. + +8. Type field in THESIS and similar entries can now accept three values + (mathesis, phdthesis, docthesis) which are translated to built-in + language-sensitive strings; any other value is reproduced literally. + + +What's new in version 1.2h (2016.08.21) + +1. Minor changes in documentation. + + +What's new in version 1.2g (2016.07.25) + +1. Minor changes in documentation. + + +What's new in version 1.2f (2016.07.11) + +1. Support for |@patent| entry added (thanks to Stanislav Kruchinin). +2. medium field renamed to media field. + + +What's new in version 1.2e (2016.07.07) + +1. Hard coded "URL" string replaced with a language sensitive string + (thanks to Roman Budnyi). + + +What's new in version 1.2d (2016.02.18) + +1. jan, feb, mar, e.t.c. month macros fixed; +2. New macro format.month. +3. \cyrdash is now faked via \ProvideTextCommandDefault if not defined. + + +What's new in version 1.2c (2015.01.10) + +1. langid field added; language field supported for backward compatibility. +2. eid field added, it has priority over pages field; +3. Fix Gost2003: "--- replaced by \BibDash; +4. Spacing around \BibDash improved. + + +What's new in version 1.2b (2014.01.19) + +1. numpages renamed to pagetotal. + + +What's new in version 1.2a (2012.08.31) + +1. \cyrdash is now defined via \ProvideTextCommand rather than \providecommand. + + +What's new in version 1.2 (2012.02.22) + +1. Code refactoring. All styles are now generated from single source file. +2. Support for GOST-7.1-2003. The field |medium| is added to reflect type + of material. For most entry types |medium| defaults to |text|. +3. Support for |natbib| package. +4. All modern styles are now compiled with the |eprint| option. + + +What's new in version 1.1 (2012.01.21) + +1. Support for GOST 7.0.5-2008 and GOST 7.1-2003 is provided. +2. |@Online| entry is added to format a reference to electronic + resource on Internet. +3. |@MastersThesis| entry is added to format a reference to master's thesis. + |@DSciThesis| entry is added to format a reference to doctor of + sciences thesis. +4. |Urldate|, |eprint|, |eprintclass|, |eprinttype| fields are added. + + +Version history + +2012.08.31 \cyrdash is now defined via \ProvideTextCommand. +2012.02.22 Support for |natbib| package. +2012.02.02 Adaptation to GOST 7.0.5, electronic publishing. +2005.08.12 First version uploaded to CTAN. +2003.06.06 First public version. + + + +Please, send feature requests and bug reports via e-mail: + kia999 at mail dot ru <Igor A. Kotelnikov> +or + polyama at yahoo dot com <Maksym Polyakov> + +Happy BibTeXing! |