DOKK / manpages / debian 12 / po-debconf / podebconf-report-po.1.ru
PODEBCONF-REPORT-PO(1) po-debconf PODEBCONF-REPORT-PO(1)

  Translation:
    debian-l10n-russian@lists.debian.org
    Yuri Kozlov <kozlov.y@gmail.com>, 2005, 2006

НАЗВАНИЕ

podebconf-report-po -- отсылает устаревшие debconf PO-файлы последнему работавшему над ними переводчику

СИНТАКСИС

podebconf-report-po [параметры]

ОПИСАНИЕ

Эта программа читает каталог с po-файлами, чтобы определить, какие файлы имеют неточные (fuzzy) или отсутствующие переводы, запускает редактор для изменения тела письма и заголовков, просит подтвердить отправку письма и затем посылает их последнему переводчику с просьбой об обновлении. Письмо будет содержать PO-файл, который нужно обновить. Программу podebconf-report-po можно запускать в каталоге верхнего уровня или в подкаталогах debian или в debian/po (или, для переводов не debconf-сообщений, в самом каталоге po или его родительском каталоге).

podebconf-report-po может также использоваться для посылки просьбы о переводе по списку рассылки. В этом случае, будет присоединен POT-файл.

Существуют различные шаблоны для запросов обновления перевода, с просьбой посылки обновленных PO-файлов как отчёта об ошибке (--submit) или с просьбой о переводе (--call). Шаблон также может быть создан пользователем. Для дальнейшей информации смотрите раздел ШАБЛОНЫ.

ПАРАМЕТРЫ

Многие параметры могут быть установлены в файле настройки. Смотрите раздел ФАЙЛ НАСТРОЙКИ.

Указать список рассылки для заданного языка. Данный список рассылки будет добавлен к списку CC для PO-файлов этого языка, если используется параметр --languageteam помимо языковой команды перевода, указанной в PO-файле (если это разные списки рассылки).

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

Этот параметр можно указывать несколько раз. Код языка и список рассылки языка разделяются двоеточием.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

После того как отчёт об ошибке отправлен (или вручную или с помощью параметра --submit), чтобы следить за переводами можно запустить podebconf-report-po снова, но в этот раз с параметром --bts=НОМЕР ОШИБКИ. Переводчиков просят правильно обрабатывать поле заголовка Reply-To:, которое есть в сообщении об ошибке, для того чтобы все переводы собирались в одном месте.
Отправить запрос на перевод. Если не обязательный параметр СПИСОК РАССЫЛКИ не указан, то запрос переводов отправляется в список интернационализации Debian (debian-i18n@lists.debian.org).

Запрос переводов полезен для получения новых переводов на других языках.

По умолчанию, запрос переводов должен совмещаться с обычными запросами обновлений уже имеющихся переводов. Вы можете выключить это действие по умолчанию указав параметр --withouttranslators.

Указать файл настройки. По умолчанию, podebconf-report-po использует $HOME/.podebconf-report-po.conf.
Не использовать никаких файлов настройки.
Указать срок приёма обновлённых переводов (по умолчанию срока нет).

Это должна быть дата, перед которой будет добавлено:
The deadline for receiving the updated translation is
DEADLINE.

Если указанная строка начинается с '+', то она будет воспринята как:
LC_ALL=C date -R -d DEADLINE

Если срок не указан (и не используется параметр --nodeadline), то пользователю будет выдано приглашение для ввода срока с установленным значением по умолчанию в +10дней.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Выключить отправку срока получения переводчикам и не выводить приглашение для ввода срока.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не запускать редактор и использовать шаблон как есть.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Запустить редактор перед отправкой электронной почты.
Не спрашивать подтверждение перед отправкой электронной почты.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Спрашивать подтверждение перед отправкой электронной почты.
Указать имя и адрес электронной почты отправителя (по умолчанию берётся из переменных среды DEBEMAIL и DEBFULLNAME, или из переменной среды EMAIL, или используется адрес сопровождающего пакета, если эти переменные не установлены).

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Сжимать отсылаемые PO-файлы с помощью "gzip".

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не сжимать PO-файлы.
Показать справку и завершить работу.
Указать список языков для ограничения окончания уведомления только для этих языков. В списке языки разделяются запятой. PO-файлы должны быть названы в соответствии с этими языками и расширением .po.
Послать копию электронной почты командам поддержки языка.

Включено по умолчанию.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не посылать копию электронной почты командам поддержки языка.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Отправить почту с помощью mutt. Это устанавливает параметр --postpone в значение $HOME/postponed.
Показывает, что это не перевод debconf. podebconf-report-po будет использовать шаблон translator-po, call-po или submit-po (если в файле настройки или командной строке не запрошено других шаблонов). Эти шаблоны не упоминают debconf в теме или теле письма, и больше подходят для не-debconf переводов.

Этот параметр также изменяет каталог po по умолчанию, используемый podebconf-report-po (то есть, параметр --podir не нужно указывать при запуске программы из самого каталога po или из его родительского каталога).

По умолчанию, если есть каталоги debian/po и po, то используется первый. С этим параметром рассматривается только каталог po.

Данный параметр, обычно, не нужен. podebconf-report-po пытается определить тип перевода на основе текущего каталога и существования каталога debian/po или po.

Указать имя пакета (по умолчанию используется имя пакета с исходными текстами).
Указать расположение PO-файлов. По умолчанию, podebconf-report-po, проверяет, вызван ли он из каталога po, или осуществляет поиск каталога debian/po (это можно выключить, указав параметр --notdebconf) или каталог po.
Не отправлять почту, отложить ее в ПОЧТ. ЯЩИК. Этот файл может использоваться как отсроченный почтовый ящик с mutt -p.
Указать POT-файл для отправки при запросе переводов (--call). По умолчанию, podebconf-report-po использует POT-файл из каталога PO-файлов, если он существует.

