Аннотация: Рассказ о том, как обычному физику-теоретику, не знающему ни слова о 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 — дистрибутив, который автоматически подтягивает недостающие пакеты. И дал пошаговую инструкцию:
-
Скачать miktex.org
-
Установить 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. Тепловой заряд theta4. Обобщённые законы Кирхгофа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
ИИ-Агент — это не «напиши за меня»
Важно понимать: ИИ-Агент не просто сгенерировал файл. Мы работали в тандеме:
-
Я давал содержание и идеи — и руками правил текст в
.texфайлах -
Агент трансформировал мои пожелания в правильный LaTeX-синтаксис
-
GigaCode сам компилировал PDF — я просто открывал и смотрел
-
Я находил неточности, агент исправлял
Это как работа с очень быстрым соавтором, который знает синтаксис, но не знает ваши идеи. А ещё — с редактором, который сам компилирует и показывает результат.
Примеры моих промтов (шпаргалка)
Вот подборка промтов, которые сработали лучше всего:
Установка и настройка
Установи LaTeX на Windows. Я новичок. Объясни каждый шаг.
Контекст проекта
Опиши структуру моего проекта для научного формализма.Я хочу, чтобы ты понимал контекст и мог помогать со статьями.
Создание документации
Создай справочник PROJECT_CONTEXT.md с определениямиобобщённых величин, формулами и правилами оформления.
Написание статьи
Преобразуй мои материалы из [формат] в LaTeX-статьюдля журнала [название]. Соблюдай требования из [руководство].
Отладка PDF
В PDF не отображается [проблема]. Проверь [файл].
Компиляция
Скомпилируй .tex в PDF и покажи результат.
Итог
За полдня я:
-
Установил LaTeX с нуля (MiKTeX)
-
Создал структурированный репозиторий научных материалов
-
Написал Context Prompt для проекта
-
Преобразовал черновики в
.texпо стандартам ЖЭТФ -
Получил готовый PDF через GigaCode
Без ИИ-Агента в GigaCode это заняло бы недели — а может, я бы вообще бросил на этапе установки MiKTeX.
Главный вывод: LaTeX перестал быть для меня «чёрным ящиком». Я не боюсь его больше. И если вы когда-нибудь задумаетесь написать научную статью — начните с ИИ-помощника. Он сделает порог входа гораздо мягче.
Ссылки
P.S. Весь проект — в открытом репозитории
Весь проект — от первого коммита до готовой статьи — лежит в открытом публичном репозитории:
👉 gitverse.ru/icreator/ermolaev_physics/commits/branch
Вы можете зайти и увидеть, как развивался проект — с датами, временем, по коммитам. Всё честно: и идеи, и ошибки, и правки. Если интересно — добро пожаловать!
Если вам интересна тема — могу рассказать подробнее о моём физическом формализме, обобщённых законах Кирхгофа или о том, как ИИ помогает в научных исследованиях. Пишите в комментариях!
ссылка на оригинал статьи https://habr.com/ru/articles/1102114/