man page (Español)

Las man pages (abreviatura de «manual pages» o páginas de manual) es una forma de documentación que está disponible en casi todos los sistemas operativos derivados de UNIX, incluyendo Arch Linux. Para acceder a estas, use el comando man.

Esta traducción de man page fue revisada el 2022-11-01. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Artículos relacionados

A pesar de la amplia cantidad de temas que estas pueden abordar, están diseñadas para ser independientes entre si; limitándose a simplemente hacer mención a otras páginas de manual cuando sea necesario. Esta es una diferencia notable con el uso de enlaces en el intento de GNU por reemplazar este tradicional formato: los documentos de información.

Instalación

El paquete man-db es la implementación de man en Arch Linux, y less es el paginador que se usa por defecto. También puede utilizar mandoc.

man-pages provee tanto las páginas de manual del sistema operativo Linux como de POSIX.1 (véase ).

Están disponibles las siguientes traducciones:

  • man-pages-cs para el checo
  • para el denés
  • man-pages-de para el alemán
  • para el griego
  • para el español
  • para el finés
  • man-pages-fr para el francés
  • para el húngaro
  • para el indonesio
  • para el italiano
  • para el japonés
  • para el macedonio
  • man-pages-nl para el holandés
  • para el polaco
  • para el portugués de brasil
  • para el rumano
  • man-pages-ruAUR para el ruso
  • para el serbio
  • para el sueco
  • para el turco
  • para el ucraniano
  • para el vietnamita
  • para el chino simplificado
  • para el chino tradicional

También puede buscar todas las páginas man localizadas disponibles en los repositorios oficiales y ?K=man-pages- en AUR.

También puede usar otras aplicaciones para ver las páginas de manual:

  • KHelpCenter — Aplicación para visualizar la documentación de las aplicaciones de KDE. Las páginas de manual están en «Páginas de manual de UNIX» o puede acceder a estas ejecutando khelpcenter man:<nombre>.
https://userbase.kde.org/KHelpCenter/es || khelpcenter
  • Konqueror — Gestor de archivos y navegador de KDE. Puede mostrar páginas de manual con man:<nombre>.
https://apps.kde.org/es/konqueror/ || konqueror

    Acceder a las páginas del manual

    Para leer una página del manual, introduzca:

    $ man nombre_de_página

    Los manuales se clasifican en varias secciones. Cada sección tiene una introducción, como , , etc. Para obtener una lista completa, véase .

    Para referirse a las páginas, utilice su nombre y el numero de sección en paréntesis. Pueden haber distintas páginas con el mismo nombre, como y . En estos casos, para acceder a una o la otra, ingrese el numero de la sección y el nombre de la página del manual; por ejemplo use:

    $ man 5 passwd

    Para leer la página acerca del archivo , en vez de la que trata la orden .

    De igual manera, puede escribir el nombre y el numero de sección separados por un punto:

    $ man passwd.5

    Búsqueda de manuales

    Para buscar una página del manual sin saber su nombre exacto, puede usar cualquiera de los siguientes comandos:

    $ man -k expresión
$ man --apropos expresión
$ apropos expresión

    Note que expresión es interpretado como una expresión regular por defecto.

    Para buscar palabras clave dentro del texto completo de las páginas, ocupe la opción .

    Puede ver una descripcion de una línea de las páginas del manual usando el comando . Por ejemplo, para una breve descripción de las páginas del manual de en distintas secciones, escriba:

    $ whatis ls
    ls (1)               - lista el contenido de un directorio
ls (1p)              - list directory contents

    Ancho de página

    El ancho de la página es controlado por la variable de entorno .

    Si el numero de columnas en la terminal es muy pequeño (p.ej cuando se usa una ventana estrecha), los saltos de línea van a quedar mal ubicados, lo cual puede resultar en un texto desagradable de leer. Puede arreglar esto estableciendo MANWIDTH al invocar man. En puede hacerlo de la siguiente manera:

    Leyendo páginas del manual locales

    En vez de usar la interfaz estándar, usar navegadores como y Firefox para ver las páginas del manual permite a los usuarios sacarle partido al principal beneficio de las páginas info: el texto con hipervínculos. Para hacerlo, tiene varias formas:

    mandoc

    Instale el paquete mandoc. Para convertir una página, por ejemplo , ejecute:

    $ mandoc -Thtml -Ostyle=style.css /usr/share/man/man1/free.1.gz > free.html

    Ahora abra el fichero llamado free.html en su navegador favorito.

    man2html

    Primero, instale desde los repositorios oficiales.

    Ahora, convierta de esta forma una página del manual:

    $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

    Otro uso para es exportar texto con formato mínimo y listo para imprimir:

    $ man free | man2html -bare > ~/free.txt

    man -H

    La implementación de man-db de Arch Linux también puede hacer esto sin necesidad de otros paquetes:

    $ man -H free

    Esto buscará la variable de entorno para determinar que navegador usa por defecto. Sino, puede pasar como argumento el binario a la opción .

    roffit

    Primero instale desde el AUR.

    Para convertir una página del manual:

    $ gunzip -c /usr/share/man/man1/free.1.gz | roffit > free.html

    Conversión a PDF

    Las páginas del manual siempre han sido imprimibles: están escritas en , que esencialmente es un lenguaje de composición tipográfica. Por esto, usted puede convertir las páginas del manual a cualquier formato según los dispositivos de salida que groff (usado por man-db) soporte. Para ver una lista de estos dispositivos, vea la opción -T en o si ocupa mandoc.

    Use el siguiente comando para convertir en PDF:

    $ man -Tpdf pagina_del_manual > nombre_de_archivo

    Limitaciones: Las fuentes están generalmente limitadas a Times a tamaños prefijados. Algunas páginas del manual están específicamente diseñadas para verlas en terminal, y por ello no se visualizarán correctamente en PS o en PDF.

    Páginas del manual en línea

    Existen numerosas bases de datos de páginas de manual en línea, incluyendo:

    Tenga en cuenta que aunque man-pages proporciona páginas de manual para POSIX.1 (véase ), también existe una referencia oficial en línea:

    También está disponible una tabla de comparación entre estas de las bases de datos en línea.

    Páginas del manual de especial interés

    A continuación se muestra una lista no exhaustiva de páginas de especial interés que podrían ayudarle a comprender muchas cosas en mayor profundidad. Algunas de ellas podrían servir como buena referencia (como la tabla ASCII).

    De formas más general, eche un vistazo a las páginas de la categoría 7 (misceláneos):

    $ man -s 7 -k ".*"

    Páginas específicas de Arch Linux:

    Véase también
    gollark: (also, your bot is in fact *small*)
    gollark: Why?
    gollark: <@319753218592866315> EXPLAIN YOUR HERESY
    gollark: For asynchronous code in python you need to use aiosqlite, but that's basically the same.
    gollark: What? Why?
    This article is issued from Archlinux. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.