Установка manpages-es

Введение

Установка

Использование

Вступление

Успех на международной арене пришел к Linux частично из-за доступности исходных кодов, а также отличной документации и учебников по этой операционной системе. Если Linux собирается успешно распространиться в Испании, то мы должны иметь справочную систему на испанском языке такого же качества, что и на английском. Существует несколько проектов, которые занимаются переводом HOWTO, mini-HOWTO, руководств LDP (проект документации по Linux) и наконец справочных страниц. Для испанского перевода последних было выбрано имя manpages-es.

Год назад группа добровольцев решила заняться переводом справочных страниц, которые обычно входят в состав дистрибутивов Linux (Slackware, Debian, RedHat, ...) До сих пор все наши усилия были направлены на саму работу по переводу. Однако, мы обнаружили, что важный аспект проекта мы оставили без внимания: установка и использование справочных страниц. В этой статье мы описываем процесс установки и использования справочных страниц на испанском для тех, кто только что пришел в UNIX.

В UNIX есть система визуализации руководств и очень специфичных страниц справки. Основная команда доступа к этим страницам - man. Эта команда является точкой входа в базу данных, которая управляет всеми справочными страницами, входящими в ваш дистрибутив Linux. Сами по себе эти страницы написаны на TROFF/NROFF, старом компьютерном языке форматирования текста. В каждой версии UNIX есть справочные страницы в определенном каталоге. Стандартом, принятым сообществом Linux, является каталог /usr/man.

Установка

Прежде всего необходимо отметить, что версия man, которая стоит у вас, должна поддерживать испанские символы. Стандартные символы, известные как Latin1, поддерживают специальные символы, используемые в западно-европейских языках, включая испанский. Потому man должен понимать символы Latin1. Подойдет любая версия man старше man-1.4f. В действительности, мы считаем, что большинство настоящих дистрибутивов Linux содержат подходящую версию man.

Следующим шагом будет найти текущий дистрибутив manpages-es и развернуть его в местном каталоге. Этот дистрибутив можно найти в различных местах. Отправной точкой должна быть домашняя страница проекта. Последняя доступная версия man-pages-es-0.2. После загрузки дистрибутива, разверните его следующей командой

gunzip -c man-pages-es-0.2.tar.gz | tar -xvf -

cd man-pages-es-0.2

Чтобы скопировать страницы в место назначения мы просто выполняем

make install

Пользователи, у которых проблемы с местом на диске, могут установить страницы в сжатом виде. Чтобы такой вариант заработал, команда man, установленная в вашей системе, должна читать заархивированные страницы в формате TROFF. Опять же, за исключением самых старых дистрибутивов, большинство текущих дистрибутивов содержат "man", который их поддерживает. Чтобы установить сжатые страницы, выполните следующие команды:

           make gz
           make install
           

Наконец, необходимо изменить файл /etc/../../common/November1997/man.config , который управляет опциями команды man. В частности, нам потребуется только удостовериться, что man обработает формат TROFF/NROFF с символами Latin1. Например, здесь приводится ../../common/November1997/man.config, который я использую в своей системе. Единственным отличием от исходного конфигурационного файла являются строки

           NROFF  /usr/bin/groff -Tlatin1 -mandoc
           NEQN   /usr/bin/geqn -Tlatin1
           

Использование

Теперь наши страницы установлены и сконфигурированы так, как надо. Чтобы ими мог воспользоваться любой пользователь, мы должны задать следующие переменные среды: LANG и LESSCHARSET (Замечание: эти переменные можно установить глобально, тогда испанские страницы будут использоваться по умолчанию). Первая переменная управляет локалью, то есть языком, используемом в текущем шелле. Если задана LANG=es то команда man ищет справочные страницы в каталоге /usr/man/es (испанская версия), и если не найдет их там, то она будет искать в /usr/man (английская версия). Вторая переменная устанавливает для пейджера "less" символы latin1. Конечно же мы предполагаем, что в качестве пейджера по умолчанию для man используется less. В файле ../../common/November1997/man.config, приведенном выше в качестве примера, этот пейджер используется по умолчанию. Если пользователь использует bash, то обе переменные могут быть заданы как

               export LANG=es
               export LESSCHARSET=latin1
               
           

В случае csh или tcsh необходимо использовать

               setenv LANG=es
               setenv LESSCHARSET=latin1
               
           

Примечание переводчика: русские маны можно взять на страницах http://slackl.cargolink.cnt.ru/~ivanp/ (есть архив одним файлом) и http://www.uco.ru/~garris/. Установить русские справочные страницы можно двумя способами:

1) Аналогично описанному выше. Этот способ рекомендуется, если русская локаль уже установлена (или есть желание ее установить). В этом случае маны необходимо устанавливать в каталог /usr/man/ru.

2) Добавлением пути поиска команды man в файл /etc/manpath.config. При этом этот путь надо указывать ДО каталога /usr/man, т.е. manpath.config должен выглядеть примерно так:

                ...
                MANDATORY_MANPATH                /usr/man/ru
                MANDATORY_MANPATH                /usr/man
                MANDATORY_MANPATH                /usr/X11R6/man
                ...
                

В этом случае переменную LANG можно не задавать.