summaryrefslogtreecommitdiff
path: root/biblio/bibtex/contrib/gost/README.md
blob: 6a70110f2115c3ef62d91606538dcd266ddb5a7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
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!