Исправление ошибки отправки на arXiv с .bib ссылками

Система автоматической обработки arXiv не запускает BibTeX или внешние инструменты библиографии, что объясняет, почему ваша отправка не работает, хотя она работает в Overleaf. Ошибка “bibtex run returned error code” возникает потому, что arXiv выполняет только команды LaTeX, а не BibTeX, поэтому ваши ссылки отображаются как [?] вместо отформатированных ссылок.

Содержание

• Понимание обработки библиографии в arXiv
• Основные решения для неработающих ссылок
• Пошаговое руководство по устранению неполадок
• Особые случаи: biblatex и расширенные настройки
• Предотвращение проблем и лучшие практики

Понимание обработки библиографии в arXiv

Система AutoTeX arXiv работает иначе, чем стандартные локальные среды компиляции LaTeX. Как объясняется в документации arXiv, “Мы не запускаем BibTeX в процедуре автоматической компиляции TeX. Если вы его используете, включите в свою отправку .bbl файл, который BibTeX создает на вашем собственном компьютере; в противном случае ваши ссылки не будут отображаться правильно.”

Это фундаментальное различие объясняет, почему ваша отправка не работает:

• Ограничение arXiv: Запускает только LaTeX, а не BibTeX, Biber или другие внешние инструменты
• Последовательность обработки: arXiv удаляет .aux файлы между запусками LaTeX, что требуется для BibTeX
• Результат: Ссылки не могут быть обработаны во время компиляции, что приводит к тому, что маркеры цитирования остаются как [?]

Ошибка “bibtex run returned error code” возникает потому, что система arXiv пытается запустить BibTeX, но не из-за ограничений конфигурации, как отмечено в обсуждениях на Stack Overflow.

Основные решения для неработающих ссылок

1. Загрузите созданный .bbl файл

Самый надежный способ — создать .bbl файл локально и включить его в отправку на arXiv. Согласно руководству по отправке в arXiv, это рекомендуемый подход для пользователей традиционного BibTeX.

Шаги для создания .bbl файла:

1. Скомпилируйте ваш документ локально с помощью вашего редактора LaTeX
2. Запустите pdflatex → bibtex → pdflatex → pdflatex для создания .bbl файла
3. Загрузите как ваш .tex файл, так и созданный .bbl файл на arXiv

Для пользователей Overleaf этот процесс упрощен:

• Используйте “Инструменты > Библиография (F8)” для создания .bbl файла, как описано в руководстве Люка Си
• Скачайте проект как ZIP файл, который включает .bbl файл

2. Альтернатива: преобразование в встроенную библиографию

Если создание .bbl файлов вызывает проблемы, вы можете преобразовать вашу библиографию во встроенный формат:

% Вместо \bibliography{bibliography} включите:
\nobibliography
% Затем вручную добавьте вашу отформатированную библиографию из .bbl файла

Пошаговое руководство по устранению неполадок

Проверка текущей настройки

Сначала определите, используете ли вы традиционный BibTeX или biblatex:

Настройка традиционного BibTeX:

\bibliographystyle{abbrv}
\bibliography{bibliography}

Настройка biblatex:

\usepackage[backend=bibtex]{biblatex}
\bibliography{bibliography}

Шаг 1: Создание и включение .bbl файла

Для пользователей традиционного BibTeX:

1. Создайте .bbl файл локально:

   bash

   pdflatex your_document.tex
   bibtex your_document
   pdflatex your_document
   pdflatex your_document
   

2. Проверьте наличие .bbl файла и убедитесь, что он содержит отформатированные записи библиографии

3. Включите оба файла в отправку на arXiv:

   • Ваш основной .tex файл
   • Созданный .bbl файл
   • Ваш .bib файл (хотя это и не строго необходимо)

Шаг 2: Проверка несоответствий версий

Даже с TeX Live 2025 в Overleaf могут возникать проблемы совместимости версий:

“Система обработки TeX arXiv построена на конкретной версии TeX Live. Это означает, что по мере выпуска новых версий программного обеспечения arXiv может отставать от современных систем, таких как BibLaTeX.” - FAQ arXiv

Тестирование со старой версией TeX Live:

• В Overleaf переключитесь на TeX Live 2023 (как указано в документации arXiv)
• Это решает проблемы с именованием сред, подобных теоремам, и загрузкой пакетов

