Этот проект представляет собой систему публикации научного журнала "Интегральная философия", основанную на LaTeX, модульной архитектуре и автоматизированной системе сборки на базе `Make' . Цель проекта — обеспечить структурированный научный объект с семантикой, воспроизводимостью и возможностью архивирования, а не просто "хороший PDF".
Система обеспечивает полный цикл издания академического журнала, включая:
- Модульную систему конфигурации: Каждый аспект оформления отделен в свой конфигурационный файл (
cfg/). - Автоматическую генерацию метаданных: Скрипты и
Makefileзадачи помогают поддерживать актуальность метаданных. - Комплексную систему сборки:
Makefileавтоматизирует все рутинные операции, от компиляции до проверки и очистки. - Поддержку библиографии, глоссариев и указателей: Интегрировано с использованием
biber,makeglossariesиmakeindex. - Непрерывную компиляцию (
watch): Для удобства редактирования и мгновенного просмотра изменений.
Проект использует Make для автоматизации задач.
makeилиmake build: Собирает финальный PDF-документ (main.pdf).make watch: Запускает непрерывную компиляцию. Любые изменения в исходных файлах автоматически вызывают пересборку PDF. Используйте в отдельном терминале.make view: Открывает сгенерированныйmain.pdfв системном просмотрщике.make clean: Удаляет все временные файлы, сгенерированные в процессе компиляции, оставляя PDF.make distclean: Выполняет полную очистку, включая удаление сгенерированногоmain.pdf.make help: Отображает список всех доступных командMakeс описаниями.
main.tex: Основной файл документа LaTeX, который собирает все части журнала.preamble.tex: Содержит общие настройки LaTeX, используемые в проекте.journal.cls: Пользовательский класс документа LaTeX, определяющий стиль и макет журнала.journal.yml: Конфигурация выпуска журнала в формате YAML.metadata.yml: Метаданные журнала (например, название, авторы, выпуск), которые могут генерироваться автоматически.references.bib: Библиографическая база данных для статей.Makefile: Главный файл системы сборки, содержащий все команды автоматизации.cfg/: Директория, содержащая модульные конфигурационные файлы LaTeX (например, для шрифтов, типографики, метаданных).chapters/: Директория, где хранятся отдельные главы и статьи журнала.scripts/: Вспомогательные скрипты, например, для генерации метаданных.docs/: Документация по проекту.
- Начало работы:
cd Journal/Main - Запуск непрерывной компиляции (в отдельном терминале):
make watch - Редактирование: Вносите изменения в файлы
.tex,.ymlили.bib. PDF будет автоматически пересобираться. - Проверка качества:
make check(проверяет ссылки и цитирования). Также доступныmake warnings,make errors,make boxesдля отладки. - Финальная сборка и просмотр:
make buildиmake view. - Очистка (перед коммитом/архивацией):
make cleanилиmake distclean.
- LaTeX: Основной язык разметки для создания документов.
- Biber: Используется для обработки библиографии.
- MakeIndex/MakeGlossaries: Для создания указателей и глоссариев.
- Make: Система автоматизации сборки.
Вы можете проверить зависимости, выполнив make check-deps.
make update-metadata: Интерактивно обновляет номер выпуска и год в файлах конфигурации.make new-article: Создает новую статью из шаблона, запрашивая фамилию автора.