docs/Makefile - master - Mihaham/CNN-NEAT

docs/Makefile
51 строка2 KB
MihahamYT
docs: add MkDocs formal documentation and prebuilt static site
09 июн 2026, 17:23
09 июн 2026, 17:23839d883
# Makefile для компиляции LaTeX-документа CNN-NEAT
# Требования: TeX Live / MiKTeX с пакетами: babel, fontenc, inputenc,
#             geometry, titlesec, amsmath, amssymb, amsthm,
#             algorithm2e, graphicx, listings, hyperref, biblatex
#
# Использование:
#   make pdf        — компиляция report_gost.tex → report_gost.pdf
#   make clean      — удаление вспомогательных файлов
#   make cleanall   — удаление всех генерируемых файлов включая PDF

DOCNAME  = report_gost
LATEX    = pdflatex
BIBTEX   = bibtex
LATEXOPT = -interaction=nonstopmode -file-line-error
BUILDDIR = build

.PHONY: pdf site clean cleanall

# MkDocs: формальная документация → ../site/
site:
	python build_mkdocs_site.py

pdf: $(BUILDDIR)/$(DOCNAME).pdf

$(BUILDDIR)/$(DOCNAME).pdf: $(DOCNAME).tex $(wildcard *.bib) $(wildcard figures/*.png)
	@mkdir -p $(BUILDDIR)
	@echo "==> Первый проход pdflatex..."
	$(LATEX) $(LATEXOPT) -output-directory=$(BUILDDIR) $(DOCNAME).tex
	@echo "==> Компиляция библиографии..."
	-$(BIBTEX) $(BUILDDIR)/$(DOCNAME)
	@echo "==> Второй проход pdflatex..."
	$(LATEX) $(LATEXOPT) -output-directory=$(BUILDDIR) $(DOCNAME).tex
	@echo "==> Третий проход pdflatex (финальные ссылки)..."
	$(LATEX) $(LATEXOPT) -output-directory=$(BUILDDIR) $(DOCNAME).tex
	@echo "==> Готово: $(BUILDDIR)/$(DOCNAME).pdf"

clean:
	@echo "==> Удаление вспомогательных файлов..."
	@rm -f $(BUILDDIR)/*.aux $(BUILDDIR)/*.log $(BUILDDIR)/*.bbl \
	        $(BUILDDIR)/*.blg $(BUILDDIR)/*.toc $(BUILDDIR)/*.out \
	        $(BUILDDIR)/*.lot $(BUILDDIR)/*.lof $(BUILDDIR)/*.fls \
	        $(BUILDDIR)/*.fdb_latexmk
	@echo "==> Очищено."

cleanall: clean
	@echo "==> Удаление PDF..."
	@rm -f $(BUILDDIR)/$(DOCNAME).pdf
	@echo "==> Полная очистка завершена."

# Windows (nmake) альтернатива:
# nmake /f Makefile.win pdf