Hogar Indice Busqueda Enlaces Sobre Nosotros
  Noticias   Archivos   Compañias   Consejos y Trucos  

Instalación de Manpages-es

por Miguel Angel Sepúlveda


Introducción

La existencia de documentación y fuentes ha impulsado el &eacuto;xito de Linux  Parte del éxito de Linux en la arena internacional se debe tanto a la disponibilidad de fuentes como a la existencia de estupendos manuales y tutoriales sobre el sistema operativo. Si Linux va a tener éxito en su versión castellana deberiamos tener manuales en castellano de igual calidad. Hay varios proyectos involucrados con la traducción de HOWTOs, mini-HOWTOs, manuales del LDP (Linux Documentation Project) y finalmente de las páginas de manual. Manpages-es es el nombre que elejimos para la version castellana de este último proyecto.

Desde hace un año un grupo de voluntarios decidimos empezar a traducir una por una las páginas del manual normalmente incluidas en las distribuciones más comunes de Linux (Slackware, Debian, RedHat, ..). Hasta el momento hemos tenido todo nuestro esfuerzo centrado en la traducción propia. Sin embargo, nos damos cuanta de que hemos dejado un aspecto tan importante o más que la traducción propia descuidado: La instalación de las páginas. En este artículo describimos el proceso de instalación y uso de las páginas de manual en castellano para aquellos sean novicios en UNIX.

UNIX tiene un sistema de visualización de manuales y páginas de ayuda específico. El principal comando para acceder a dichas páginas es man. Dicho comando es el punto de entrada en una base de datos que controla todas las páginas de manual incluidas en cualquier distribución de Linux. Las páginas mismas de manual están escritas en TROFF/NROFF, un lenguaje un tanto antiguo de maquetación de páginas. Cada versión de UNIX tiene las páginas de manual en un directorio particular. El estándard adoptado por la comunidad linux opta por instalar las páginas en el directorio /usr/man

Instalación

Se necesita una version de man adecuada 1.)

Es importante resaltar en primer lugar que la versión del comando man debe ser capaz de procesar caracteres castellanos. El estandard de caracteres conocido como Latin1 da soporte al conjunto de caracteres especiales usados en los idiomas del oeste europeo, incluyendo castellano. Por tanto, man debe entender el juego de caracteres Latin1. Cualquier version a partir de man-1.4f vale. De echo la mayoria de las distribuciones actuales de Linux ya incluyen una versión de man appropiada.

2.)

El siguiente paso es conseguir la distribución de manpages-es y desenpaquetarla en un directorio local. Esta distribución se puede hallar en numerosos sitios, un buen punto de referencia es el hogar del proyecto . La última versión disponible es man-pages-es-0.2. Una vez bajada la distribución a un directorio local desempaquete el archivo comprimido mendiante el siguiente comando


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

      

Como resultado aparecerá un nuevo directorio llamado man-pages-es-0.2 que contiene las páginas de la distribución. Ahora podemos cambiar de directorio con


      cd man-pages-es-0.2

      

y examinar la distribución de manpages-es. Las páginas vienen en varias secciones (1,2,3,4,5,6,7,8) y se encuentran respectivamente en los subdirectorios man1, man2, .. man8. De interés para nosotros será el fichero makefile que usaremos para instalar las páginas. Exámine el makefile para entender lo que va a ocurrir durante la instalación.

3.) Para copiar las páginas a su sitio de destino simplemente ejecutamos 

      make install

      

Esto debe hacerse como superusuario "root" ya que debemos crear una jerarquía de ficheros bajo /usr/man. Al final, el escrito makefile habrá creado un directorio /usr/man/es bajo el que se encontrarán todas las secciones de las páginas de manual en castellano. Aquí termina el proceso de instalación.

Aquellos usuarios que tengan limitación en la cantidad de discos disponible pueden optar por instalar las páginas en su versión comprimida. Para poder optar por este método de instalación es necesario que el comando man instalado en el sistema sea capaz de leer páginas TROFF comprimidas. Nuevamente, a excepción de las distribuciones mas antiguas de linux, la mayoria de las distribuciones modernas ya implementan este tipo de comando man. En este caso, para instalar las páginas comprimidas ejecute los siguientes comandos


      make gz

      make install

      
4.)

Finalmente es necesario modificar el fichero /etc/../../common/November1997/man.config que controla la configuración del comando man. En concreto, solo tenemos hacer que man procese fuentes TROFF/NROFF con códigos de caracteres en Latin1. Como ejemplo doy el siguiente fichero ../../common/November1997/man.config que es el que utilizo en mi sistema. La única diferencia con el fichero de configuración original son las líneas


      NROFF  /usr/bin/groff -Tlatin1 -mandoc

      NEQN   /usr/bin/geqn -Tlatin1

      

donde especifico como output de groff y geqn el juego de caracteres Latin1.

Uso

No olvidar asignar las variables de entorno

Ya tenemos las páginas instaladas. Para poder usarlas cada usuario debe asignar dos variables de entorno, LANG y LESSCHARSET.La primera controla el locale, esto es el lenguage a usar en el entorno del shell activo. Si LANG=es entonces el comando man busca la pagina correspondiente bajo el directorio /usr/man/es (version castellana) y si no la encuentra pasa al directorio /usr/man (version inglesa).La segunda variable se usa para hacer que el paginador less active el procesamiento de caracteres Latin1. Por supuesto estamos asumiendo que hemos decidido usar less como paginador por defecto de man. Esta es la eleccion por defecto en el fichero ../../common/November1997/man.config dado como ejemplo anteriormente.Si el usuario usa el bash como shell ambas variables se pueden asignar apropiadamente mediante


    export LANG=es

    export LESSCHARSET=latin1

    

En caso de usar csh o tcsh entonces se usarian las siguientes instrucciones


    setenv LANG es

    setenv LESSCHARSET latin1

    

El usuario del sistema puede optar por poner dichas asignaciones en los ficheros de inicializacion del entorno (.bashrc o .login).


Para más información: