From Fedora Project Wiki
mNo edit summary
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Письмо Виктору Вислобокову о man-pages=
= Предложение =  
Недавно послал Виктору Вислобокову письмо:
# Как человек сделавший перевод может добавить его в map-pages-ru?
# Как обновляется пакет и как он доходит до популярных дистрибутивов?
# Где можно почитать про вопросы с лицензией о сделанных переводах?


:# Присылайте новые переводы или исправленные старые, добавлю.
man делятся на 3 типа:
:# В ряде дистрибутивов есть огинальный исходный URL где можно найти исходники. В других его нет. Таким образом, это ещё одна задача.
# man страницы содержащиеся в [http://www.kernel.org/doc/man-pages/index.html Linux man-pages], которые в Fedora расположены в [http://koji.fedoraproject.org/koji/packageinfo?packageID=401 man pages]
:# В переводах, которые делали мы с Махоткиным в самом начале в комментариях сказано о лицензии LDP. Разумеется в проекте необходимы только переводы со свободными лицензиями
# man-страницы не принадлежащие проекту [http://www.kernel.org/doc/man-pages/index.html Linux man-pages], но для которых разработчики не предусмотрели перевод (например sudo).
# man-страницы для которых разработчики предусмотрели перевод.


::8 августа 2009 г. 1:27 пользователь <kruvalig@gmail.com> написал:
Следовательно, работу нужно делить соответственно.
::kruvalig отправил сообщение с помощью формы обратной связи http://www.linuxshare.ru/contact.
::Во первых хотелось бы сказать спасибо за то что ответили и за то что взялись когда за это трудное дело. Сколько раз открывая man-страницы отыскивая нужный ключ понимал, что без навыков беглого английского мне не найти подходящий. А у меня навык на уровне "читаю и перевожу со словарем". Но работу делать нужно и можно. Сам я участник Fedora-trans-ru. Понимаю ваше желание содержать качество переводов на высоком уровне, потому что плохие переводы бессмыслены и лучше читать тогда оригинал. Не могли бы вы поделиться опытом в создании пакета по переводу. Пакет man-pages-ru без изменений уже много лет в Fedora. У нас есть wiki, mail list. На wiki можно располагать переводы страниц, корректировать их и обсуждать. Это делать может делать любой участник с небольшим опытом по переводу и совсем без навыков создания пакетов и т.д. Кроме того это поможет новичкам которые хотели принять участие в этой работе. Возможно я плохо представляют себе организацию работы по переводу.


