\documentclass[a4paper,10pt]{article} \usepackage[a4paper,includehead,includefoot,mag=1000, left=3cm,right=2cm,top=1cm,bottom=2cm]{geometry} \usepackage{doc,ifpdf,indentfirst,tabularx,color} \definecolor{darkblue}{rgb}{0,0,.6} \ifpdf \usepackage[pdftex,hyperindex,unicode]{hyperref} \usepackage{cmap} \else \usepackage[hypertex]{hyperref} \fi \hypersetup{ pdfusetitle, pdftitle = {User manual for disser package}, pdfauthor = {Stanislav Kruchinin}, pdfsubject = {disser}, pdfstartview = {FitH}, pdfborder = {0 0 0}, bookmarksopen = true, bookmarksnumbered = true, bookmarksopenlevel = 2, colorlinks = true, linkcolor = darkblue, citecolor = darkblue, filecolor = darkblue, menucolor = darkblue, urlcolor = darkblue } \IfFileExists{pscyr.sty}{% \usepackage{pscyr} \renewcommand\ttdefault{cmtt} \renewcommand\rmdefault{ftm} }{ \IfFileExists{cyrtimes.sty}{% \renewcommand\ttdefault{cmtt} \renewcommand\rmdefault{ftm} }{} } \usepackage[T2A]{fontenc} \usepackage[cp1251]{inputenc} \usepackage[english,russian]{babel} \MakeShortVerb{\|} \def\file#1{\texttt{#1}} \def\pkg#1{\textsf{#1}} \def\cmd#1{\texttt{#1}} \def\deflabel#1{\ttfamily #1\hfill} \newenvironment{deflist}[1]{% \begin{list}{}{% \settowidth\labelwidth{\ttfamily #1}% \setlength\leftmargin\labelwidth \addtolength\leftmargin\labelsep \let\makelabel\deflabel} }{\end{list}} \def\fileversion{1.1.5} \begin{document} \sloppy \title{Пакет \pkg{disser}: руководство пользователя } \date{Версия \fileversion} \author{Станислав Кручинин\\[6pt] \normalsize E-mail: \href{mailto:stanislav.kruchinin@gmail.com} {\texttt{stanislav.kruchinin@gmail.com}}} \maketitle \begin{abstract}\noindent Данный документ содержит руководство по использованию пакета \pkg{disser}. Инструкции по установке и обновлению смотрите в файлах \file{README} и \file{README.ru}. Описание исходных текстов содержится в файлах \href{file:disser.pdf}{\file{disser.pdf}}, \href{file:gost732.pdf}{\file{gost732.pdf}} и \href{file:gost705.pdf}{\file{gost705.pdf}}. \end{abstract} \tableofcontents \section{Введение} Пакет \pkg{disser} предназначен для верстки диссертаций и авторефератов в соответствии с требованиями диссертационных советов и ВАК. В состав пакета входят классы \file{disser.cls} и \file{gost732.cls}, стили оформления библиографии \file{gost705.bst}, \file{gost705s.bst}, а также скрипты для сборки пакета и документов (\file{Makefile}, \file{nomake.cmd}, файлы с расширениями \file{mk} и \file{cmd} в каталоге \file{include}). Поскольку дипломы и диссертации имеют фиксированную структуру, в пакет также включены их шаблоны (каталог \file{templates}), которые рекомендуется использовать для создания своих документов. Одной из основных целей создания \pkg{disser} являлось устранение общего недостатка стандартных классов: отсутствия возможности настройки формата элементов титульного листа, заголовков и записей в автоматически генерируемых списках. Для достижения этой цели была переопределена значительная часть команд, входящих в ядро \LaTeX{}, и введен ряд новых переменных, которые описаны в комментариях к исходным текстам. Это позволило значительно упростить разработку пользовательских классов, которые удовлетворяют специфическим требованиями учебных заведений и диссертационных советов. Примером реализации этого подхода является класс \pkg{gost732}. \section{Опции класса} \textbf{Примечание:} полужирным начертанием выделены опции, используемые по умолчанию. \\[2ex] \extrarowheight=3pt \tabcolsep=6pt \arraycolsep=0pt \newcolumntype{L}{>{\raggedright}p{4.5cm}} \begin{tabularx}{\textwidth}{L|X} \hline\hline \multicolumn{2}{c}{\textbf{Стандартные опции}}\\ \hline 8pt, 9pt, 10pt, 11pt, 12pt, \textbf{14pt}, 16pt, 18pt, 20pt & Размер шрифта основного текста. \\\hline \textbf{a4paper}, a5paper, b5paper & Размеры листов. \\\hline landscape & Альбомная ориентация. \\\hline \textbf{oneside}, twoside & Односторонняя или двухсторонняя печать. \\\hline draft, \textbf{final} & Выводить (draft) или нет (final) пометки, фиксирующие переполнение горизонтального блока для данной строки. \\\hline fleqn & Выключные формулы будут выравнены по левому краю, а не по центру. \\\hline leqno & Номера будут размещены слева, а не справа от формул. \\\hline \textbf{openany}, openright & Главы всегда будут начинаться только с нечетных страниц (т.\,е. справа, если смотреть на разворот) или c любых. \\\hline \textbf{onecolumn}, twocolumn & Верстка в один или в два столбца. \\\hline openbib & Блоки текста в списке литературы будут печататься на новых строках и с отступом. \\\hline \textbf{titlepage}, notitlepage & Печатать титульный лист или нет. \\\hline \multicolumn{2}{c}{\textbf{Специфические настройки класса}} \\\hline autoref, bachelor, master, \textbf{candidate}, doctor & Тип документа: автореферат, бакалаврский диплом, магистерская, кандидатская или докторская диссертация. \\\hline classified & Включает вывод грифа секретности на титульном листе. \\\hline colorlinks = \{true$\,\vert\,$\textbf{false}\} & Создание цветных гиперссылок. Цвета определяются соответствующими параметрами пакета \pkg{hyperref}. \\\hline facsimile & Включает отображение подписей диссертанта и ученого секретаря на титульных листах автореферата и диссертации (только для кандидатских и докторских). По умолчанию включена только в шаблоне автореферата. \\\hline fixint = \{\textbf{true}$\,\vert\,$false\} & Замена стандартных знаков интегралов на прямые (из математического шрифта \pkg{euler}). \\\hline libcat & Включает вывод номера УДК на титульном листе. \\\hline titlepagefile = filename.rtx & Файл с описанием разметки титульного листа. По умолчанию имя файла определяется типом документа. \\\hline \multicolumn{2}{c}{\textbf{Опции для подключения и настройки сторонних пакетов}} \\\hline href & Подключение пакета \pkg{hyperref} для создания гиперссылок. \\\hline noams & Не подключать пакеты \pkg{amsmath}, \pkg{amssymb} и \pkg{amsfonts} из класса. \\\hline subf & Подключение пакета \pkg{subfig} для ведения вложенной нумерации рисунков. \\\hline times & Использование гарнитуры Times в тексте и формулах. Необходимо установить пакеты \pkg{pscyr} или \pkg{cyrtimes} (для текста), \pkg{txfonts} или \pkg{mtpro} (для формул). \\\hline mtpro & Использование математических шрифтов MathTime Pro. При наличии опции \cmd{times} вместо пакета \pkg{txfonts} подключается пакет \pkg{mtpro}. \\\hline\hline \end{tabularx} \section{Система сборки документов} В состав пакета входят две системы скриптов для автоматизации сборки и установки: файлы \file{Makefile}, совместимые с GNU Make, и файлы \file{nomake.cmd}, написанные на языке командного интерпретатора \file{cmd.exe} ОС Windows 2000 и выше. Скрипты поддерживают одинаковый набор целей (targets). Использование в Unix-подобных окружениях: \begin{verbatim} make ... \end{verbatim} В Windows: \begin{verbatim} nomake ... \end{verbatim} Далее приведены описания целей в зависимости от каталога, в котором производится сборка. \def\longestlabel{pdftotiffg44} \subsection{Каталог \file{disser}} \begin{deflist}{\longestlabel} \item[all] Сборка классов и шаблонов. \item[clean] Цель \cmd{clean} в каталогах \file{src} и \file{templates}. \item[doc] Сборка DVI- и PDF-версий документации. \item[help] Справка по целям сборки. \item[install] Копирование пакета, документации и шаблонов в дерево каталогов \TeX{}. Соответствует цели \cmd{install} в каталогах \file{src} и \file{templates}. \item[package] Сборка пакета. Соответствует цели \cmd{package} в каталоге \file{src}. Цель по умолчанию. \item[reinstall] Переустановка пакета. Соответствует цели \cmd{reinstall} в каталогах \file{src} и \file{templates}. \item[srcdist] Создание архива исходных текстов пакета с помощью команды \cmd{hg archive}. \item[tds] Создание архива скомпилированных файлов пакета и шаблонов. \item[templates] Сборка всех шаблонов. Соответствует цели по умолчанию в каталоге \file{templates}. \item[uninstall] Удаление пакета из каталога \TeX{}. Соответствует целям \cmd{uninstall} в каталогах \file{src} и \file{templates}. \end{deflist} \subsection{Подкаталог \texttt{src}} \begin{deflist}{\longestlabel} \item[all] Сборка пакета и PDF-версии документации. Цель по умолчанию. \item[clean] Удаление файлов, указанных в переменной |CLFILES|. \item[doc] Сборка DVI- и PDF-версий документации. \item[dvi] Сборка DVI-версии документации. \item[help] Справка по целям сборки. \item[install] Копирование пакета в дерево каталогов \TeX{}. \item[package] Сборка пакета. \item[pdf] Сборка PDF-версии документации. \item[reinstall] Переустановка пакета. \item[uninstall] Удаление пакета из каталога \TeX{}. \end{deflist} \subsection{Подкаталоги \file{templates} и \file{templates/<тип-диссертации>}} \begin{deflist}{\longestlabel} \item[dvi] Сборка DVI-файла. Цель по умолчанию. \item[clean] Удаление файлов, полученных при сборке документа. Список файлов определяется переменной |CLFILES|. \item[figclean] Эквивалентно цели \cmd{clean} в каталоге \file{fig}. \item[help] Справка по целям сборки. \item[html] Конвертация DVI в HTML-файл с рисунками. Используемая программа: \href{http://www.latex2html.org/}{\cmd{latex2html}}. \item[pdf] Сборка PDF-файла. \item[pdf\_2on1] Сборка PDF-файла с двумя страницами на один лист A4 и сохранением порядка следования страниц. \item[pdf\_book] Сборка PDF-файла с двумя страницами на один лист A4 для брошюрования. \item[ps] Сборка PostScript-файла. \item[ps\_2on1] Сборка PostScript-файла с двумя страницами на один лист A4 и сохранением порядка следования страниц. \item[ps\_book] Сборка PostScript-файла с двумя страницами на один лист A4 для брошюрования. \item[rtf] Конвертация DVI в RTF. \item[srcdist] Сборка архива из содержимого текущего каталога. \end{deflist} Помимо указанных выше целей, в каталоге \file{templates} доступны следующие: \begin{deflist}{\longestlabel} \item[install] Копирование шаблонов в дерево каталогов \TeX{}. \item[reinstall] Переустановка шаблонов. \item[uninstall] Удаление шаблонов. \end{deflist} \begin{flushleft} \textbf{Примечания:} 1) Файлы \file{nomake.cmd} в каталогах шаблонов зависят от \file{include/latex.nmk.cmd} и \file{include/latex.fig.nmk.cmd}. Файлы \file{Makefile} зависят от \file{include/latex.mk} и \file{include/latex.fig.mk}. 2) \file{Makefile} и \file{nomake.cmd} могут использовать цели из каталога \file{fig}. \end{flushleft} \subsection{Подкаталоги \file{templates/<тип-диссертации>/fig}} \begin{deflist}{\longestlabel} \item[bmtoeps] Конвертация растровых изображений в EPS. Используемая программа: \href{http://code.google.com/p/sam2p/}{\cmd{sam2p}}. Список файлов определяется переменной |BMTOEPSFILES|. По умолчанию обрабатываются все файлы с расширениями \file{jpg}, \file{png}, \file{tif}. \item[clean] Удаление файлов. Список файлов определяется переменной |FIGCLFILES|. По умолчанию обрабатываются все файлы с расширениями \file{pdf}, \file{jpg}, \file{png} и \file{tif}. \item[epstoeps] Псевдоним для \cmd{optimize}. \item[epstopdf] Конвертация EPS в PDF. Используемая программа: \cmd{epstopdf} (входит в состав MiK\TeX{} и \TeX{}Live). Список файлов определяется переменной |E2PFILES|. По умолчанию обрабатываются все файлы с расширением \file{eps}. \item[fixbb] Исправление границ видимой области (bounding box) в EPS-файлах. Используемая программа: \href{http://pages.cs.wisc.edu/~ghost/gsview/epstool.htm}{\cmd{epstool}}. Список файлов определяется переменной |FBBFILES|. По умолчанию обрабатываются все файлы с расширением \file{eps}. \item[help] Справка по целям сборки. Цель по умолчанию. \item[optimize] Оптимизация EPS-файлов и исправление границ видимой области. В результате оптимизации все шрифты переводятся в кривые. Используемые программы: \cmd{eps2eps} из пакета Ghostscript и \cmd{epstool}. Список файлов определяется переменной |OPTFILES|. По умолчанию обрабатываются все файлы с расширением \file{eps}. \item[pdftopng256] Конвертация PDF в 256-цветный PNG. Используемая программа: пакет Ghostscript. Список файлов определяется переменной |PDF2PNGFILES|. По умолчанию обрабатываются все файлы с расширением \file{pdf}. \item[pdftotiffg4] Конвертация PDF в черно-белый TIFF (алгоритм сжатия CCITT Group 4). Используемая программа: пакет Ghostscript. Список файлов определяется переменной |PDF2TIFFILES|. По умолчанию обрабатываются все файлы с расширением \file{pdf}. \end{deflist} \section{Стили колонтитулов} Поскольку в российских диссертациях обычно не используются колонтитулы, содержащие название текущей главы документа, то стили, реализованные в данном классе, влияют лишь на положение номера страницы. Стиль колонтитулов обычных страниц документа задается в преамбуле командой |\pagestyle{