G7-32 template

Данный шаблон разработан для оформления отчетов о НИР, расчетно-пояснительных записок к курсовым и дипломным работам в соответствии с ГОСТ 7.32-2017 и демонстрирует возможности стиля G7-32.

Структура

latex-g7-32
├── res 
│       изображения, исходные файлы для листингов, библиография
├── lib
│       пакеты и макросы LaTeX
├── lib/G7-32/tex 
│       LaTeX-файлы стилей и классов для стандарта GOST 7.32
├── lib/GOST/bibtex/bst/gost
│       стили библиографии для оформления по GOST
├── tex 
│       исходные файлы LaTeX
├── .latexmkrc
│       конфигурация для утилиты latexmk, которая задает
│       переменные среды и определяет настройки сборки документа
└── main.tex 
        основной файл LaTeX, который включает
        структуру документа и вызовы других файлов

Сборка

Здесь перечислены возможные удобные варианты, как можно собрать документ с помощью latexmk. Вы можете комбинировать их или придумать свой.

Overleaf

Скачайте архив из последнего релиза и импортируйте его как новый проект в Overleaf. Подробнее: how to upload a project.

Note

Чтобы использовать XeLaTeX вместо pdfLaTeX, в меню проекта измените компилятор на XeLaTeX. Подробнее: changing compiler.

Docker

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

cd latex-g7-32

IMAGE="ghcr.io/afaikiac/latex-g7-32:overleaf"

WORKDIR="/doc"

XeLaTeX

docker run --rm -i --user="$(id -u):$(id -g)" --net=none -v "$(pwd)":"$WORKDIR" "$IMAGE" latexmk -pdfxe

pdfLaTeX

docker run --rm -i --user="$(id -u):$(id -g)" --net=none -v "$(pwd)":"$WORKDIR" "$IMAGE" latexmk -pdf

Note

Не забывайте о сабмодулях lib/G7-32 и lib/GOST. Их нужно учитывать при работе с git.

GitHub Action

1. Создайте новый репозиторий Use this template -> Create a new repository.

2. Измените разрешения для GITHUB_TOKEN на read and write. Подробнее: setting the permissions of the GITHUB_TOKEN for your repository.

3. Сделайте коммит в основную ветку, которая называется main или master.

Поздравляем! Создается новый Draft релиз с PDF во вложениях.

Note

В build.yml можно найти переменные среды:

env:
  RUN_LATEXMK_XELATEX: true
  RUN_LATEXMK_PDFLATEX: true
  CREATE_OVERLEAF_ARCHIVE: true

Изменяя их, можно контролировать, что именно будет собираться в Draft релиз.

Полезное

G7-32

• Можно использовать свободный аналог Times New Roman — PT Astra Serif и PT Astra Sans. Подробнее: опции класса документа.

• Кратко о различиях XeLaTeX и pdfLaTeX: other compilers.

Git

Документация по работе с submodules.

# Инициализировать и обновить submodules
git submodule update --init

# Oбновить submodules из upstream
git submodule update --remote

Latexmk

Mануал по latexmk.

-с
    Clean up (remove) all regeneratable files generated by
    latex and bibtex or biber except dvi, postscript and pdf.

      latexmk -pdfxe -c
      latexmk -pdf -c

Инструменты

...