Help:Reading (Português)

Status de tradução:
Esse artigo é uma tradução de
Help:Reading
. Data da última tradução: 2024-09-22. Você pode ajudar a sincronizar a tradução, se houver
alterações
na versão em inglês.
Artigos relacionados
Help:Navegação
Help:Estilo
Porque a vasta maioria do ArchWiki contém indicações que podem precisar de clarificação para usuários novos ao Arch Linux (ou GNU/Linux em geral), esse resumo de procedimentos básicos foi escrito para evitar confusão na assimilação dos artigos e para evitar repetição de conteúdo.
Organização
A maioria dos artigos no ArchWiki não tentam fornecer uma introdução holística a um único tópico; eles são escritos em conformidade ao princípio
"Don't Repeat Yourself"
("Não se repita"), sob a presunção de que o usuário vai buscar e ler qualquer material de suporte que ele ainda não entenda. Quando possível, tal material de suporte é indicado no artigo por um formato especial, veja
#Formatação
.
Por causa dessa organização, pode ser necessário examinar diversas fontes pra entender completamente um artigo do ArchWiki. Em particular, usuários que são novos no Arch (ou GNU/Linux em geral) devem esperar acabar lendo um grande número de artigos mesmo para resolver problemas simples. É especialmente importante estudar o material de suporte antes de procurar por ajuda adicional de outros usuários.
Formatação
link para uma seção no artigo atual:
#Organização
link para
outro artigo do ArchWiki
link para uma
página web externa
link para uma
página man
:
intro(1)
uma
página man
que está disponível offline:
foo(1)
link para um pacote nos
repositórios oficiais
:
foobar
link para um pacote no
AUR
:
foobar
AUR
Root, usuário comum ou outro usuário
Algumas linhas são escritas assim:
# mkinitcpio -p linux
Outras possuem um prefixo diferente:
$ makepkg -s
O sinal de cerquilha ou tralha (
#
) indica que o comando precisa ser executado como o superusuário (
root
), sendo que o sinal de cifrão (
$
) mostra que o comando deve ser executado como um
usuário comum
.
Nota
Os comandos prefixados com
#
destinam-se a serem executados de um
shell de root
, que pode, por exemplo, ser facilmente acessada com
sudo -i
. Executar
sudo
comando
de um shell sem privilégios em vez de
comando
de um shell de root também funcionará na maioria dos casos, com algumas exceções notáveis como
redirecionamento
e
substituição de comando
, que requer estritamente um shell de root. Veja também
sudo
.
Quando os comandos precisam ser executados como um usuário específico, eles serão prefixados pelo nome de usuário entre colchetes, por exemplo:
[postgres]$ initdb -D /var/lib/postgres/data
Isso significa que você deve usar uma
ferramenta de elevação de privilégios
, por exemplo, com
sudo
:
$ sudo -u postgres initdb -D /var/lib/postgres/data
Uma exceção notável para ter cuidado com:
# Esse alias faz o ls colorizar a listagem
alias ls='ls --color=auto'
Neste exemplo, o contexto do sinal de cerquilha comunica que isso não deve ser executado como um comando; em vez disso, deve ser editado em um arquivo. Então, neste caso, o sinal de cerquilha representa um
comentário
. Um comentário pode ser um texto explicativo que não será interpretado pelo programa associado. A denotação de scripts
Bash
para comentário se parece com o
PS1
de root.
Após uma observação mais detalhada, nota-se que os comentários geralmente se iniciam com caractere maiúsculos logo após o sinal
#
. Geralmente, comandos Unix não são escritos desta forma e, na maioria das vezes, elas são abreviações em vez de palavras completas em inglês (ex.:,
Copy
se torna
cp
).
Independentemente, a maioria dos artigos facilita o discernimento notificando os leitores:
Acrescente
ao
~/caminho/para/arquivo
:
# Esse alias faz o ls colorizar a listagem
alias ls='ls --color=auto'
Acrescentar, adicionar, criar, editar
Ao ser solicitado a
acrescentar a
,
adicionar a
,
criar
ou
editar
um ou mais arquivos, está implícito que você deve usar um dos seguintes métodos.
Para criar ou modificar arquivos multilinha, sugere-se usar um
editor de texto
. Por exemplo, usando o comando
nano
para editar o arquivo
/etc/bash.bashrc
:
# nano /etc/bash.bashrc
Nota
Os arquivos de texto devem terminar com uma nova linha porque
uma linha
é terminada com uma nova linha. A maioria dos editores de texto insere uma nova linha final por padrão.
Para criar ou sobrescrever um arquivo de uma string, pode ser mais simples usar um
redirecionamento da saída
. O exemplo a seguir cria ou sobrescreve os conteúdos do arquivo
/etc/hostname
com o texto
meuhostname
.
# echo meuhostname > /etc/hostname
Redirecionamento de saída também pode ser usado para anexar um texto a um arquivo. O exemplo a seguir acrescenta o texto
[repo-personalizado]
ao final do arquivo
/etc/pacman.conf
.
# echo "[repo-personalizado]" >> /etc/pacman.conf
Ao ser solicitado a criar
diretórios
, use o comando
mkdir
:
# mkdir /mnt/boot
Tornar executável
Após criar um arquivo, se ele é feito para ser executado com um script (seja manualmente ou chamado por um outro programa), ele precisa ser definido como
executável
, por exemplo com:
$ chmod +x
script
Veja
chmod
. Alguns aplicativos como
gerenciador de arquivos
podem fornecer interfaces gráficas para fazer o mesmo.
Source
Alguns aplicativos, notavelmente
shells de linha de comando
, usam scripts para suas configurações: após modificá-los, eles devem ser carregados, usando o
source
, de forma que as alterações sejam aplicadas. No caso do
bash
, por exemplo, isso é feito executando (você também pode substituir
source
por
.
):
$ source ~/.bashrc
Quando o wiki sugere modificar tal script de configuração, ele não vai lembrar-lhe explicitamente de carregar o arquivo, e apenas em alguns casos ele vai apontar essa seção com um link de lembrete.
Instalação de pacotes
Quando um artigo o convida para instalar alguns pacotes na forma convenciona, ele não vai indicar as instruções detalhadas para fazê-lo; ele vai simplesmente mencionar os nomes dos pacotes a serem instalados.
Nota
Com frequência, os links
install
ou
installed
(em português,
instale
são usados para apontar para essa seção de artigo. Porém, JavaScript tem que estar habilitado para esses links funcionarem.
As subseções abaixo fornecem uma visão geral dos procedimentos genéricos de instalação dependendo do tipo de pacote.
Pacotes oficiais
Para pacotes dos
repositórios oficiais
, você precisará ler alguma coisa como:
Instale o pacote
foobar
.
Isso significa que você tem que executar:
# pacman -S foobar
O artigo do
pacman
contém explicações detalhadas para lidar com gerenciamento de pacote na proficiência do Arch Linux.
Arch User Repository
Para pacotes do
Arch User Repository
(AUR) você lerá alguma coisa como:
Instale o pacote
foobar
AUR
.
Isso significa que, em geral, você tem que seguir o link
foobar
AUR
, baixar o pacote com o PKGBUILD, extraí-lo,
verificar o conteúdo
e, finalmente, executar na mesma pasta:
$ makepkg -si
Nota
O metapacote
base-devel
é necessário para construir pacotes do AUR ou com o
sistema de compilação do Arch
.
O artigo do
Arch User Repository
contém todas as explicações detalhadas e melhores práticas para lidar com pacotes do AUR.
Controle de unidades do systemd
Quando um artigo o convida para
start
(iniciar),
enable
(habilitar), etc., alguma unidade de systemd (ex.: um serviço), ele não indicará as instruções detalhadas para fazê-lo; em vez disso, você lerá, em páginas em inglês, alguma coisa como:
Start
exemplo.service
.
Isso significa que você tem que executar:
# systemctl start exemplo.service
Um comando notável que não segue esse padrão exato é
daemon-reload
, que será chamado sem argumentos.
A seção
systemd#Usando units
contém uma lista estruturada de ações disponíveis (como
start
,
enable
,
enable and start
, etc.) com seus comandos
systemctl
correspondentes.
Configuração do sistema versus específica do usuário
É importante se lembrar que há dois tipos diferentes de configurações em um sistema GNU/Linux. A configuração
do sistema
afeta todos os usuários. Já que as configurações dos sistemas geralmente estão localizados no diretório
/etc
, privilégios de root são exigidos para alterá-los. Por exemplo, para aplicar uma configuração de Bash que afeta todos os usuários,
/etc/bash.bashrc
deve ser modificado.
Configuração
específico do usuário
afeta apenas um único usuário.
Dotfiles
, que são arquivos iniciados com ponto, são usados para configuração específica do usuário. Por exemplo, o arquivo
~/
.
bashrc
é o arquivo de configuração específica de usuário. A ideia é que cada usuário pode definir suas próprias configurações, tal como
aliases
, funções e outros recursos interativos como o prompt, sem afetar as preferências de outros usuários.
Nota
~/
e
$HOME
são atalhos para o diretório home do usuário, geralmente
/home/
nomedeusuário
/
.
Arquivos de shell comum
Bash e outros shells compatíveis com Bourne, tal como
Zsh
, também carregam arquivos dependendo do shell ser um
shell de login
ou um
shell interativo
. Veja
Bash#Configuration files
e
Zsh#Startup/Shutdown files
para detalhes.
Pseudo-variáveis no exemplos de código
Alguns blocos de código podem conter as chamadas
pseudo-variáveis
, que, como o nome sugere, não são realmente variáveis usadas no código. Em vez disso, elas são substitutos genéricos e têm que ser substituídos manualmente com itens de configuração do sistema
antes
do código poder ser executado ou analisado. Shells comuns como
bash
e
zsh
fornecem
completação por tab
para autocompletar parâmetros para comandos comuns, tal como
systemctl
.
Nos artigos que estão em conformidade com
Help:Estilo/Formatação e pontuação
,
pseudo-variáveis
são formatadas em itálico. Por exemplo:
Enable
(equivalente a
Habilite
) o
dhcpcd@
nome_interface
.service
para a interface de rede identificada a partir da saída do comando
ip link
.
Neste caso
nome_interface
é usado como um substituto
pseudo-variável
em uma unidade modelo de systemd. Todas as unidades modelo de systemd, identificáveis pelo sinal
@
, exigem um item de configuração do sistema como argumento. Veja
systemd#Usando units
.
O comando
dd if=
origem_dados
of=/dev/sd
X
bs=
tamanho_setor
count=
número_setor
seek=
setor_início_partições
pode ser executado como root para apagar uma partição com parâmetros específicos.
Neste caso, as
pseudo-variáveis
são usadas para descrever os parâmetros que devem ser substituídos por elas. Detalhes sobre como juntá-las são elaborados na seção
Securely wipe disk#Calculate blocks to wipe manually
, que fornece o comando.
No caso dos exemplos de arquivos, colar pseudo-variáveis em arquivos de configuração reais pode quebrar os programas que os usam.
Reticências
Na maioria dos casos, as reticências (
...
) não são parte do conteúdo do arquivo ou saída de código e, em vez disso, representam texto omitido ou opcional que não é relevante para o assunto discutido.
Por exemplo
HOOKS="... encrypt ... filesystems ..."
ou:
/etc/X11/xorg.conf.d/50-synaptics.conf
Section "InputClass"
    ...
    Option      "CircularScrolling"          "on"
    Option      "CircScrollTrigger"          "0"
    ...
EndSection
Esteja ciente de que, em alguns casos, reticências podem ser parte significante da sintaxe do código: usuários atenciosos serão capazes de reconhecer facilmente esses casos pelo contexto.