Происхождение материалов
Источник
Материал основан на проекте every-embodied (Datawhale и соавторы), лицензия CC BY 4.0.
Перевод выполнил Сергей Монин.
Что переведено
- Текст глав, заголовки, подписи, таблицы и внутренние ссылки.
- Комментарии и строки интерфейса в Python, JavaScript, HTML, CSS, YAML, а также в командных файлах
.cmd. - Ячейки Jupyter-блокнотов. Исходный код при переводе не меняется: проверяется, что токены кода совпадают с оригиналом.
- Подписи в SVG и drawio-диаграммах.
- Имена файлов и каталогов: английские ASCII-слаги.
Что сохранено по-китайски
- Строки, по которым программа сопоставляет ввод: ключевые слова, синонимы, слова пробуждения, маркеры в блокнотах, заголовки CSV. Рядом приведён перевод.
- Имена каталогов upstream-репозитория в путях и ссылки на GitHub. Они соответствуют оригиналу.
- Вывод, записанный в блокнотах и примерах (результаты запусков), оставлен без изменений.
- Китайские примеры команд в интерфейсе: парсер принимает китайский ввод, поэтому пресеты и подсказка в поле ввода остаются на китайском с переводом.
- Имя шрифта
AiDianFengYaHei(ShangYongMianFei)-2.ttfв скриптах cartpole: это имя файла.
Что исключено или заменено
- PDF- и DOCX-версии, крупные файлы весов моделей (ONNX, safetensors, HBM).
- Сохранённые HTML-копии сайта производителя D-Robotics (четыре страницы с китайским текстом). В главах даны ссылки на официальные адреса
developer/d-robotics.github.io/magicbox_doc. Локальная копия списка образов сохранена. - Внутренние ссылки, открываемые только по приглашению, и ссылки-прокси.
- Рекламные блоки исходного текста. Фактические рекомендации по установке и настройке сохранены.
- Персональные пути, имена пользователей и адреса хостов заменены обобщёнными значениями, например
/path/to/…или<путь_к_проекту>. - Стандартные учётные данные производителей не воспроизводятся.
Что требует внимания
- Растровые иллюстрации с китайскими надписями, в первую очередь схемы главы 01 (построены Graphviz), пока не перерисованы.
- Промпты языковых моделей в проекте с беспилотником переведены. Это меняет поведение модели, поэтому перевод нужно проверить на реальных вызовах.
- Интерфейс
tuntunclawпринимает китайские команды. Переводить пользовательский ввод не следует: его ключевые слова сохранены. - Ссылки на репозиторий upstream и на видео с китайскими названиями сохранены как в исходнике.
Изменения относительно оригинала
При подготовке к публикации исправлены следующие ошибки и неточности.
Что исправлено:
- Ошибки перевода: «компания» вместо «общение» (陪伴), «отечественный» вместо «китайский», «следователь» вместо «модуль следования по точкам пути», «представительные» вместо «характерные», несогласованные формы («двуногая обучение», «любая путь», «со сценой»).
- Единые термины: «концевой эффектор», «модель мира», «рука — глаз», «дообучение».
- Фактические ошибки оригинала в разделе 1.1: «деревянные быки и скользящие кони» приписывались Чжан Хэну (по преданию, их создал Чжугэ Лян); 1738 год назван Средними веками; в списке литературы исправлены авторы и названия статей PaLM-E (Driess et al.), OK-Robot, Manipulate-Anything и ALOHA, а также номера arXiv.
- Курсовые оговорки о ROS2 в главе 1 заменены ссылками на следующие главы этой книги.
- Личные пути и имена машин авторов заменены обобщёнными значениями.
- Подписи графиков и сообщения в примерах кода главы 2–4 переведены на русский там, где вывод остальной программы уже русский.
- Разметка: обратные кавычки вместо тильд в блоках кода,
\widetildeвместо\tilde,<img>вместо несуществующего<image>. - Подписи под рисунками в разделах 1.1 и 1.2 («图注:…», в переводе «Подпись: …»): метка убрана, подпись отделена пустой строкой от рисунка. Раньше после тега
<img>mdBook выводил её как сырой текст со звёздочками.
Что вернулось в книгу
- 154 рисунка и видео, на которые ссылались страницы, но которых не было в папке, восстановлены из исходного репозитория. Двенадцать файлов крупнее 3 МБ не копировались: в тексте стоят ссылки на них в исходном репозитории.
- Рисунок
unicross_framework.pngотсутствует и в исходном репозитории; в тексте остался пояснительный абзац. - 22 снимка экрана RDK Studio в руководстве по записи системы (глава 3,
02-rdk-x5-flash-connect-rdk-studio-guide.md) оригинал подгружает сimg2023.cnblogs.com, а хостинг не отдаёт их страницам с чужим адресом. Ссылки в переводе к тому же были искажены. Адреса восстановлены по оригиналу, файлы сохранены вassets/rdk-studio/.