https://github.com/kolosovpetro/latex-russian-template

LaTeX шаблон на русском, который включает в себя базовую настройку CI/CD и шаблоны программ на языке Wolfram.
https://github.com/kolosovpetro/latex-russian-template

latex latex-document latex-template tex-template

Last synced: about 1 month ago
JSON representation

LaTeX шаблон на русском, который включает в себя базовую настройку CI/CD и шаблоны программ на языке Wolfram.

• Host: GitHub
• URL: https://github.com/kolosovpetro/latex-russian-template
• Owner: kolosovpetro
• License: gpl-3.0
• Created: 2022-11-12T14:10:34.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-06T20:48:07.000Z (3 months ago)
• Last Synced: 2024-10-12T21:47:09.027Z (2 months ago)
• Topics: latex, latex-document, latex-template, tex-template
• Language: TeX
• Homepage: https://kolosovpetro.github.io/pdf/LatexRussianTemplate.pdf
• Size: 1.15 MB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Citation: CITATION.cff

Awesome Lists containing this project

README

        
# LaTeX шаблон на русском

LaTeX шаблон на русском, который включает в себя базовую настройку CI/CD и шаблоны программ на языке Wolfram.

- https://dev.azure.com/PetroKolosovProjects/latex-russian-template

## Сборка документа с помощью PowerShell (Windows)

- Установить `MikTeX`: https://miktex.org/download

- Обновить `MikTeX`

- Установить `SumatraPDF`: https://www.sumatrapdfreader.org/download-free-pdf-viewer

- Запустить скрипт `Rename-Tex-Files.ps1`, который переименовывает основные файлы LaTeX и BibTeX, чтобы они

  соответствовали имени корневого каталога репозитория

- Запустить скрипт `Build-Latex.ps1`

## Сборка документа в Intellij IDEA (Windows)

- Установить `MikTeX`: https://miktex.org/download

- Обновить `MikTeX`

- Установить `SumatraPDF`: https://www.sumatrapdfreader.org/download-free-pdf-viewer

- Путь к SumatraPDF: `C:\Program Files\SumatraPDF`

- Установить `Intellij IDEA Ultimate` среду разработки: https://www.jetbrains.com/idea/download/#section=windows

- Активировать `Intellij IDEA Ultimate`, надеюсь у вас есть ключ

- Установить плагин `TeXiFy IDEA` для `Intellij IDEA Ultimate`: https://plugins.jetbrains.com/plugin/9473-texify-idea

- Склонировать данный репозиторий или используйте как шаблон на

  GitHub: `https://github.com/kolosovpetro/latex-russian-template.git`

- Откройте склонированный проект в среде разработки `Intellij IDEA Ultimate` и сконфигурируйте сборку документа

    - LaTeX Configuration

      ![LaTeX Configuration](img/latex_configuration.PNG "LaTeX Configuration")

    - BibTeX Configuration

      ![BibTeX Configuration](img/bibtex_configuration.PNG "BibTeX Configuration")

- Сконфигурируйте обратный поиск `Intellij IDEA` для `SumatraPDF`: `Tools -> LaTeX -> Configure Inverse Search`

- Запустите сборку документа сочитанием клавиш `Shift + F10`

## Конфигурация CI / CD

- Обновить имя корневого latex файла в `build-pdf.yml` и `build-and-deploy-pdf.yml`

- Для корректной работы CI / CD установите `GH_ACCESS_TOKEN` в секреты Github:

    - `GH_ACCESS_TOKEN`: Сгенерировать

      `Settings -> Developer Settings -> Personal access tokens -> Generate mew token`

## Политика срабатывания CI / CD

- `build-pdf.yml` срабатывает при `pull_request`, `push` в ветку `develop`

- `build-and-deploy-pdf.yml` публиует собранный PDF документ на удаленный репозиторий `GitHub Pages`.

  Срабатывает на событии `push` в ветку `master`

## Пример шаблона

Скомпирированный шаблон выглядит следующим образом