Стиль LaTeX для оформления отчетов о НИР, расчётно-пояснительной записки к курсовым и дипломным работам (ГОСТ 7.32-2001 и ГОСТ РВ 15.110-2003)

Требуется maintainer!

Ориентирован на студентов IT специальностей, научных работников и др. кому необходимо составлять документы по ГОСТ 7.32-2001 или ГОСТ РВ 15.110-2003.

Изначально был написан в расчёте на pdfLaTeX, с коммита 23b1612 добавлена поддержка XeLaTeX. Помимо стилей содержит "рыбу" РПЗ (в той же папке tex).

Также имеются необходимые макеты (layout) для LyX (редактор, редактирование в котором больше похоже на работу в Microsoft Word, чем на написание LaTeX кода, но результат получается такой же хороший, как в LaTeX). Для использования LyX также нужно скопировать стили LaTeX (из папки tex).

Результат

См. вкладку Релизы.

Попробовать online

Спасибо @KMax, теперь можно попробовать шаблон в ShareLaTeX.

Участие в проекте

Стиль распространяется "как есть". В случае обнаружения несостыковок с ГОСТом, обнаружении багов, а также если есть вопросы по использованию, не отражённые в документации, заводите, пожалуйста, issue. Pull requests принимаются.

Установка

Скачать последнюю версию.

C помощью git:

git clone https://github.com/latex-g7-32/latex-g7-32

Или скачать zip:

https://github.com/latex-g7-32/latex-g7-32/archive/master.zip:

Или взять из релизов.Однако, релизы формируются с течением времени и могут содержать существенно устаревшую версию.

Скопировать файлы:G2-105.sty G7-32.cls G7-32.sty GostBase.clo gosttitleGostRV15-110mipt.sty gosttitleGostRV15-110.sty local-minted.sty в локальный texmf.Для линукс это будет $HOME/texmf/.Для Виндовс C:\Users\USERNAME\texmf\.Проверить это можно командой kpsewhich -var-value=TEXMFHOME.Относительно texmf путь будет texmf/tex/latex/latex-g7-32/.

Зависимости

Основные для стилевого файла

LaTeX пакеты

amssymb amsmath caption flafter footmisc hyperref icomma iftex graphicx longtable underscore etoolbox lastpage titlesec flafter amssymb amsmath color mfirstuc nomencl 

openSUSE

texlive-latex texlive-iftex 

pdfLaTeX-версия

LaTeX пакеты

cmap babel mathtext pscyr ucs

Для придания таймовского вида нужно установить соотв. шрифты (пакет cyrtimes.sty), в Debian/Ubuntu это пакет scalable-cyrfonts-tex. Если этого пакета нет, оно использует стандартную гарнитуру CM.

XeLaTeX-версия

LaTeX пакеты

cm-unicode-fonts minted polyglossia xecyr

openSUSE

cm-unicode-fonts texlive-minted texlive-polyglossia texlive-xecyr

Программы

inkscape dia graphviz python pygments

LyX

lyx

Установочный скрипт

python3.4

На текущий момент не работает см. #26.

Копирует (или перемещает) файлы со стилями в общую texmf папку, макеты LyX в папку с настройками LyX. Для получения помощи вызовите install.py --help.

Использование РПЗ

После изменения РПЗ создайте директорию build в корне проекта, затем cd ./build & cmake .. && make. В ней появится файл РПЗ - rpz.pdf. Cmake по умолчанию собирает с xelatex.

После изменения РПЗ запустите make в корне. Результатом будет rpz.pdf. Если требуется использование pdfLaTeX то в Makefile надо поменять в третье строке xelatex на pdflatex.

Редактор

Можно использовать любой редактор, например, Kile. На комманду cd .. && make вешается горячая клавиша и создаётся проект с корректным главным документом.

Установка и использование под Windows

Для работы в Windows необходимо установить следующие зависимости:

1. dwimperl

2. texlive

3. inkscape

4. dia

5. graphviz

6. ghostscript

7. babun — не обязательно.

