Help:Laptop page guidelines (Português)

Status de tradução:
Esse artigo é uma tradução de
Help:Laptop page guidelines
. Data da última tradução: 2023-08-09. Você pode ajudar a sincronizar a tradução, se houver
alterações
na versão em inglês.
Este artigo unifica o estilo e o layout de todas as páginas do laptop e apresenta diretrizes e
padrões
para garantir que as páginas do laptop sejam e permaneçam de alta qualidade. Isso garante que as páginas não retornem para apenas despejos de saída
lspci
/
lsusb
ou notas pessoais de um usuário sobre seu dispositivo.
Geral
Adicione uma
categoria apropriada
à página, por exemplo
Category:Dell
. Se não houver categoria para o seu fornecedor, crie uma.
O nome da página deve ser "Fabricante modelo número". Por exemplo, "Lenovo ThinkPad X1 Carbon".
Não
crie um redirecionamento que apenas omita o nome do fornecedor. Por exemplo, "X1 Carbon" ou "ThinkPad X1 Carbon".
Dica
Se você não sabe como sua página deve se parecer,
Dell Latitude 3500
é uma página de exemplo que segue essas diretrizes.
Não duplique o conteúdo das diretrizes gerais
Laptop
. Uma seção contendo, por exemplo, "A webcam deste dispositivo funciona bem" não ajudará ninguém, então não adicione uma seção se não houver instruções especiais para ela. Além disso, evite mencionar o conteúdo específico do ambiente gráfico ou do gerenciador de janelas. Isso também se aplica a outras coisas que estão documentadas no ArchWiki, por exemplo, não inclua instruções sobre como fazer o flash do archiso em um pendrive, apenas crie um link para a página contendo as instruções. Isso resultará em menor necessidade de manutenção.
Adicionando informações de hardware
Atenção
Mantenha todas as linhas o mais curtas possível porque uma tabela larga é difícil de ler e torna a página desorganizada.
Certifique-se que a tabela esteja acima de
prefácio ou introdução
ou a posição da tabela vai mudar.
Adicione uma tabela com
class="wikitable archwiki-table-laptop"
no início da página com as seguintes colunas:
Hardware
Deve conter o nome abreviado da parte, como "Bluetooth" ou "Fingerprint reader".
Apenas anexe o nome do fornecedor à peça se houver mais de um. Um exemplo comum para isso seria mais de uma GPU (consulte a tabela abaixo).
Considere executar
hw-probe
fazer todo o conjunto de hardware conhecido pelo
Linux Hardware Database
.
PCI/USB ID
Deve conter o PCI ou USB ID da peça, se disponível. Isso é importante porque alguns laptops podem ter diferentes hardwares.
lsusb
mostra o ID de USB por padrão,
lspci
pode ser executado com
-nn
para obter o ID de PCI de dispositivos.
Se houver um ID de PCI/USB sem um nome, considere contribuir com a peça ao
repositório de ID de PCI
ou o
repositório de ID de USB
, respectivamente.
Se não houver um ID de PCI/USB aplicável para este dispositivo, deixe a coluna vazia. Não coloque
Template:-
, traços ou qualquer outra coisa na coluna.
Working?
Deve conter
Template:Yes
ou
Template:No
. Se estes não forem aplicáveis, use
Template:Y
e uma descrição
breve
e adequada de seu status, como "Untested" or "Partial".
Use "Partial" quando a peça ainda não funcionar corretamente com as modificações aplicáveis.
Use
Template:Yes
mesmo se você precisar instalar um driver externo.
Dica
Se alguma parte requer instruções especiais, encoraja-se a adicionar uma seção apenas para esta parte. Infelizmente, isso desordena a página ao usar
certas seções padrão
, então
evite
usar "Known issues", "Troubleshooting" e "Tips and Tricks".
Nota
Em artigos traduzidos, utilize os nomes de colunas "Hardware", "ID de PCI/USB" e "Funciona?", usando, na última coluna,
Template:Sim
,
Template:Não
e
Template:Y
.
Informações de módulo do kernel
Não coloque as informações do módulo do kernel na tabela ou em uma seção separada para a parte. Isso geralmente é inútil porque há apenas um módulo para esta parte. Isso não se aplica se houver diferentes drivers para escolher, mas isso deve ser especificado na seção da peça, não na tabela.
Tabela exemplo
O código a seguir será exibido como o exemplo à direita:
{| class="wikitable archwiki-table-laptop"
|-
! Hardware !! PCI/USB ID !! Working?
|-
| Bluetooth || {{ic|1234:abcd}} || {{Yes (Português)}}
|-
| Webcam || {{ic|abcd:1234}} || {{No (Português)}}
|-
| GPU (Intel) || {{ic|8086:0000}} || {{Yes (Português)}}
|-
| GPU (NVIDIA) || {{ic|10de:1111}} || {{No (Português)}}
|-
| Other part || {{ic|0000:aaaa}} || {{Y|Untested}}
|-
|}
Hardware
PCI/USB ID
Working?
Bluetooth
1234:abcd
Yes
Webcam
abcd:1234
No
GPU (Intel)
8086:0000
Yes
GPU (NVIDIA)
10de:1111
No
Other part
0000:aaaa
Untested
Lista de partes comuns
Bluetooth
Webcam
Ethernet
Wifi
GPU
Touchpad
Keyboard (Teclado)
TPM
Fingerprint reader (Leitor de impressão digital)
SD-card reader (Leitor de cartão SD)
Speakers (Alto-falantes)
Microphone (Microfone)
Ambient light sensor (Sensor de luz ambiente)
Nota
Em artigos traduzidos, utilize o texto entre parênteses, quando houver.
Se alguma das portas (USB, HDMI, Ethernet), ou hardware crítico como controladora da ventoinha, não funcionar fora da caixa, adicione uma seção para ela e também adicione-a à tabela. Certifique-se de não incluir instruções específicas sobre o ambiente gráfico/gerenciador de janelas. As seções deve estar entre a seção "Firmware" e "Function keys".
Não coloque "Fn keys", "Suspend"/"Hibernate" ou "Power management" na tabela.
Artigos relacionados
Como todas as páginas de laptop devem conter uma tabela de hardware flutuante à direita, o uso de
Template:Related
conforme descrito em
Help:Estilo#Caixa de artigos relacionados
é substituído pelo uso de
somente
a
seção "See also"
ou links diretos dentro de seções relevantes para evitar que elementos flutuantes à direita entrem em conflito uns com os outros.
Seção "Installation"
Esta seção deve conter as informações necessárias para instalar o Arch Linux neste dispositivo. Isso inclui, mas não está limitado a:
Parâmetros do kernel
Configurações importantes de firmware (Veja também
#Seção "Firmware"
)
Isso não inclui configurações óbvias como alterar o dispositivo de inicialização.
É encorajado adicionar links para postagens relevantes nos fóruns, como
este exemplo de postagem
focando em um problema com dispositivos Dell.
Se um dispositivo precisa de um firmware especial para instalação como, por exemplo, um pacote do
AUR
para conectividade de rede, torne o requisito proeminente.
Omita esta seção se não houver peculiaridades que precisem ser abordadas.
Nota
Em artigos traduzidos, utilize o nome de seção "Instalação".
Seção "Accessibility"
Atenção
Adicionar esta seção a uma página de laptop é obrigatório. Não é opcional, pois as informações são essenciais para que usuários com deficiência decidam se é possível instalar o Arch Linux em tal dispositivo sem ajuda.
Para ajudar usuários com deficiência a instalar o Arch Linux no dispositivo, adicione algumas informações de acessibilidade. Isso inclui, mas não está limitado a:
A aparência do firmware. Considere as configurações necessárias para alterar para inicializar uma mídia de instalação oficial do Arch Linux.
Interfaces de firmware mais recentes podem ser mais difícil de analisar com o software OCR em telefones, o que os usuários cegos usam com frequência como ferramenta no dia a dia. Se houver uma opção para reverter o design padrão para o design "clássico", adicione instruções para isso.
Alguns firmware requerem até mesmo o uso de um mouse e/ou são excessivamente complexos. Se não for possível alterar as configurações sem visão, adicione uma nota descrevendo isso. Por exemplo:
Note
Blind users should request the help of a sighted person to change firmware settings.
Algumas interfaces de firmware podem usar botões de opção e menus bem compactados extensivamente, o que pode impedir que usuários com doença de Parkinson alterem determinadas configurações.
Consulte uma seção relevante do manual oficial (consulte
#Seção "See also"
) para o seu dispositivo que contém uma lista de todos os atalhos necessários para navegar no firmware e para acionar certas ações, como alterar o dispositivo de inicialização.
Se tal manual não existir, você pode adicionar uma lista à seção.
Alguns dispositivos podem ter um LED de diagnóstico, que visualiza códigos de bipe. Isso é útil para usuários surdos.
Adicione uma observação se houver apenas um LED de diagnóstico, mas nenhum código de bipe.
Nota
Em artigos traduzidos, utilize o nome de seção "Acessibilidade" e use a Nota para usuários cegos em sua versão traduzida.
Seção "Firmware"
A página deve conter uma breve nota descrevendo o suporte a
fwupd
para este dispositivo.
Uma página deve incluir uma seção de firmware, quando houver um comportamento especial do qual o usuário deve estar ciente. Isso inclui, mas não está limitado ao seguinte:
Certas configurações opcionais de firmware que podem melhorar a compatibilidade deste dispositivo
Peculiaridades de firmware que podem impactar a instalação
Informações sobre
SecureBoot
As chaves personalizadas funcionam bem neste dispositivo?
Há alguma configuração especial de firmware que precisa ser alterada para isso?
Existem outras especialidades que o usuário deva conhecer?
O firmware armazena imagens ou logs de recuperação em um caminho especial? É importante saber isso ao escolher o tamanho de uma
partição de sistema EFI
.
Às vezes é crucial atualizar o firmware porque corrige bugs críticos. Se houver alguma atualização de firmware importante, mencione-a nesta seção.
Seção "Function keys"
Adicione uma tabela com as seguintes colunas:
Nota
Lembre-se de seguir as
diretrizes de estilo para teclas de atalho
.
Key
A tecla que deve ser pressionada. Elas geralmente iniciam-se com
Fn
Visible?
Use
Template:Yes
ou
Template:No
, dependendo se ferramentas como
xev
podem ver esta tecla.
Marked?
Use
Template:Yes
ou
Template:No
, dependendo se a tecla física tem um símbolo, que descreve sua função.
Effect
Geralmente, as teclas de função emitem uma tecla ou o firmware faz algo quando a tecla é pressionada.
Especifique a tecla quando uma tecla é emitida, como
XF86MonBrightnessDown
.
Uma tecla pode ter um efeito especial que deve ser mencionado, como dispositivos de rede em
hard block
.
Não adicione instruções específicas de ambiente gráfico/gerenciador de janela.
Há algumas teclas que são vinculadas a systemd-logind por padrão, o que deve ser marcado (veja a tabela abaixo).
Nota
Em artigos traduzidos, utilize o nome de seção "Teclas de função", os modelos
Template:Sim
e
Template:Não
, e os nomes de colunas "Tecla", "Visível?", "Marcada?" e "Efeito".
Capturando teclas de função
É possível capturar teclas de função usando
xev
(
xorg-xev
) ou
wev
(
wev
AUR
). Há também
libinput debug-events
, mas já que muitos compositores Wayland usam
xkbcommon
, os nomes Xorg específicos devem ser preferidos.
Ambientes de desktop
e também alguns
gerenciadores de janela
podem vir com uma configuração padrão que captura todas as teclas de função, já que gerenciam elas. Use temporariamente um gerenciador de janelas mínimo como
Openbox
para capturar as teclas, se for o caso.
Algumas teclas de função (como
XF86Sleep
) podem ser vinculados a
systemd-logind
, o que significa que elas não podem ser capturadas com uma ferramenta por padrão. Use
systemd-inhibit
para suspender temporariamente a manipulação de certas teclas:
# systemd-inhibit --what=handle-suspend-key sleep 1h
Enquanto este comando estiver em execução,
systemd-logind
irá ignorar o pressionamento desses botão e capturar corretamente o pressionamento de botão é possível.
Nota
Se a tecla ainda estiver invisível, pode ser vinculada ao firmware ou um módulo do kernel a está manipulando.
Tabela exemplo
Key
Visible?
1
Marked?
2
Effect
Fn+Esc
Não
Sim
Toggles Fn lock
Fn+F1
Sim
Sim
XF86AudioMute
Fn+F2
Sim
Sim
XF86AudioLowerVolume
Fn+F3
Sim
3
Sim
XF86Sleep
...
Não
Não
Fitting description
The key is visible to
xev
and similar tools.
The physical key has a symbol on it, which describes its function.
systemd-logind handles this by default.
Seção "See also"
Esta seção deve conter links úteis que incluem, mas não se limitam ao seguinte:
Outras páginas wiki externas relacionadas, como o ThinkWiki.
Páginas oficiais do manual fornecidas pelo fabricante, que podem ser úteis ao depurar problemas de firmware.
Páginas do
verification.ubuntu.com
, que podem ser uma fonte útil para IDs de PCI/USB e variações de hardware.
Um link para a
sonda do Linux Hardware Database
, que fornece informações sobre compatibilidade e IDs de PCI/USB.
Nota
Em artigos traduzidos, utilize o nome de seção "Veja também".