summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-07-18 23:29:16 +0000
committerKarl Berry <karl@freefriends.org>2013-07-18 23:29:16 +0000
commit549f87a2032890440c9d3fc9faa568628588e2b3 (patch)
treea3f51974b1e68ac611e7a047d82c369e5ad8a64e /Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex
parent16369bdd3c6726591b6196400880febbfb529a2e (diff)
biblatex-gost (18jul13)
git-svn-id: svn://tug.org/texlive/trunk@31233 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex124
1 files changed, 93 insertions, 31 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex b/Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex
index 09d399f0d5d..ca069df8cd6 100644
--- a/Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-gost/biblatex-gost.tex
@@ -15,12 +15,13 @@
\usepackage{rotating}
\usepackage{comment}
\usepackage[inline]{enumitem}
-\usepackage{isodate}
+%\usepackage{isodate} % bug?
\usepackage[backend=biber,
bibstyle=gost-standard,
]{biblatex} % to receive \bbx@gost@version, etc.
\usepackage{indentfirst}
\usepackage{paratype}
+\usepackage{wrapfig}
\hypersetup{unicode=true}
@@ -30,6 +31,8 @@ bibstyle=gost-standard,
\newcommand*{\biblatexctan}{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/}
\newcommand*{\biblatexgost}{Biblatex-GOST\xspace}
\newcommand*{\biblatexgosthome}{http://sourceforge.net/projects/biblatexgost/}
+\newcommand*{\biblatexgostctan}
+ {http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex-contrib/biblatex-gost/}
\makeatletter
\titlepage{%
@@ -146,16 +149,24 @@ maintained.
\subsection{Установка}
\label{sec:install}
-Пакет поставляется в виде архива, содержащего стандартую структуру дерева TDS.
-Для его установки достаточно распаковать архив в дерево \tex, желательно локальное, и
-обновить индексы (в \tex~Live, например, это делается командой \texttt{mktexlsr},
-в MiK\tex~--- \texttt{initexmf -{}-update-fndb}).
+Пакет входит в \tex~Live, MiK\tex и другие дистрибутивы и может быть установлен
+с помощью их менеджеров пакетов. Для установки вручную скачайте архив
+\texttt{biblatex-gost-\prm{версия}.tds.zip}, содержащий стандартую структуру дерева TDS.
+Распакуйте его в локальное дерево \tex'а и
+обновите индексы (в \tex~Live, например, это делается командой \texttt{mktexlsr},
+в MiK\tex~--- \texttt{initexmf -{}-update-fndb}). Обратите внимание, что директория,
+в которую менеджер пакетов устанавливает пакет в конкретном дистрибутиве,
+определяется разработчиками этого дистрибутива.
+Эта директория может отличаться (и отличается!) от директории
+в вышеупомянутом архиве, поэтому при ручной установке лучше распаковывать
+архив в локальное, а не общее дерево \tex'а.
Для работы \biblatexgost версии \makeatletter\bbx@gost@version\makeatother\
требуются, как минимум,
-\biblatex~2.5\fnurl{http://sourceforge.net/projects/biblatex/files/biblatex-2.5/}
-и \biber~1.5\fnurl{http://sourceforge.net/projects/biblatex-biber/files/biblatex-biber/1.5/}.
-%(текущие версии на CTAN). Пакет не будет работать с предыдущими версиями.
+\biblatex~2.7\fnurl{http://sourceforge.net/projects/biblatex/files/biblatex-2.7/}
+и \biber~1.7\fnurl{http://sourceforge.net/projects/biblatex-biber/files/biblatex-biber/1.7/}.
+%(текущие версии на CTAN).
+Пакет не будет работать с предыдущими версиями.
\subsection{Важные изменения в этой версии}
\label{sec:critchanges}
@@ -165,6 +176,18 @@ maintained.
модификации могут оказаться значительными. Более полный список изменений см.
в \Apxref{apx:changelog}.
+\subsubsection*{Версия 0.9}
+
+\begin{trivlist}
+\item Переход на \biblatex~2.7 и \biber~1.7
+\item Опция \opt{related} по умолчанию установлена в \opt{true}, так же как в \biblatex
+\item Обработка поля \bibfield{related} приведена в соответствие с \biblatex,
+ в связи с чем изменилось оформление.
+\item Опция \opt{labelyear} заменена на \opt{labeldate}, в связи с изменениями
+ в \biblatex.
+%\item Исправлена ошибка несовместимости с \texttt{polyglossia}.
+\end{trivlist}
+
\subsubsection*{Версия 0.8}
\begin{trivlist}
@@ -292,7 +315,7 @@ maintained.
работ одного года. Поэтому в \biblatexgost используется несколько способов оформления
ссылок, которые выбираются опцией \opt{mergedate} (см.~\secref{sec:newoptions}).
В частности, значение опции \kvopt{mergedate}{goststrict} соответствует строгому
-следованию ГОСТу, хотя при этом могут появляться неопределённые ссылок.
+следованию ГОСТу, хотя при этом могут появляться неопределённые ссылки.
Стиль чувствителен к опции \opt{singletitle} и может не выводить год в ссылке, если он
не требуется для устранения неопределённости (например, если имеется лишь одна публикация
данного автора или лишь одна публикация без автора с данным названием).
@@ -332,14 +355,14 @@ maintained.
Все стили имеют <<минимальный>> вариант, в котором выводится минимальное количество
сведений~--- автор, название, том\slash часть\slash книга\slash выпуск,
выходные данные, страницы (для статей в журналах и книгах).
-Сведения об ответственности, издании, серии и т.\,д. не выводятся, вне зависимости от их присутствия
-в базе данных. При этом вывод сведений, для которых в \biblatex имеются специальные опции
+Сведения об ответственности, издании, серии и т.\,д. не выводятся, вне зависимости от их присутствия в базе данных.
+При этом вывод сведений, для которых в \biblatex имеются специальные опции
(\opt{url}, \opt{doi}, \opt{isbn/issn/isrn}, \opt{eprint}), регулируется
этими опциями (а также опциями \opt{cite\ldots} и \opt{bib\ldots},
описанными в \secref{sec:newoptions}). По умолчанию в минимальных стилях этот вывод отключён.
-Минимальные стили можно использовать совместно с полными. Например,
-при установке
+Минимальные стили можно использовать совместно с полными.
+Например, при установке
\begin{ltxcode}
\usepackage[%
@@ -353,6 +376,13 @@ maintained.
Разумеется, это не имеет значения для стилей \bibsty{gost-numeric-min} и
\bibsty{gost-authoryear-min}, которые <<минимизируют>> оформление библиографии, но не цитат.
+Кроме того, если вы для цитат используете полный стиль, но одну из них вам нужно привести
+в минимальном, поставьте перед ней
+
+\begin{ltxcode}
+\AtNextCite{\renewbibmacro*{cite:clearfields}{\usebibmacro{setup:min}}}.
+\end{ltxcode}
+
\end{marglist}
\starsdelim
@@ -630,6 +660,7 @@ ISSN серии или подсерии & issn (isbn) \\
Общее обозначение материала (\gostbibref{5.2.3}). В \tabref{tab:media} приведены
допустимые значения этого поля вместе с соответствующими терминами ГОСТа.
+
\begin{table}[htbp]
\tablesetup
\centering
@@ -750,6 +781,14 @@ series = {|Языковеды мира / редкол.: Г.В. Степанов
При заполнении базы данных, эта серия помещается в поле \bibfield{series}.
+В случае двух серий, они должны выводиться последовательно, каждая в круглых скобках, и
+разделяться пробелом (см.~\gostbibref{}{5.7.16}).
+Этого можно добиться следующим образом:
+
+\begin{lstlisting}[style=bibtex,escapechar=|]
+series = {|Полное собрание сочинений : для фортепиано ; т. 1) (Классика мировой музыки|},
+\end{lstlisting}
+
Во-вторых, серия может входить в заглавие журнала:
\begin{bibexample}
@@ -920,10 +959,11 @@ introduction & вступительная статья \prm{кого} & всту
Издание может разделяться на физически отдельные части, которые могут называться по-разному. \biblatexgost поддерживает деление на тома, книги, части и выпуски.
Соответствующие им поля базы данных показаны в \tabref{tab:volsparts}.
-\begin{table}[htbp]
+\begin{wraptable}{r}{0pt}
+%\begin{table}[htbp]
\tablesetup
\centering
-\begin{tabularx}{.6\textwidth}{@{}L{.3\textwidth}@{}V{.3\textwidth}@{}}
+\begin{tabularx}{.4\textwidth}{@{}L{.2\textwidth}@{}V{.2\textwidth}@{}}
\toprule
\multicolumn{1}{@{}H}{Части издания} &
\multicolumn{1}{@{}H}{Поле \biblatex} \\
@@ -939,7 +979,8 @@ introduction & вступительная статья \prm{кого} & всту
\end{tabularx}
\caption{Обозначение частей издания}
\label{tab:volsparts}
-\end{table}
+%\end{table}
+\end{wraptable}
Если эти поля являются целыми числами, то они выводятся в виде: \enquote{В 5 т.},
\enquote{В 4 вып.} и т.\,д. В противном случае, они выводятся как есть: \enquote{В
@@ -1354,9 +1395,8 @@ gost-authoryear-min & --- & false \\
нужные для работы опции \opt{inbookibid}, присутствуют в вашем тексте хотя бы в
аргументе команды \cmd{nocite}.
-Опция относится ко всем записям типа \bibtype{inbook}, \bibtype{bookinbook},
-\bibtype{suppbook}, \bibtype{incollection}, \bibtype{inproceedings} и т.\,д.,
-но не работает для \bibtype{article}.
+Опция относится к записям типа \bibtype{article}, \bibtype{inbook}, \bibtype{bookinbook},
+\bibtype{suppbook}, \bibtype{incollection}, \bibtype{inproceedings} и т.\,д.
\choitem[gostletter]{mergedate}{goststrict, gostletter, gostlabel}
@@ -1371,18 +1411,19 @@ gost-authoryear-min & --- & false \\
Во-вторых, на своём обычном месте в самой записи.
Данная опция определяет, каким образом выводится вторая дата:
-\begin{enumerate*}[label=\arabic*)]
+\begin{enumerate}[label=\arabic*)~]
\item как обычно (\kvopt{mergedate}{false}),
\item выводит дату только для меток с добавленной буквой (\kvopt{mergedate}{minimum}),
\item выводит дату только для меток с добавленной буквой, если
она является просто годом (\kvopt{mergedate}{basic}),
\item дата вообще не выводится на своём обычном месте (\kvopt{mergedate}{maximum}),
\item то же, но поле \bibfield{issue} всё же выводится
-(\kvopt{mergedate}{compact {\rmfamily или} true})
-\end{enumerate*}
-(подробнее см. примеры в документации \biblatex).
-\biblatexgost сохраняет все эти опции, но, поскольку ГОСТ не предусматривает вывод даты после
-автора, то добавляет ещё три. Все они чувствительны к опции \opt{singletitle} и могут опускать
+(\kvopt{mergedate}{compact {\rmfamily или} true}).
+\end{enumerate}
+Подробности см. в документации \biblatex, в примерах.
+\biblatexgost сохраняет все эти опции, но поскольку ГОСТ не предусматривает вывод даты после
+автора, то добавляет ещё три.
+Все они чувствительны к опции \opt{singletitle} и могут опускать
дату, если она не требуется для устранения неопределённости.
\begin{valuelist}
@@ -1415,12 +1456,17 @@ gost-authoryear-min & --- & false \\
использовании этой опции вам может
потребоваться вручную настроить сортировку, например, при помощи поля \bibfield{sortkey}.
+В настоящее время эта опция вряд ли необходима.
+Последние версии \biblatex имеют очень гибкий механизм настройки меток для стилей типа
+\bibsty{alphabetic}, с помощью которого можно обеспечить ту же функциональность.
+См.~описание команды \cmd{DeclareLabelalphaTemplate} в документации \biblatex.
+
\item[goststrict]
Эта опция призвана обеспечить максимальное соответствие требованиям ГОСТа,
хотя при этом могут возникать неопределённые ссылки.
Никаких знаков к году не добавляется, и вам нужно самим следить за
-уникальностью ссылок (\biblatexgost выводит предупреждение при их обнаружении).
+уникальностью ссылок (\biblatexgost выводит предупреждение при обнаружении неуникальности).
Например, если вы делаете ссылки на тома многотомного издания, то вам, возможно,
понадобится указать том в \prm{postnote} или воспользоваться командами типа \cmd{volcite}.
@@ -1435,7 +1481,7 @@ gost-authoryear-min & --- & false \\
Опция разрешает или запрещает перемещение имён в область сведений об ответственности,
если количество имён больше трёх.
-При наличии 4-х и более имён авторов, редакторов, переводчиков и т.\,д. ГОСТ позволяет на
+При наличии 4-х и более имён авторов, редакторов, переводчиков и пр. ГОСТ позволяет на
выбор либо выводить их полный список, либо сокращать его до
одного имени с добавлением [et al.], [и др.] и пр.
При этом сами имена выводятся не в заголовке библиографической записи,
@@ -1457,12 +1503,12 @@ gost-authoryear-min & --- & false \\
регулируется в \biblatexgost (особенности реализации см. в~\apxref{impl:4names}).
Впрочем, изменение этого количества означало бы отступление от ГОСТа.
-\choitem[bib]{related}{true, false, bib, cite}
+\choitem[true]{related}{true, false, bib, cite}
Дополнительно к имеющимся в \biblatex значениям опции \opt{related}, полностью разрешающим
или запрещающим вывод поля \bibfield{related}, в \biblatexgost определены значения, позволяющие
-делать это отдельно для цитат и библиографии. По умолчанию установлено \kvopt{related}{bib},
-т.\,е. поле \bibfield{related} выводится в библиографии, но не в цитатах.
+делать это отдельно для цитат и библиографии. По умолчанию установлено \kvopt{related}{true},
+т.\,е. поле \bibfield{related} выводится и в библиографии, и в цитатах.
\choitem{sorting}{ntvy}
\label{sorting}
@@ -1596,7 +1642,7 @@ gost-authoryear & cite & Автор (заголовок) и год в текст
последний может и отсутствовать):
\begin{bibexample}
-\item{} [Детская энциклопедия, 2001, с.\,33]
+\item{} [Детская энциклопедия, 1966b, с.\,33]
\end{bibexample}
\begin{comment}----------------------------------------------------------------
@@ -1833,6 +1879,22 @@ pageref & + & + & + & + & + & + & + & + & + & + & + & + & + & + & +\tabularnewli
\begin{changelog}
+\begin{release}{0.9}{17-07-2013}
+\item Переход на \biblatex~2.7 и \biber~1.7.\see{sec:install}
+\item Переработан механизм \opt{bookibid}, он теперь чувствителен к трекерам
+ \biblatex, работает для \bibtype{article}, были исправлены ошибки, например,
+ отсутствие гиперссылок в некоторых случаях.\see{sec:newoptions}
+\item Обработка поля \bibfield{related} приведена в соответствие с \biblatex,
+ в связи с чем изменилось оформление.
+ Кроме того, по умолчанию опция \opt{related} установлена в \opt{true}.\see{sec:newoptions}
+\item Опция \opt{labelyear} заменена на \opt{labeldate}, в связи с изменениями
+ в \biblatex.
+\item Обновлён файл локализации.
+\item Обновлён и пополнен файл примеров.
+\item Исправлена ошибка несовместимости с \texttt{polyglossia}.
+\item Исправлены разные ошибки.
+\end{release}
+
\begin{release}{0.8}{03-04-2013}
\item The package status has been changed from \emph{author-maintained} to \emph{maintained}
%\item Переход на \biblatex~2.4 и \biber~1.4\see{sec:install}