Перейти к основному содержимому

Complete documentation system for academic publishing platform

📚 Integral Philosophy Documentation
#

Complete documentation system for academic publishing platform.

📦 What’s Included
#

  • 📖 User Guides - Step-by-step tutorials
  • 👨‍💻 Developer Docs - API reference and architecture
  • 🔧 Examples - Sample projects and configurations
  • 📝 Contributing - Development guidelines

🚀 Quick Start
#

```bash pip install integral-philosophy-docs integral-docs serve –port 3000 ```

README
#

Журнал “Интегральная философия”
#

LaTeX-издательская система для академического журнала “Интегральная философия”.

Архитектура
#

LaTeX → PDF + Multi-format Publishing

Система предназначена для создания высококачественных академических публикаций с поддержкой многоформатного вывода.

Ключевые возможности
#

  • LaTeX-верстка с использованием LuaLaTeX
  • Библиографические ссылки через biblatex+biber
  • Многоязычная поддержка (русский, английский)
  • Научная типографика с математическими формулами
  • Многоформатный вывод: PDF, HTML, EPUB3 через TEI XML
  • Автоматизированная сборка через Makefile

Установка
#

# Клонирование репозитория
git clone https://github.com/your-org/integral-philosophy.git
cd integral-philosophy

# Установка зависимостей LaTeX (Ubuntu/Debian)
sudo apt-get install texlive-full lualatex biber

# Проверка сборки
make pdf

Быстрый старт
#

# Сборка PDF
make pdf

# Очистка временных файлов
make clean

# Полная пересборка
make rebuild

# Многоформатная публикация
make all-formats

Разработка
#

Структура проекта
#

Magazine/
├── main.tex              # Основной файл журнала
├── preamble.tex          # Преамбула с пакетами и настройками
├── cfg/                  # Конфигурационные модули
│   ├── cfg-*.tex        # Настройки (шрифты, библиография, etc.)
├── chapters/             # Главы журнала
├── articles/             # Статьи авторов
├── frontmatter/          # Начальные элементы (титул, оглавление)
├── backmatter/           # Заключительные элементы
└── Makefile             # Автоматизация сборки

Основные команды Makefile
#

# Сборка PDF
make pdf

# Быстрая сборка (без полной очистки)
make fast

# Проверка зависимостей
make check-deps

# Очистка временных файлов
make clean

# Полная очистка
make distclean

Конфигурационные модули
#

  • cfg-fonts.tex: Настройки шрифтов и типографики
  • cfg-bibliography.tex: Библиографические ссылки
  • cfg-structure.tex: Структура документа и секции
  • cfg-articles.tex: Настройки форматирования статей
  • cfg-metadata.tex: Метаданные журнала

Выходные форматы
#

  • PDF: Основной формат для печати и распространения
  • HTML: Веб-версия через tex4ht или pandoc
  • EPUB: Цифровая версия для e-reader’ов
  • DOCX: Формат для рецензирования через pandoc

Лицензия
#

MIT License - см. файл LICENSE для деталей.

Вклад в проект
#

  1. Fork репозитория
  2. Создайте feature branch (git checkout -b feature/article-template)
  3. Commit изменения (git commit -m 'Add new article template')
  4. Push в branch (git push origin feature/article-template)
  5. Откройте Pull Request

Статус разработки
#

  • Базовая LaTeX-структура журнала
  • Конфигурационные модули
  • Шаблоны статей
  • Система библиографии
  • Автоматизация через Makefile
  • Многоформатный вывод (HTML, EPUB)
  • Валидация и тестирование
  • Документация для авторов
  • CI/CD для автоматической сборки

Текущий этап: Базовая функциональность LaTeX ✅ Следующий этап: Многоформатная публикация