8. cmake — не обязательно при использованииbabun, обязательно при работе без него. В случае с babun нужноиспользовать pact install cmake, а не самостоятельную установку изустановщика на сайте. В любом случае необходимо либо иметь babun+make, либоbabun+cmake, либо cmake.

   Внимание: CMake не собирает ничего сам, он генерирует скрипты для make (иряда других программ), только он умеет использовать разные диалекты: nmake(из Visual Studio), mingw32-make, MSYS make, … Поэтому что‐то из этого нужнотакже установить. На данный момент сборка проверялась для babun+cmake,babun+make и просто нативного cmake. В последнем случае использоваласьутилита make из пакета WinAVR, идентифицирующаяся как GNU make.

9. python — при использовании babunне нужно, он уже установлен там.

   После установки python установить его пакет pygments.

После установки всех зависимостей необходимо добавить их в $PATH. Установщикинекоторых (texlive, cmake и dwimperl) делают это сами (но, возможно, требуетсяустановка галочки), для остальных нужно редактировать реестр, либо изменять PATHвременно. В PATH помещаются каталоги, в которых находятся следующие файлы:inkscape.exe, dia.exe, dot.exe, python.exe.

Ghostscript предоставляет файлы gswin32.exe и gswin32c.exe, однако для работынужно иметь файл gs.exe или gs.bat где‐то в $PATH. В случае с bat файл долженвыглядеть так:

@echo off
P:\ath\to\ghostscript\gswin32c.exe %*

(ВНИМАНИЕ: именно gswin32c.exe, не gswin32.exe.) Можно просто скопироватьgswin32c.exe в gs.exe и добавить каталог с ними в $PATH.

В случае использования python из babun вам дополнительно нужен в $PATHpygmentize.bat следующего содержания:

@echo off
C:\Users\{user}\.babun\cygwin\bin\python2.7.exe C:\Users\{user}\.babun\cygwin\bin\pygmentize %*

(замените {user} на своего пользователя). Что нужно в случае использованияpython без babun я не знаю, но исполняемый файл pygmentize должен бытьв $PATH.

После того, как $PATH станет содержать пути ко всем необходимым исполняемымфайлам можно будет использовать выбранную систему сборки для создания PDF‐файла.В случае с babun+[c]make:

1. Откройте babun.

2. Войдите в каталог с проектом с помощью cd /path/to/latex-g7-32.

3. При использовании cmake:

   1. Создайте каталог build: mkdir build.
   2. Войдите в него: cd build.
   3. Соберите проект: cmake .. && make. PDF появитсяв /path/to/latex-g7-32/build/rpz.pdf (он же rpz.pdf в текущем каталоге).
   4. При изменении tex файлов и картинок/диаграмм/… можно собирать простос помощью make.
   5. При добавлении файлов/картинок/диаграмм нужно опять использовать cmake .. перед make.
   6. Для очистки от сгенерированных файлов можно просто удалить каталогbuild.

   При использовании make:

   1. Проект (пере)собирается просто make. PDF появитсяв /path/to/latex-g7-32/rpz.pdf.
   2. Для очистки от сгенерированных файлов можно использовать make clean.Проверяйте их наличие с помощью git status --ignored, временные файлы несконцентрированы в одном каталоге в этом случае.

Нативный CMake:

1. Откройте cmd.exe.

2. Войдите в каталог с проектом с помощью:

   1. D:, где D: — буква диска, на котором лежит проект. Данная частьпредназначена для переключения текущего диска: в cmd.exe у каждого дискасвой текущий каталог, текущий каталог cmd.exe является текущим каталогомтекущего диска.

      Под D: здесь понимается буквально: “введите команду D: и нажмитеввод”.

   2. cd D:\path\to\latex-g7-32.

3. Создайте каталог build: mkdir build.

4. Войдите в него: cd build.

5. Запустите cmake ... Т.к. в отличие от *nix систем (cygwin (babun) можносчитать относящимся к таковым в определённой степени) на Windows нет«стандартного make», то вполне возможно, что просто cmake .. сделает не то,что нужно. Для GNU make из WinAVR, использовавшегося автором нужно былоиспользовать команду cmake .. -G "Unix Makefiles". Список возможныхгенераторов можно получить либо на сайте CMake, либо указав cmakeзаведомо несуществующий генератор: к примеру, cmake -G xxx_nonexistent_generator_xxx (внимание, поведение может измениться в новойверсии CMake). На сайте информация предоставлена более подробно.