::Как вы считаете можно так организовать работу по переводу? У меня много вопросов, но мне трудно их задать.
По первому пункту: Нужно выполнить синхронизацию английских и русских man-ов. Перевод есть, но он может быть не точен, потому что английские версии ушли вперед. Работы тут много. Помещать такие man-страницы следует в man-pages-ru. Можно переводить с помощью веб-интерфейса или скачивая po-файлы на [http://www.transifex.net/projects/p/man-pages/ transifex.net]


::К примеру почему http://www.opennet.ru/man.shtml?topic=sudo&category=8&russian=0 нельзя включить в man-pages-ru  как перевод http://linuxmanpages.com/man8/sudo.8.php ?
По второму пункту: Такие переводы предлагаю помещать в man-pages-ru-extra, тем более что в Fedora уже есть пакет, например: man-pages-es-extra. Отыскал 2 файла: [http://kruvalig.fedorapeople.org/manpages-ru-extra-0.1.tar.bz2 manpages-ru-extra-0.1] и [http://kruvalig.fedorapeople.org/manpages-ru-extra_0.1-1.tar.gz manpages-ru-extra_0.1-1]. Кроме того в интернете множество переведенных материалов.


::: Потому что man на эти команды нет в английском man-pages.
По третьему пункту: Если разработчик программы предусмотрел механизм распространения перевода, нужно им пользоваться.
:::Т.е. на мой взгляд несовсем корректно закладывать в man-pages-ru то, чего нет в man-pages-en [http://linuxmanpages.com/]
:::Наиболее правильным было бы выслать русский man на sudo разработчику самого sudo, чтобы он включил его в состав пакета и таким образом оно расползлось бы по дистрибутивам.
:::Однако, если разработчик не отвечает или отказывается это сделать, то можно было бы создать пакет с названием man-pages-extra-ru и добавлять туда все русские маны, которые выходят за рамки man-pages-en


:::Что ещё могу сказать - сейчас надо бы выполнить актуализацию, т.е. синхронизацию современных английских версий из man-pages-ru с русским переводом.
= Список man-файлов =
#[https://fedoraproject.org/w/uploads/7/7e/List.man.txt Список английских man-pages]
#[https://fedoraproject.org/w/uploads/7/71/List.man.ru.txt Список русский man-pages-ru]
Получить список файлов можно с помощью
<pre>
sudo rpm -q -l man-pages-ru-0.97-6.fc12.noarch
</pre>


:::По поводу wiki - это путь в никуда! Во всяком случае таково моё мнение.
:::Я считаю, что автор у перевода должен быть ОДИН и ещё ОДИН человек должен этот перевод вычитать и договориться с автором об исправлении ошибок. Чтобы сохранить единообразие нужен словарь терминов, обязательный к использованию всеми участниками переводов.
:::Ещё один недостаток wiki - это невозможность получения man-страниц как таковых! Они (как известно) в groff'е, а ни один из известных мне wiki-движков не в состоянии экспортировать в groff.
:::Таким образом, изначальный перевод надо делать в groff, а на сайте можно показывать результат через man2html или другие подобные утилиты.


:::В общем правильным подходом было бы распределить работу среди волонтёров - и соответственно потом будет сразу видно и кто чего стоит и у кого дело стоит и т.д.
Для тех у кого нет установленной Fedora:
[ftp://ftp.neva.ru/Linux-Distrib/Fedora/linux/releases/12/Fedora/i386/os/Packages/man-pages-3.22-6.fc12.noarch.rpm пакет man-pages en],
[ftp://ftp.neva.ru/Linux-Distrib/Fedora/linux/releases/12/Fedora/i386/os/Packages/man-pages-ru-0.97-6.fc12.noarch.rpm man-pages-ru], [http://www.kernel.org/pub/linux/docs/man-pages/Archive/ архив man-pages].


:::Нужен лидер (админ) проекта, который будет распределять работу, спрашивать за эту работу и быть арбитром в спорах.
Узнать версию используемой man-pages
<pre>rpm -qf $(man -w 2 chown)
</pre>
Если вы не видите строку man-pages-xx, значит файл не является частью man-pages. [http://www.kernel.org/doc/man-pages/what_version.html]


:::Со своей стороны готов поучаствовать, но много времени этому проекту отдавать увы не могу - довольно много других дел, которыми я вынужден заниматься.
Узнать пакет, который предоставляет данную man-страницу можно с помощью [http://www.kernel.org/doc/man-pages/man_pages_other.html инструкции:]


= Резюме =
<pre>$ man -w md
/usr/share/man/man4/md.4.gz
$ rpm -qf /usr/share/man/man4/md.4.gz
mdadm-2.5.3-17</pre>


man делятся на 2 типа:
Узнать пакет который предоставляет данный файл можно с помощью
# man страницы содержащиеся в [http://koji.fedoraproject.org/koji/packageinfo?packageID=401 английском man pages]
# все остальные man.


Поэтому работу нужно делить соответственно.  
<pre>
rpm -q --whatprovides /usr/share/doc/man-pages-ru-0.97/README
</pre>


По первому пункту: Нужно выполнить синхронизацию английских и русских man-ов. Перевод есть, но он может быть не точен, потому что английские версии ушли вперед.
Решите что нибудь перевести, отпишитесь:
{| border=1 width=100%
! Английский man
! Русский man
! Комментарий
|-
| /usr/share/man/en/man2/close.2.gz
| /usr/share/man/ru/man2/close.2.gz
| вычитываю [[User:Kruvalig|kruvalig]]
|-
| Добавить сюда английский
| Добавить сюда русский
| Добавить сюда комментарий
|}


По второму пункту: В первую очередь нужно работать с самими разработчиками приложений на данный man. Что бы переводить источник, который "расползется" по всем дистрибутивам.
{{Anchor |newpost}}
 
= Мои текущие вопросы =
 
# Плохо понимаю как работать с groff
# Нужен список man-pages и переведенных man-pages-ru.
# Как синхронизировать версии?


= Ссылки =
= Ссылки =
Line 62: Line 71:
#[http://www.redhat.com/archives/fedora-trans-ru/2009-August/msg00046.html Обсуждение в fedora-trans-ru]
#[http://www.redhat.com/archives/fedora-trans-ru/2009-August/msg00046.html Обсуждение в fedora-trans-ru]
#[http://tldp.org/links/nenglish.html#russian  Linux Documentation Project - источник man-pages-ru в Fedora]
#[http://tldp.org/links/nenglish.html#russian  Linux Documentation Project - источник man-pages-ru в Fedora]
 
#[http://freshmeat.net/projects/manpages-ru-extra/ Manpages-ru-extra]
#[http://linux-man-pages.blogspot.com/2008/08/translating-man-pages.html Размышления на тему: "Следует ли переводить man-pages? Когда это стоит делать?"]
#[http://lerkru.wordpress.com/2010/03/02/когда-следует-переводить-man-pages/ Частичный перевод "Размышлений на тему: "Следует ли переводить man-pages? Когда это стоит делать?""]
#[http://lists.lrn.ru/pipermail/l10n/2009-December/000537.html Обсуждение проекта man-pages-ru в рамках debian.org]
#[http://svn.debian.org/wsvn/l10n-russian/trunk/packages/man-pages-ru/#_trunk_packages_man-pages-ru_ веб-интерфес к svn проекта man-pages-ru в рамках debian.org]
#[http://manpages.ylsoftware.com/dokuwiki/start Еще один проект перевода манов (Какой ужас?!, все хотят переводить маны, но все кучкуются по углам)]
#[https://alioth.debian.org/projects/perkamon/ Проект перевода man-pages французской команды]
[[Category:LocalizationRussian]]
[[Category:LocalizationRussian]]

Latest revision as of 10:45, 2 June 2010

Предложение

man делятся на 3 типа:

  1. man страницы содержащиеся в Linux man-pages, которые в Fedora расположены в man pages
  2. man-страницы не принадлежащие проекту Linux man-pages, но для которых разработчики не предусмотрели перевод (например sudo).
  3. man-страницы для которых разработчики предусмотрели перевод.

Следовательно, работу нужно делить соответственно.

По первому пункту: Нужно выполнить синхронизацию английских и русских man-ов. Перевод есть, но он может быть не точен, потому что английские версии ушли вперед. Работы тут много. Помещать такие man-страницы следует в man-pages-ru. Можно переводить с помощью веб-интерфейса или скачивая po-файлы на transifex.net

По второму пункту: Такие переводы предлагаю помещать в man-pages-ru-extra, тем более что в Fedora уже есть пакет, например: man-pages-es-extra. Отыскал 2 файла: manpages-ru-extra-0.1 и manpages-ru-extra_0.1-1. Кроме того в интернете множество переведенных материалов.

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

Список man-файлов

  1. Список английских man-pages
  2. Список русский man-pages-ru

Получить список файлов можно с помощью

sudo rpm -q -l man-pages-ru-0.97-6.fc12.noarch


Для тех у кого нет установленной Fedora: пакет man-pages en, man-pages-ru, архив man-pages.

Узнать версию используемой man-pages

rpm -qf $(man -w 2 chown)

Если вы не видите строку man-pages-xx, значит файл не является частью man-pages. [1]

Узнать пакет, который предоставляет данную man-страницу можно с помощью инструкции:

$ man -w md
/usr/share/man/man4/md.4.gz
$ rpm -qf /usr/share/man/man4/md.4.gz
mdadm-2.5.3-17

Узнать пакет который предоставляет данный файл можно с помощью

rpm -q --whatprovides /usr/share/doc/man-pages-ru-0.97/README

Решите что нибудь перевести, отпишитесь:

Английский man Русский man Комментарий
/usr/share/man/en/man2/close.2.gz /usr/share/man/ru/man2/close.2.gz вычитываю kruvalig
Добавить сюда английский Добавить сюда русский Добавить сюда комментарий

Ссылки

  1. Сайт Виктора Вислобокова
  2. linuxmanpages
  3. Man-pages в Alt Linux
  4. Иходники и rpm man-pages в Alt Linux
  5. Man-pages-ru в Fedora (без изменений с 2007-04-05)
  6. Обсуждение в fedora-trans-ru
  7. Linux Documentation Project - источник man-pages-ru в Fedora
  8. Manpages-ru-extra
  9. Размышления на тему: "Следует ли переводить man-pages? Когда это стоит делать?"
  10. Частичный перевод "Размышлений на тему: "Следует ли переводить man-pages? Когда это стоит делать?""
  11. Обсуждение проекта man-pages-ru в рамках debian.org
  12. веб-интерфес к svn проекта man-pages-ru в рамках debian.org
  13. Еще один проект перевода манов (Какой ужас?!, все хотят переводить маны, но все кучкуются по углам)
  14. Проект перевода man-pages французской команды