В этом посте я описываю, чтобы настроить рабочий процесс для создания и отпускания ваших файлов латекса через действия GitHub. Прежде всего, имейте в виду, что этот пост не о том, что такое латекс и как его использовать.
Очень приятно интегрировать ежедневные инструменты развития, например, CI/CD к вашей подготовке бумаги, без каких-либо хлопот. Почему это потому, что это круто, чтобы отследить то, что было изменено на бумаге со временем. На самом деле, наличие нескольких людей, которые несут ответственность в разных частях бумаги, иногда блокируют других. Поэтому имея такой рабочий процесс повысит производительность для всех в группе. Всякий раз, когда потяните запрос, созданный в главную ветку, будет легко проверить опечатки, логические ошибки и отсутствующие точки по другим.
- Латексная подготовка
- Настройка Действия GitHub
- Доказательство концепции
Латексная подготовка
Я предполагаю, что вы договорились о работе на латексном шаблоне, чтобы завершить газету. В этом случае необходимо сделать только небольшой шаг, который нужно сделать, создать репозиторий GitHUB (- должен быть на Github, действия GitHub будут использоваться-) и нажмите все файлы вашего латекса шаблона. ( Генерал, в следующей структуре-)
|-sections
| introduction.tex
| related_works.tex
| problem.tex
| solution.tex
| conclusion.tex
|- main.tex
|- references.bib
Данный пример структуры может быть изменен в соответствии с вашими пожеланиями, однако важным и логической частью является то, что имея main.tex по корневому каталогу репозитория.
Как только он установлен, есть только один шаг для завершения, который настраивает рабочие процессы действий GitHub.
Настройка Действия GitHub
Есть несколько разных действий GitHub для использования для составления латексного документа для PDF на рынке. Наиболее предпочтительным является https://github.com/xu-cheng/latex-Action И это довольно легко интегрировать и использовать.
Он в основном создает сгенерированный PDF-файл из предоставленного файла LATEX, он может быть установлен в файле рабочего процесса, как указано ниже: (- обратите внимание, что этот рабочий процесс работает на меченых коммитах, который имеет тег с помощью *. *. * шаблон -)
name: Build LaTeX document
on:
tags:
- '*.*.*' # semantic versioning
jobs:
build_latex:
runs-on: ubuntu-latest
steps:
- name: Set up Git repository
uses: actions/checkout@v2
- name: Compile LaTeX document
uses: xu-cheng/latex-action@v2
with:
root_file: main.tex
Однако создание только этой работы недостаточно достаточно, чтобы завершить рабочий процесс, нам требуется больше рабочих мест Создать релиз и Загрузить выпуск Отказ Как вы можете догадаться от их имени, сначала вы получите релиз и второе загрузку, предоставленные файлы на страницу выпуска. Это может быть установлено в следующем
name: Release Compiled PDF
on:
push:
tags:
- '*.*.*'
jobs:
build_latex:
runs-on: ubuntu-latest
steps:
- name: Set up Git repository
uses: actions/checkout@v2
- name: Compile LaTeX document
uses: xu-cheng/latex-action@v2
with:
root_file: main.tex
- name: Create Release
id: create_release
uses: actions/create-release@v1
env:
GITHUB_TOKEN: $
with:
tag_name: $
release_name: Release $
draft: false
prerelease: false
- name: Upload Release Asset
id: upload-release-asset
uses: actions/upload-release-asset@v1
env:
GITHUB_TOKEN: $
with:
upload_url: $
asset_path: ./main.pdf
asset_name: main.pdf
asset_content_type: pdf
Данный рабочий процесс завершена версия того, что вы могли бы иметь в конце. Таким образом, он создает PDF из предоставленного файла LATEX, создает файл выпуска и загрузки для выпуска. Для получения более подробной информации вы можете проверить информацию на каждой странице действий.
Доказательство концепции
Вот пример репозитория для проверки заполненной версии.
https://github.com/mrturkmencom/latex-on-ci-cd
Оригинал: «https://dev.to/mrturkmen/latex-with-github-actions-4580»