6. Запустите make. В зависимости от того, какой генератор есть у вас в системевместо make может оказаться nmake (распространяется с Visual Studio,соответствует cmake .. -G "NMake Makefiles") или mingw32-make(распространяется с компилятором mingw32, соответствует cmake .. -G "MinGW Makefiles").

   PDF файл появится в текущем каталоге (т.е. D:\path\to\latex-g7-32\build)под названием rpz.pdf.

Сборка с использованием Docker

После установки и настройки docker (обратитесь к документации вашегодистрибутиве) создайте образ:

cd /path/to/latex-g7-32
cd docker
docker build -t somename .

Все необходимые зависимости будут установлены внутри образа.

Затем сборку можно будет осуществлять следующим образом:

rm -f /path/to/latex-g7-32/results
docker run --volume /path/to/latex-g7-32/:/doc/ somename

Созданные файлы появятся в каталоге /path/to/latex-g7-32/results, егонеобходимо удалять перед пересборкой. При сборке этим методом шаблон собираетсячетырьмя способами: (make, cmake) × (pdflatex, xelatex), если вам достаточнокакого‐то одного, то можно изменить docker/build.sh.

Альтернативная система сборки

Имеется также альтернативная система сборки с помощью модифицированного скрипта latexmkmod.

Минимальные требования: сам скрипт и TeX Live.

Сначала нужно установить этот скрипт. На Linux достаточно скопировать файл latexmkmod.pl в utils/latexmkmod. На Windows в дополнение к этому ещё нужно добавить в PATH интерпретатор Perl. Он обычно включён в TeX Live, может находиться, например, в C:\texlive\2017\tlpkg\tlperl\bin

Для сборки выполнить либо build.sh (Linux), либо build.bat (Windows): создастся директория build и в ней будет PDF файл.

Если в командной строке указать опцию -bd mybuilddir, то выходные файлы будут в директории mybuilddir. Если указана опция -up, то используется PdfLaTeX вместо XeLaTeX. Опция -rcd .. указывает относительный путь к текущей директории относительно директории с выходными файлами, полезно, если в Windows текущая директория содержит русские буквы.

Опции latexmk также доступны (например, -c убирает выходные файлы)

Если установлен только TeX Live, то вместо изображений dot, dia, svg отобразятся заглушки и листингов с кодом не будет. Чтобы появились изображения, нужно установить Graphviz, Dia и Inkscape.

Чтобы появились листинги кода при использовании XeLaTeX, нужно дополнительно установить: Python 2 и Pygments (pip install pygments). Если используется PdfLaTeX, нужно установить iconv.

Пути к исполняемым файлам всех программ должны быть в PATH, при необходимости нужно их добавить туда вручную. Пример содержимого этой переменной:C:\Python27\;C:\Python27\Scripts;C:\texlive\2017\tlpkg\tlperl\bin;C:\texlive\2017\bin\win32;C:\Program Files (x86)\GnuWin32\bin;C:\Program Files\Inkscape;C:\Program Files (x86)\Dia\bin;C:\Program Files (x86)\Graphviz2.38\bin;

Использование LyX

Откройте lyx/rpz.lyx и редактируйте.

В первый раз необходимо настроить параметры вызова XeLaTeX, для того, чтобы minted работал.

Настроки -> Обработка файлов -> Конверторы -> LaTeX (XeTeX) -> PDF (XeTeX) -> Изменить -> Преобразователь: xelatex -shell-escape $$i.

Шрифты

В отчёте можно использовать свободный аналог Times New Roman - PT Astra, они находятся в репозитории в каталоге fonts.На линуксе устанавливаются в $HOME/.fonts/ затем выполнить команды fc-cache -f -v и luaotfload-tool -u -f.

На Windows шрифты нужно скопировать в каталог C:\Windows\Fonts и также желательно выполнить команду fc-cache -f -v, чтобы документ, использующий шрифты, быстрее компилировался.