Шаг 3: Проверка согласованности файлов

Убедитесь, что все файлы правильно ссылается и доступны:

• Проверьте, что имя .bib файла в \bibliography{bibliography} соответствует фактическому имени вашего .bib файла (без расширения .bib)
• Убедитесь, что пути к файлам относительные и не используют абсолютные пути
• Подтвердите отсутствие специальных символов в именах файлов

Особые случаи: biblatex и расширенные настройки

Проблемы совместимости с biblatex

biblatex представляет дополнительные сложности на arXiv:

“biblatex может работать с выделенным бэкендом Biber или BibTeX; однако при отправке .bbl файла для biblatex, ваша статья и .bbl файл должны быть созданы одной и той же программой.” - документация arXiv

Решения для пользователей biblatex:

1. Загрузите файлы biblatex: Включите необходимые файлы biblatex в свою отправку, как рекомендуется в вики biblatex

2. Переключитесь на традиционный BibTeX: Преобразуйте вашу библиографию в формат BibTeX для отправки на arXiv

3. Отключите biblatex для arXiv: “Отключите использование biblatex в версии, загружаемой на arXiv, так как у них нет требований к форматированию TBME” - Rambling Academic

Расширенные требования к пакетам

Некоторые пакеты требуют специальной обработки:

“Загрузка пакетов с помощью \usepackage или \RequirePackage теперь завершится ошибкой, если происходит в группе {…}. Это наиболее заметно при использовании \singlespace, \doublespace и т.д. из пакета setspace.” - документация arXiv

Решение: Переместите команды загрузки пакетов в преамбулу документа, а не внутрь групп или условных операторов.

Предотвращение проблем и лучшие практики

Контрольный список перед отправкой

• [ ] Создайте .bbl файл с помощью того же компилятора, который создаст ваш PDF
• [ ] Включите .bbl файл в отправку на arXiv
• [ ] Протестируйте компиляцию без внешних инструментов библиографии
• [ ] Убедитесь, что все цитирования имеют соответствующие записи в .bib файле
• [ ] Проверьте наличие проблем совместимости пакетов

Долгосрочные решения

1. Стандартизируйте ваш рабочий процесс: Всегда создавайте .bbl файлы для отправки на arXiv, даже если вы работаете локально с BibTeX

2. Рассмотрите возможность переключения на biblatex с правильной настройкой: Хотя изначально это сложнее, biblatex предлагает лучшее форматирование и управление ссылками

3. Используйте шаблоны, совместимые с arXiv: Многие журналы предоставляют шаблоны, готовые к arXiv, которые автоматически обрабатывают обработку библиографии

Когда обращаться за дополнительной помощью

Если вы продолжаете испытывать проблемы:

• Проверьте страницу помощи TeX arXiv для конкретных требований к версиям
• Изучите тег arXiv на TeX Stack Exchange для поиска решений сообщества
• Рассмотрите проблемы на GitHub biblatex для специфичных для версии проблем

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

Источники

1. Отправка TeX/LaTeX - информация arXiv
2. Система отправки наследия - информация arXiv
3. biblatex - arXiv не компилирует мою библиографию - TeX Stack Exchange
4. Как получить и использовать .bbl файл в моем tex документе для отправки на ArXiv - TeX Stack Exchange
5. Создание bbl файла из Overleaf для отправки на ArXiv - Luke Sy
6. Распространенные ошибки, вызывающие сбой автоматической обработки - информация arXiv
7. Biblatex и arXiv: простое решение – Rambling Academic
8. biblatex и arXiv - GitHub Wiki

Заключение

Ключ к решению ошибки отправки на arXiv — понимание того, что arXiv не запускает BibTeX или внешние инструменты библиографии. Создавая .bbl файл локально и включая его в свою отправку, вы можете гарантировать правильное форматирование ваших ссылок. Помните, чтобы протестировать компиляцию вашего документа без внешних инструментов библиографии перед окончательной отправкой. Для пользователей biblatex могут потребоваться дополнительные шаги, включая загрузку файлов biblatex или переключение на традиционный BibTeX для версии arXiv. Следуя этим рекомендациям, вы сможете избежать ошибки “bibtex run returned error code” и убедиться, что ваши цитирования правильно отображаются в предварительном просмотре arXiv.