| Noticias Archivos Compañias Consejos y Trucos |
Instalación de Manpages-espor 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
export LANG=es
export LESSCHARSET=latin1
En caso de usar
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). |