Аннотация: Рассказ о том, как обычному физику-теоретику, не знающему ни слова о LaTeX, удалось за полдня установить дистрибутив, освоить строгий формат научных статей и подготовить публикацию для журнала «Письма в ЖЭТФ» — полностью с помощью ИИ-агента в GigaCode.

---

Вступление: проблема, которая знакома каждому

Если вы когда-нибудь пытались написать научную статью, то знаете: самое сложное — это не идеи, а оформление.

У меня была теория. Обобщённый формализм физики, который я разрабатывал годами. Формулы, аналогии, выводы. Но всё это лежало в обычных текстовых файлах, Word-документах и HTML-страницах.

А нужно было получить красивый .pdf по строгим правилам журнала «Письма в ЖЭТФ» (JETP Letters) — с нумерованными формулами, автоматическими ссылками, правильными шрифтами и библиографией.

Для этого нужен LaTeX. И если для программиста это может показаться простым инструментом, то для человека, который никогда не компилировал документы из командной строки, — LaTeX выглядит как портал в другой мир.

«Подождите, мне нужно написать не просто текст, а откомпилировать его через консоль? С несколькими проходами? С BibTeX?» — именно такие мысли были у меня.

За полдня я сделал всё:

• Установил LaTeX с нуля

• Создал новую обзорную статью в строгом научном стиле

• Преобразовал свои статьи из обычных форматов в .tex

• Получил готовый PDF по стандартам журнала

Работало всё это прямо в GigaCode — и это важно: я не мучился с настройкой VS Code, не ставил LaTeX Workshop и не разбирался с кучей расширений. GigaCode взял на себя всё.

---

Что такое LaTeX и почему программисты его не любят, а физики — боготворят

LaTeX — это не текстовый процессор. Это система вёрстки, в которой вы описываете структуру документа, а не его внешний вид.

\documentclass{article}
\usepackage{amsmath}
\begin{document}
Вот формула Гаусса:
\begin{equation}
    \oint_S \mathbf{E} \cdot d\mathbf{A} = \frac{Q}{\varepsilon_0}
\end{equation}
\end{document}

Затем вы запускаете компилятор, и он выдаёт вам идеально отформатированный PDF.

Почему физики его обожают:

• Формулы выглядят как в настоящей научной статье

• Нумерация уравнений автоматическая

• Ссылки на формулы через \label и \eqref — никогда не сбиваются

• Библиография управляется автоматически

Почему я его ненавидел до этого:

• Нужно устанавливать дистрибутив через консоль

• Нужно понимать, что такое pdflatex, bibtex, .aux файлы

• Нужно запустить компиляцию несколько раз, чтобы всё сошлось

• Ошибки компиляции читаются как древние заклинания

---

Шаг 1: Установка LaTeX

Первое, что мне нужно было сделать — установить LaTeX на Windows.

Я спросил у ИИ-Агента в GigaCode:

Мне нужно установить LaTeX на Windows 11/10. Я никогда этого не делал.
Моя задача — писать научные статьи по физике и компилировать их в PDF.
Какой дистрибутив выбрать и как его установить пошагово?

Агент предложил MiKTeX — дистрибутив, который автоматически подтягивает недостающие пакеты. И дал пошаговую инструкцию:

1. Скачать miktex.org

2. Установить MiKTeX

Но самое главное — он объяснил, зачем нужен каждый шаг. Не просто «нажми сюда», а почему это нужно. И даже подсказал что надо ставить минимальную конфигурацию - чтобы не грузить пол дня кучу ненужных модулей.

---

Шаг 2: Описание репозитория для ИИ

Спера я загрузил в репозиторий (в созданную папку docs/original) все мои старые статьи и наработки. И прежде чем писать статью, мне нужно было «вгрузить» в контекст ИИ-Агента всю структуру моего проекта. Я начал с описания репозитория:

Ты — мой научный ассистент. Изучи структуру моего проекта.

Я работаю в директории C:/!A/!Dima/!НАУКА/ermolaev_fizik/

Мой проект — это теоретический физический формализм.
У меня есть:
- docs/ — документы, руководства, шаблоны для статей
- docs/original/ — мои исходные материалы, черновики, публикации
- WORK/ — рабочие файлы

