Skip to content

Diploma sources

Publish Zensical docs Build PDF Release PDF Check tools exe CI Backup git bundle

LaTeX latexmk biblatex biber Docker Python Pytest Plotly Pandas Mermaid Zensical GitHub Actions GitHub Pages Task rclone LibreOffice

Last commit Repo size Latest release

This repository contains the source files for the diploma project: LaTeX documents, Mermaid diagrams, Python diagrams, DOCX templates for title pages, and Docker profiles for reproducible builds.

This work was prepared as a graduation qualification project at the federal state budgetary educational institution of higher education "Amur State University". The university is mentioned only as the academic context of the work and is not identified as a rights holder for the repository materials unless a separate agreement states otherwise.

Main workflow

Required tools

If you are opening the project for the first time, start with Requirements. It briefly lists the tools needed for Docker builds, local builds, and PDF comparison.

If you already know what to do

Open Common scenarios: it contains short instructions for building the PDF, updating diagrams and title pages, splitting PDF into color/B/W pages, connecting source code, comparing versions, and launching Stirling PDF.

Install Task:

winget install Task.Task

For macOS or Linux with Homebrew:

brew install go-task/tap/go-task

If these options do not fit your environment, use the official installation guide: https://taskfile.dev/docs/installation.

Check the installation:

task --version
task --list
task build
uv run python scripts/build_all.py

The result is closest to the original if Mermaid diagrams are built on Windows. When Mermaid is built through Docker, the font used for KaTeX expressions can differ from the original.

The main workflow requires Docker. If Docker is not used, see Build without Docker.

If you want browser-based PDF viewing without a local viewer on your machine, use Stirling PDF.