From Fedora Project Wiki
No edit summary
(добавила подробное описание проекта)
Line 2: Line 2:


Страница посвящена переводу Linux kernel and C library.
Страница посвящена переводу Linux kernel and C library.
*Страница проекта на Transifex - https://www.transifex.net/projects/p/man-pages/ (см. [[#How-to-use-tx| Как пользоваться Transifex]])
*Страница проекта на [https://www.transifex.net/projects/p/man-pages/ Transifex] (см. [[#How-to-use-tx| Как пользоваться Transifex]]), на [http://sourceforge.net/projects/man-pages-ru/ SourceForge], [https://lists.sourceforge.net/lists/listinfo/man-pages-ru-talks список рассылки] проекта.
*Страница проекта на SourceForge - http://sourceforge.net/projects/man-pages-ru/
*Список рассылки проекта - https://lists.sourceforge.net/lists/listinfo/man-pages-ru-talks


'''Мечты''':
==Цель==
#получить перевод Linux man-pages версии 3.24, проекта документации Linux kernel and C library [http://www.kernel.org/doc/man-pages/index.html]
*Объединение уже существующих переводов
#перевести все страницы документации coreutils.
*Полный перевод Linux man-pages версии 3.24, проекта документации Linux kernel and C library
*Перевести все страницы документации coreutils (в будущем)
 
==Описание проекта==
===Структура man-pages===
Согласно [http://www.kernel.org/doc/man-pages/index.html первоисточнику] собрание man'ов имеет следущую структуру:
*'''man1'''
*'''man2''' - документация по системным вызовам (System calls)
*'''man3''' - документация по функциям стандартной библиотеки С (Library functions)
*'''man4''' - документация по различным устройствам. большинство которых расположено в ''/dev'' (Devices)
*'''man5''' - описание различных форматов файлов, в том числе описание файловой системы ''/proc'' (Files)
*'''man6'''
*'''man7''' - Обзоры, соглашения, разное.(Overviews, conventions, and miscellaneous)
*'''man8'''
 
===Структура проекта===
 
*[https://www.transifex.net/projects/p/man-pages/ Transifex] - сервис для перевода (через файлы в формате *.po или через on-line форму). По всем вопросам обращаться к [https://www.transifex.net/accounts/profile/kruvalig/ координатору].
*[http://sourceforge.net/projects/man-pages-ru/ SourceForge] - переведенные файлы попадают в эту часть проекта, где их просматривает [http://sourceforge.net/users/yuray координатор]. Так же на в этом сервисе расположены [https://lists.sourceforge.net/lists/listinfo/man-pages-ru-talks список рассылки] и [http://sourceforge.net/projects/man-pages-ru/forums форум] проекта, здесь можно [http://sourceforge.net/projects/man-pages-ru/files/ скачать] наиболее свежую версию переводов.


'''Цели:'''
#Собрать в одну кучу уже существующие переводы.
#Перевести еще непереведенные страницы.


{{Anchor |How-to-use-tx}}
{{Anchor |How-to-use-tx}}

Revision as of 11:19, 15 April 2010

Man-pages-ru

Страница посвящена переводу Linux kernel and C library.

Цель

  • Объединение уже существующих переводов
  • Полный перевод Linux man-pages версии 3.24, проекта документации Linux kernel and C library
  • Перевести все страницы документации coreutils (в будущем)

Описание проекта

Структура man-pages

Согласно первоисточнику собрание man'ов имеет следущую структуру:

  • man1
  • man2 - документация по системным вызовам (System calls)
  • man3 - документация по функциям стандартной библиотеки С (Library functions)
  • man4 - документация по различным устройствам. большинство которых расположено в /dev (Devices)
  • man5 - описание различных форматов файлов, в том числе описание файловой системы /proc (Files)
  • man6
  • man7 - Обзоры, соглашения, разное.(Overviews, conventions, and miscellaneous)
  • man8

Структура проекта

  • Transifex - сервис для перевода (через файлы в формате *.po или через on-line форму). По всем вопросам обращаться к координатору.
  • SourceForge - переведенные файлы попадают в эту часть проекта, где их просматривает координатор. Так же на в этом сервисе расположены список рассылки и форум проекта, здесь можно скачать наиболее свежую версию переводов.


Как пользоваться Transifex

  1. Зарегистрируйтесь (для этого перейдите по ссылке).
  2. Зайдите на страницу проекта, выберите вкладку Translation Teams и присоединитесь к русскоязычной команде (для присоединения требуется реакция модератора, это может занять некоторое время).
  3. Вернитесь на страницу проекта и выберите интересующую часть переводов (например, man2), щелкните кнопку "Options" рядом с русским языком.
  4. Перед вами список файлов, доступных для перевода. Рядом с каждым файлом показан процент перевода, а так же есть кнопки "Просмотреть файл" (View), "Загрузить файл" (Download), "Заблокировать файл" (Lock, используется для того, чтобы показать, что над файлом работают), "Следить за файлом" (Watch it). После присоединения к команде, появятся еще 2 кнопки - "Редактировать" (Edit, позволяет редактировать файл прямо через браузер без использования спецмальных программ) и "Отправить перевод" (Submit, для отправки переведенных po-файлов).
  5. Подробнее можно почитать в на странице www.transifex.net/help/. По всем вопросам рекомендуем обращаться к координатору.

Словари терминов

К сожалению общего глоссария для перевода man-страниц нет. Поэтому здесь собраны ссылки на наиболее популярные и живые словари в сети. Будем признательны, если вы дополните этот список.

Как узнать какой пакет предоставляет данную man-старницу?

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

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

sudo rpm -ql 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

Ссылки

Здесь собраны ссылки на различные проекты по переводу man'ов, на сайты, где собраны уже переведенные страницы и на различные размышления по этому поводу.

  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. Еще один проект перевода манов