Мне нужно, чтобы ты понимал структуру проекта и мог помогать мне
с написанием и оформлением научных статей.

Создай краткое описание структуры проекта, чтобы мы могли
эффективно работать вместе.

Это было важно, потому что ИИ-Агент не мог сам «увидеть» мой проект. Мне нужно было дать ему контекст — и он начал работать как полноценный участник процесса.

---

Шаг 3: Создание рекомендаций (Context Prompt)

После того как агент понял структуру проекта, я попросил его создать Context Prompt — документ, который описывает физические правила проекта и становится справочником для всех участников (включая ИИ):

Создай документ PROJECT_CONTEXT.md, который станет справочником
по физическому формализму моего проекта.

В него нужно включить:
1. Базовый формализм — основные символы и определения
   (Q — энергозаряд, U — энергонапряжение, E — энергия и т.д.)
2. Коэффициенты накопления (C_U, C_I)
3. Тепловой заряд theta
4. Обобщённые законы Кирхгофа
5. Междисциплинарные аналогии
6. Словарь терминов
7. Критические позиции (почему энтропия S не подходит)

Используй строгий научный стиль, но так, чтобы было понятно
другим исследователям.

Результат — документ, который стал «единым источником правды» для всего проекта. И агент постоянно ссылался на него при работе со статьями.

---

Шаг 4: Преобразование статей в LaTeX

Самый объёмный этап. У меня были статьи в разных форматах:

• HTML-файлы (!fizic для спутника-utf8.htm)

• Текстовые черновики

• Старые статьи в .doc и .docx

Нужно было превратить всё это в .tex-файл по шаблону журнала «Письма в ЖЭТФ».

Мой промт:

Изучи файл docs/original/sputnik/!fizic для спутника-utf8.htm
и другие файлы в этой папке.

Моя задача — написать статью для журнала «Письма в ЖЭТФ» (JETP Letters).
Руководство по оформлению есть в docs/JETF-Letters-Guide.md.
Шаблон LaTeX — в docs/template-jetp-letters.tex.

Преобразуй мои материалы в формат .tex, соблюдая:
1. Структуру журнала: заголовок, автор, аннотация (до 150 слов),
   ключевые слова, введение, основной текст, заключение, список литературы
2. Все формулы должны быть нумерованы через \begin{equation}
3. Использовать обобщённые символы из PROJECT_CONTEXT.md
   (Q, U, E, I в полужирном шрифте через \mathbf)
4. Список литературы — 10-15 источников
5. Объём — до 5 страниц

Сперва предложи тему статьи, основанную на моих материалах.
Какая тема будет наиболее интересна читателям ЖЭТФ?

Агент предложил несколько тем, я выбрал одну, и дальше мы итеративно дорабатывали статью.

---

Шаг 5: Итеративная доработка

LaTeX — это не «написал и готово». Обычно нужно несколько проходов компиляции, и каждый раз могут всплывать новые нюансы.

В GigaCode я открывал .tex файл, руками вносил небольшие правки в текст — например, перефразировал абзац, добавлял связку между разделами. А вот с формулами я уже не лез: просил ИИ-Агента.

Вот реальный пример моего промта после первого просмотра сгенерированного PDF:

В сгенерированном PDF файле почему-то обобщённый потенциал
всё ещё не выделен полужирным шрифтом...
Или это только в PDF отображается неправильно?

Проверь, правильно ли определены команды \Q, \U, \E в шаблоне.

Или:

В абзаце про Первый закон Кирхгофа (неразрывность токов),
где формула 16 — нужно добавить мысль, что в узле, где
сходятся токи, обобщённое напряжение — единая величина.
А значит, в формуле сложения энергий её можно не учитывать.

Поэтому формула упрощается до суммы энерготоков.

Каждый раз агент находил проблему и исправлял .tex-файл. Я смотрел PDF, который GigaCode сам компилировал, находил неточности — и агент исправлял. Иногда это были мелкие нюансы — например, как именно обозначать полужирные символы в математическом режиме. Иногда — структурные правки.

---