Этот файл также используется для определения имени и версии пакета, если это не было указано в параметрах, и если не был найден файл debian/changelog.

Послать только сообщение, без вложений. Это может быть полезно, когда переводчики имеют доступ на запись в репозиторий пакета.
Указать SMTP сервер для отправки (по умолчанию "localhost").

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Вместо отправки почты переводчикам, отправить отчёт ошибке в виде запроса на перевод пакета. Это полезно, например когда обновление пакета готовится не сопровождающим, и чтобы быть уверенным, что переводы не пропадут.
Послать отчёт о состоянии сопровождающему со списком электронных адресов переводчиков.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не посылать отчёта о состоянии сопровождающему.
Отправлять почту в кодировке UTF-8. Это позволяет использовать не ASCII символы в заголовке и теле письма. Редактор должен поддерживать UTF-8.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Отправлять почту в кодировке US-ASCII. Символы вне этой кодировки будут заменены знаками вопроса.
Показать версию программы и завершить работу.
Показывать подробности работы.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не показывать подробности работы.
Указать файл, который будет использоваться в качестве шаблона писем, отправляемых для поиска новых переводов. По умолчанию используется файл /usr/share/po-debconf/templates/call.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Указать файл, который будет использоваться в качестве шаблона для писем, отправляемых переводчикам, если задан параметр --submit. По умолчанию используется файл /usr/share/po-debconf/templates/submit.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Указать файл, который будет использоваться в качестве шаблона для писем, отправляемых переводчикам. По умолчанию используется файл /usr/share/po-debconf/templates/translators.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Указать файл, который будет использоваться в качестве шаблона писем. Если шаблон задан этим параметром, то он будет использован вместо шаблонов, указанных в параметрах --templatetranslators, --templatesubmit или --templatecall.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Использовать шаблон по умолчанию.
Послать переводчикам запрос обновления уже имеющихся переводов после отправки запроса новых переводов на другие языки.

Этот параметр игнорируется, если не указан параметр --call. Это является действием по умолчанию.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

Не посылать переводчикам запрос обновления уже имеющихся переводов после отправки запроса новых переводов на другие языки.

Этот параметр может быть установлен в файле настройки для определения поведения по умолчанию для podebconf-report-po. Смотрите ниже раздел ФАЙЛ НАСТРОЙКИ.

ФАЙЛ НАСТРОЙКИ

По умолчанию, podebconf-report-po использует $HOME/.podebconf-report-po.conf. Файл настройки может быть указан параметром --conf. Вы также можете проигнорировать какой-либо файл настройки, указав параметр --noconf. Параметры командной строки могут быть использованы для задания настроек отличных от тех, что в файле настройки.

В файлах настройки можно использовать большинство параметров командной строки, указывая их без префикса --: deadline, nodeadline, smtp, from, verbose, force, templatetranslators, templatesubmit, templatecall, template, default, gzip, languageteam, nolanguageteam, addlanguageteam, summary, utf8, withouttranslators, withtranslators.

Строки начинающиеся со знака # (возможно, с предшествующими пробелами) являются комментариями и игнорируются.

Например,
# Это комментарий
smtp smtp.mydomain
from = Я Любимый <me@mydomain>
utf8

ШАБЛОНЫ

Шаблоны, указываемые параметрами --template, --templatetranslators, --templatesubmit или --templatecall могут содержать следующие теги:

<from>, <subject>, <reply-to>
Заменяется соответствующими заголовками из электронной почты.
<filelist>
В режиме по умолчанию, это заменяется комментариями содержащими список авторов устаревших переводов.

В режиме --submit, это заменятся списком PO-файлов с устаревшими переводами.

И в режиме --call, это заменятся списком PO-файлов найденных в PO-каталоге.

<reply>
Заменяется строкой, отражающей куда переводчикам следует отвечать (например, следовать Reply-To тегу или отправлять PO-файл на указанное сообщение об ошибке).
<deadline>
Заменяется строкой, отражающей срок приёма обновлённых переводов (смотри --deadline).
<package>
Заменятся названием пакета (если оно будет определено).
<statistics>
Заменяется статистикой PO-файлов найденных в PO-каталоге (только в режиме --call).

В каталоге /usr/share/po-debconf/templates содержатся шаблоны по умолчанию.

ПРИМЕРЫ

Рекомендуется запускать podebconf-report-po из каталога po, который нужно обновить:

podebconf-report-po --call

Послать запрос на новые переводы в список рассылки <debian-i18n@lists.debian.org> и попросить обновить перевод уже имеющихся переводчиков. Команды по переводу также будут оповещены, и смогут как-то отреагировать, если известно, что предыдущий переводчик больше не сможет помочь.

Пользователю будет предложено ввести срок приёма переводов (для переводов и обновлений по умолчанию принимается значение в 10 дней).

Затем будет открыт текстовый редактор с отправляемым сообщением в список рассылки. При закрытии редактора, podebconf-report-po попросит подтвердить отправку письма в список рассылки.

При утвердительном ответе текстовый редактор запустится снова, но уже с сообщением для переводчиков и команд перевода. После, podebconf-report-po попросит подтверждения отправки письма переводчикам и командам.

Вам обязательно нужно выпустить новую версию с полученными переводами после окончания установленного срока.

СМОТРИТЕ ТАКЖЕ

debconf-updatepo(1)

АВТОР

  Фабио Транчителла (Fabio Tranchitella) <kobold@kobold.it>
2020-12-30