Опции класса документа, устанавливающие шрифты:

1. При использовании XeLaTeX:

   1. astra (по умолчанию) — свободные шрифты Astra Sans, Astra Serif, Liberation Mono.
   2. times — Шрифты Times New Roman, Arial, Courier New. Необходимо, чтобы у вас был подписан лицензионный договор с правообладателем шрифтов — компанией Monotype Imaging Inc.
   3. cm — Шрифты CMU, которые обычно включены в TeX Live.

2. При использовании PdfLaTeX:

   1. times (по умолчанию) — шрифты из пакета cyrtimes: Nimbus Roman и Nimbus Sans.
   2. pscyr — шрифты из пакета pscyr: Antiqua PSCyr, Textbook PSCyr, ERKurier PSCyr.
   3. cm — шрифты CM, которые обычно включены в TeX Live.

Если какой-то шрифт не найден, то вместо него будет использоваться соответствующий шрифт CM.

Эти опции нужно задавать в \documentclass, например так: \documentclass[utf8x, times, 14pt]{G7-32}

Печать

Для подготовки к печать варианты сборки с помощью Makefile и CMake имеют цельprintpdfs. При её использовании (make printpdfs либо из корня репозитория,либо из каталога build в случае CMake) дополнительно создаётся до трёх PDFфайлов рядом с rpz.pdf: rpz.gs.pdf, rpz.gs-color.pdf и rpz.gs-gray.pdf:

• rpz.gs.pdf содержит все страницы, как и rpz.pdf, но использует меньшевозможностей PDF: известно, что при печати rpz.pdf средствами некоторыхпринтеров, поддерживающих печать PDF с flash‐карты с графов может пропастьрусский текст.
• rpz.gs-color.pdf гарантированно содержит все «цветные» страницы, а такженекоторые нецветные — inkscape создаёт чёрно‐белые PDF, которые ghostscriptпочему‐то считает нужным печатать цветными красками.
• rpz.gs-gray.pdf содержит страницы, которые можно печатать, имея толькочёрную краску.

Для работы printpdfs требуется наличие ghostscript (команд gs илиgswin32c).

Авторы

1. Первая версия

Алексей Томин

2. Доработка "дебианщика"

Михаил Конник

3a. Доработка кафедры ИУ7

|Всеволод Крищенко|

Иван Коротков

Changelog

1. Заработали cases и tabular;
2. Добавлена опция utf8;
3. Комментарии в UTF-8;
4. Изменены отступы после тире в description;
5. Добавлен \paragraph;
6. Уменьшены отспупы после заголовков и учеличены --- до (хотя это, возможно, и нарушает 7-32);
7. Сделаны отсупы в оглалвнеии (ГОСТ эту тему обходит, как мы поняли);
8. \normalfont;
9. Добавлен раздел "Приложения".
9. Makefile для автоматизации рутины;
10. Рисунки (обрезка, конвертация dia, dot, svg);
11. Стили для листингов;
12. Разные мелочи.

3b. Добавление layouts LyX

Расим (Brotherofken)

4. GitHub, поддержка XeLaTeX, LyX

Роман Инфлянскас

5. Further fixes, tweaks and development

According to the requirements ofГОСТ 7.32-2001 ред. 2009 года.pdf and some other random wishes.-- Ivan Zakharyaschev imz@altlinux.org.

(Read the git log... I tried to explain each change clearly.)

6a. Сборка под при помощи Сmake, Windows+cygwin, CMakeLists.txt, а также сборка с docker

Николай Павлов

6b. Сборка при помощи latexmkmod, Windows+Linux,

dvarubla

Благодарности

Ростислав Листеренко (сообщения об ошибках)

Стиль разрабатывается при поддержке "Дизайн-центр МФТИ", НТКТеХЛАБ.

См. также

Статьи

Записки дебианщика

Репозитории

@qrilka: порт второй версии на XeLaTeX

@petethepig: порт урезанной третьей версии ("под себя") на XeLaTeX

Классы LaTeX для написания диссертаций

Russian-Phd-LaTeX-Dissertation-Template

Класс для диссертаций disser