man page (Português)

Páginas man — abreviação para "páginas de manual" e tradução de man pages em inglês — são a forma de documentação que está disponível na maioria dos sistemas operacionais tipo UNIX, incluindo o Arch Linux. O comando usado para exibi-los é man.

Status de tradução: Esse artigo é uma tradução de Man page. Data da última tradução: 2022-08-01. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Artigos relacionados

Apesar de seu escopo, páginas man são projetadas para serem documentos autocontidos, consequentemente limitando-as a fazer referência a outras páginas man ao discutir assuntos relatados. Esse é um contraste nítido com os documentos info compatíveis com hiperlinks, a tentativa do GNU de substituir o formato tradicional de página man.

Instalação

man-db implementa man no Arch Linux, e o less é o paginador padrão usado com man. mandoc também pode ser usado.

man-pages fornece as páginas man do Linux e do POSIX.1 (veja ).

Algumas páginas man localizadas também estão disponíveis:

  • man-pages-cs para tcheco
  • man-pages-da para dinamarquês
  • para alemão
  • para espanhol
  • para francês
  • para húngaro
  • man-pages-it para italiano
  • man-pages-jaAUR para japonês
  • para macedônio
  • para holandês
  • para polonês
  • para português brasileiro
  • para romeno
  • para russo
  • para turco
  • para chinês simplificado
  • para chinês tradicional

Você também pode pesquisar todas as páginas de manual localizadas disponíveis nos repositórios oficiais e no AUR.

Você pode usar alguns aplicativos para visualizar páginas man:

  • GNOME Help — Visualização de ajuda para o GNOME. Ele pode mostrar páginas man via yelp man:<nome> ou a combinação de teclas não documentada Ctrl+L a partir de uma janela existente.
https://wiki.gnome.org/Apps/Yelp || yelp
  • KHelpCenter — Aplicativo para mostrar documentação dos aplicativos do KDE. Páginas man estão em Páginas de manual do UNIX ou executando khelpcenter man:<nome>.
https://userbase.kde.org/KHelpCenter || khelpcenter

Acessando páginas man

Para ler uma página man, basta digitar:

$ man nome_página

Manuais são ordenados em diversas seções. Cada seção tem uma introdução, tal como , e por aí vai. Para uma listagem completa, veja a seção intitulada "Sections of the manual pages" no .

Páginas man geralmente são referenciadas por seu nome, seguido do número de sua seção em parênteses. Geralmente há múltiplas páginas man com o mesmo nome, tal como e . Neste caso, forneça ao man o número da seção seguido pelo nome da página man. Por exemplo:

$ man 5 passwd

para ler a página man sobre , em vez do utilitário .

Ou, de forma equivalente, a página man seguida pelo número da seção, separado por um ponto:

$ man passwd.5

Pesquisando por manuais

As páginas man podem ser pesquisadas quando o nome exato de uma página não é conhecido usando qualquer um dos seguintes comandos equivalentes:

$ man -k expressão
$ man --apropos expressão
$ apropos expressão

expressão é interpretada como uma expressão regular por padrão.

Para pesquisar palavras-chaves em textos de páginas inteiras, use a opção .

Descrições de uma linha podem ser exibidas usando o comando . Por exemplo, para uma descrição breve das seções de página man sobre , digite:

$ whatis ls
ls (1p)              - list directory contents
ls (1)               - list directory contents

Largura de página

A largura de páginas man é controlada pela variável de ambiente .

Se o número de colunas no terminal é pequeno demais (ex.: a largura da janela é estreita), as quebras de linha ficarão erradas. Isso pode ser bem incômodo para ler. Você pode corrigir isso definindo MANWIDTH na invocação de man. Com , isso seria:

Lendo páginas man locais

Em vez da interface padrão, o uso de navegadores como e Firefox para visualizar páginas man permite que os usuários colham o principal benefício de texto hiperlink das páginas info. As alternativas incluem o seguinte:

mandoc

Instale o pacote mandoc. Para converter uma página, por exemplo :

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

Agora, abra o arquivo chamado free.html em seu navegador favorito.

man2html

Primeiro, instale dos repositórios oficiais.

Agora, converta uma página man:

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

Outro uso para é exportar para texto não tratado, no formato de impressão:

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

man -H

A implementação de man-db também tem a capacidade de fazer isso por conta própria:

$ man -H free

Isso vai ler sua variável de ambiente para determinar o navegador. Você pode sobrepor isso passando o executável para a opção .

roffit

Primeiro, instale do AUR.

Para converter uma página man:

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

Conversão para PDF

Páginas man sempre foram imprimíveis: elas são escritas em , que é fundamentalmente uma linguagem de formatação de texto. Portanto, você pode facilmente converter páginas man para qualquer um dos formatos suportados como dispositivos de saída por groff, que é usado por man-db. Para uma lista de dispositivos de saída, veja a opção em groff(1) (ou se você usar o pacote mandoc).

Isso vai produzir um arquivo PDF:

$ man -Tpdf página_man > arquivo

Ressalvas: Fontes são geralmente limitadas a Times em tamanhos fixos. Algumas páginas man foram projetadas especificamente para ver no terminal e não ficarão bem na forma de PS ou PDF.

Páginas man online

Há vários bancos de dado online de páginas man, incluindo:

Observe que enquanto man-pages fornece as páginas man para POSIX.1 (veja ), uma referência online oficial também existe:

Há também uma tabela comparativa dos bancos de dados online.

Páginas man notáveis

Aqui está uma lista não exaustiva de páginas dignas de nota que podem lhe ajudar a entender muitas coisas em profundidade. Alguns deles podem servir como uma boa referência (como a tabela ASCII).

De forma mais geral, dê uma olhada nas páginas de categoria 7 (miscelânea):

$ man -s 7 -k ".*"

Páginas específicas do Arch Linux:

Veja também
gollark: KaTeX is allegedly faster than Mathjax.
gollark: I'm also planning to add KaTeX maths blocks.
gollark: Mine uses full CommonMark-GFM.
gollark: https://git.osmarks.net/osmarks/minoteaur/src/branch/master/src/md.nim
gollark: Which it shouldn't unless you run out of memory or your computer explodes.
This article is issued from Archlinux. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.