Шаг 6: Компиляция — GigaCode делает всё сам

Когда .tex-файл был готов, я просто попросил ИИ-Агента скомпилировать его в PDF.

Мой промт был простым:

Скомпилируй docs/article/article-kirchhoff-general.tex
в PDF и покажи результат.

Но прежде чем это заработало, агент объяснил, что происходит под капотом:

Объясни, как работает компиляция LaTeX:
1. Почему нужно запустить pdflatex несколько раз
2. Что такое .aux файлы и зачем они нужны
3. Когда нужен bibtex

И объяснил, почему так: первый проход — текст и формулы, второй — ссылки и библиография, третий — финальная проверка. А в GigaCode это всё происходит автоматически — я просто открываю PDF и смотрю результат.

---

Что я узнал о LaTeX за этот день

LaTeX — это нестандартно

Да, я программист. Я привык к IDE, к автодополнению, к кнопке «Run». А тут — напиши текст в .tex файле, запусти компиляцию — и получи ошибки на латыни. Запусти ещё раз.

Но именно это делает LaTeX мощным:

• Разделение контента и оформления — вы пишете структуру, а не пиксели

• Стабильность — 100 ссылок на формулы? Не проблема. LaTeX сам всё обновит

• Качество — шрифты, интервалы, формулы — всё выглядит профессионально

• Версионирование — .tex файл это обычный текст, его можно хранить в Git

ИИ-Агент — это не «напиши за меня»

Важно понимать: ИИ-Агент не просто сгенерировал файл. Мы работали в тандеме:

1. Я давал содержание и идеи — и руками правил текст в .tex файлах

2. Агент трансформировал мои пожелания в правильный LaTeX-синтаксис

3. GigaCode сам компилировал PDF — я просто открывал и смотрел

4. Я находил неточности, агент исправлял

Это как работа с очень быстрым соавтором, который знает синтаксис, но не знает ваши идеи. А ещё — с редактором, который сам компилирует и показывает результат.

---

Примеры моих промтов (шпаргалка)

Вот подборка промтов, которые сработали лучше всего:

Установка и настройка

Установи LaTeX на Windows. Я новичок. Объясни каждый шаг.

Контекст проекта

Опиши структуру моего проекта для научного формализма.
Я хочу, чтобы ты понимал контекст и мог помогать со статьями.

Создание документации

Создай справочник PROJECT_CONTEXT.md с определениями
обобщённых величин, формулами и правилами оформления.

Написание статьи

Преобразуй мои материалы из [формат] в LaTeX-статью
для журнала [название]. Соблюдай требования из [руководство].

Отладка PDF

В PDF не отображается [проблема]. Проверь [файл].

Компиляция

Скомпилируй .tex в PDF и покажи результат.

---

Итог

За полдня я:

• Установил LaTeX с нуля (MiKTeX)

• Создал структурированный репозиторий научных материалов

• Написал Context Prompt для проекта

• Преобразовал черновики в .tex по стандартам ЖЭТФ

• Получил готовый PDF через GigaCode

Без ИИ-Агента в GigaCode это заняло бы недели — а может, я бы вообще бросил на этапе установки MiKTeX.

Главный вывод: LaTeX перестал быть для меня «чёрным ящиком». Я не боюсь его больше. И если вы когда-нибудь задумаетесь написать научную статью — начните с ИИ-помощника. Он сделает порог входа гораздо мягче.

---

Ссылки

• MiKTeX — дистрибутив LaTeX

• Журнал «Письма в ЖЭТФ»

• GigaCode — среда разработки с ИИ-Агентом

---

P.S. Весь проект — в открытом репозитории

Весь проект — от первого коммита до готовой статьи — лежит в открытом публичном репозитории:

? gitverse.ru/icreator/ermolaev_physics/commits/branch

Вы можете зайти и увидеть, как развивался проект — с датами, временем, по коммитам. Всё честно: и идеи, и ошибки, и правки. Если интересно — добро пожаловать!

---

Если вам интересна тема — могу рассказать подробнее о моём физическом формализме, обобщённых законах Кирхгофа или о том, как ИИ помогает в научных исследованиях. Пишите в комментариях!