Help:Reading (Español)

Esta traducción de
Help:Reading
fue revisada el
2022-10-30
. Si existen
cambios
puede
actualizarla
o avisar al
equipo de traducción
.
Artículos relacionados
Ayuda:Navegación
Ayuda:Estilo
Debido a que la gran mayoría de los artículos de ArchWiki contienen indicaciones que requieran aclaraciones para los nuevos usuarios de GNU/Linux, este resumen de los procedimientos básicos fue escrito tanto para evitar la confusión en la comprensión de los artículos como para disuadir de la repetición del contenido mismo.
Organización
La mayoría de los artículos en ArchWiki no intentan proporcionar una introducción holística a un solo tema; en su lugar, se escriben de acuerdo con el principio
DRY
, bajo la suposición de que el usuario buscará y leerá cualquier material de apoyo para aquello que aún no comprenda. Siempre que sea posible, dicho material de apoyo se indicará en el artículo mediante un formato especial, véase
#Formato
.
Debido a esta organización, puede ser necesario examinar varias fuentes relacionadas para comprender completamente un artículo de ArchWiki. En particular, los usuarios que son nuevos en Arch (o GNU/Linux en general) deben asumir que tendrán que leer una gran cantidad de artículos, incluso para aquellos que resuelven problemas simples. Es especialmente importante estudiar el material de apoyo antes de buscar ayuda adicional de otros usuarios.
Formato
Enlazar a una sección del artículo actual:
#Organización
Enlazar a
otro artículo de ArchWiki
Enlazar a una
página web externa
Enlazar a una
página de manual
:
intro(1)
Una
página de manual
que solo está disponible sin conexión:
foo(1)
Enlazar a un paquete en los
official repositories (Español)
:
foobar
Enlazar a un paquete en
AUR (Español)
:
foobar
AUR
Usuario normal o root
Algunas líneas se escriben así:
# mkinitcpio -p linux
Otras tienen un prefijo diferente:
$ makepkg -s
El símbolo (
#
) indica que la orden se debe ejecutar como
root
(o con privilegios de root), mientras que el símbolo (
$
) indica que la orden se ejecuta como
usuario normal
.
Nota
Las órdenes precedidas del prefijo
#
están pensadas para ser ejecutadas desde un
intérprete de órdenes de root
, las cuales pueden ser fácilmente ejecutadas con
sudo -i
, por ejemplo. Ejecutar
sudo
orden
desde un intérprete de órdenes sin privilegios, en lugar de ejecutar la
orden
desde un intérprete de órdenes de root funcionará igualmente en la mayoría de los casos, con algunas excepciones notables, como
redirection
,que reclama imperiosamente un intérprete de órdenes de root. Véase también
sudo (Español)
.
Una excepción importante a tener en cuanta consistiría en:
# Este alias indica a la orden ls que coloree el listado saliente
alias ls='ls --color=auto'
En este ejemplo, el contexto que rodea al signo almohadilla nos permite deducir que la línea subsiguiente no es una orden que deba ser ejecutada, sino que, en su lugar, debe ser interpretada como una modificación de un archivo de texto. Así, en este caso, el signo almohadilla denota un
comentario
. Comentar una línea en un archivo de texto indica al programa asociado que ignore su contenido, en este caso, el comentario va seguido de un texto explicativo sobre la función del alias. Los scripts de
bash
hacen esta interpretación de los comentarios coincidiendo con root
PS1
.
Si se hace una observación más detallada,  se
deduce
el significado del simbolo almohadilla, el cual no debe ser interpretado como la iniciación a una orden, al incluir una letra en mayúsculas a continuación del signo
#
. Por lo general, las órdenes de Unix no se escriben de esta manera y la mayoría de las veces son abreviaturas cortas correspondiente a las palabras en inglés (por ejemplo,
Copy
se convierte en
cp
).
De todos modos, la mayoría de los artículos permiten discernir ésto fácilmente, mediante indicaciones al lector, como:
Agregue
a
~/ruta/al/archivo
:
# Este alias indica a la orden ls que coloree el listado saliente
alias ls='ls --color=auto'
Adjuntar, añadir, crear, editar
Cuando se le solicita
adjuntar a
,
añadir a
,
crear
o
editar
uno o más archivos, ello implica que debe usar uno de los siguientes métodos.
Para crear o modificar archivos de líneas múltiples, se sugiere el uso de un
editor de texto
. Por ejemplo, para utilizar la orden
nano
para hacer las modificaciones oportunas al archivo
/etc/bash.bashrc
sería:
# nano /etc/bash.bashrc
Para crear o sobrescribir un archivo desde una cadena de caracteres, una buena idea es usar
redirección de salida
. El siguiente ejemplo crea o sobrescribe el contenido del archivo
/etc/hostname
con el texto
myhostname
.
# echo myhostname > /etc/hostname
La redirección de salida también puede ser usada para añadir una cadena de caracteres a un archivo. El siguiente ejemplo añade el texto
[custom-repo]
al archivo
/etc/pacman.conf
.
# echo "[custom-repo]" >> /etc/pacman.conf
Cuando se le pregunte crear un
directorio
, use la orden
mkdir
:
# mkdir /mnt/boot
Hacer ejecutable
Después de crear un archivo, si tiene en mente ejecutarlo como un script (ya sea manualmente o por otro programa), necesita ser marcado como
ejecutable
, por ejemplo con:
$ chmod +x
script
Véase
chmod
. Algunas aplicaciones como
file manager
pueden proporcionar una manera gráfica de cambiar estas propiedades.
Cargar fuentes
Algunas aplicaciones, especialmente los
intérpretes de línea de órdenes
, utilizan scripts para su configuración: después de modificarlos, deben ser
cargados
para que se apliquen los cambios. En el caso de
bash (Español)
, por ejemplo, esto se hace ejecutando (también puede reemplazar la orden
source
con
.
):
$ source ~/.bashrc
Cuando la wiki le sugiera modificar dicho script de configuración, no le recordará explícitamente que recargue el archivo, y solo en algunos casos le remitirá a esta sección con un enlace de recordatorio.
Instalación de paquetes
Cuando un artículo invita a instalar algún paquete de manera convencional, no indicará en detalle cómo hacer esto, en su lugar solo mencionará el nombre del paquete o paquetes a instalar.
Nota
frecuentemente, los enlaces
instale
o
instalado
son utilizados para enlazar a esta sección de este artículo. Hay que tener JavaScript activo en el navegador para que los enlaces funcionen.
Las siguientes subsecciones dan una introducción al proceso genérico de instalar un paquete dependiendo de su tipo.
Paquetes oficiales
Para los paquetes de los
repositorios oficiales
, se leerá algo similar a:
Instale el paquete
foobar
.
Esto quiere decir que se tiene que ejecutar la siguiente orden:
# pacman -S foobar
El artículo sobre
pacman
contiene información de como administrar sus paquetes en Arch Linux eficientemente.
Arch User Repository
Para los paquetes del
Repositorio de usuarios de Arch
(AUR), se leerá algo similar a:
Instale el paquete
foobar
AUR
.
Esto quiere decir, generalmente es necesario seguir el enlace
foobar
AUR
, descargar el archivo comprimido con el PKGBUILD, extraerlo,
verificar el contenido
y finalmente en el mismo directorio ejecutar:
$ makepkg -si
Nota
El grupo de paquetes
base-devel
se requiere para la construcción de paquetes del AUR o con
Arch Build System
.
El artículo
Repositorio de usuarios de Arch
contiene información detallada así como recomendaciones para construir paquetes del AUR.
Control de unidades de systemd
Cuando un artículo invita a
start
,
enable
,
stop
o
restart
alguna unidad de systemd (por ejemplo, un servicio), no va a mencionar en detalle como efectuar esta acción, en su lugar se leerá algo similar a:
start
ejemplo.service
.
Esto quiere decir que se tiene que ejecutar lo siguiente:
# systemctl start ejemplo.service
El enlace
start
lo llevará al artículo de
systemd
, el cual contiene información y explicaciones detalladas sobre cómo administrar unidades de systemd en Arch Linux eficientemente.
Nota
Los enlaces
start
,
enable
,
stop
,
restart
... son redireccionamientos a las secciones especificas, lo cual solo funciona si el navegador tiene JavaScript activado.
Configuración para todo el sistema o para un usuario específico
Es importante recordar que hay dos tipos diferentes de configuraciones en un sistema GNU/Linux. Configuración para
todo el sistema
que afecta a todos los usuarios. Dado que todo el sistema de configuración, generalmente, se encuentra en el directorio
/etc
, se requieren privilegios de root para poder modificar los archivos allí ubicados. Por ejemplo, para aplicar un ajuste a Bash que afecte a todos los usuarios, debe modificarse
/etc/bash.bashrc
.
La configuración
específica del usuario
, sólo afecta a un único usuario. Los archivos
dot
(archivos cuyo nombre comienzan con un punto) son utilizados para la configuración específica del usuario. Por ejemplo, el archivo
~/
.
bashrc
es el archivo de configuración específica del usuario. La idea es que cada usuario pueda definir sus propios ajustes, como los alias, funciones y otras características interactivas como el prompt del sistema, sin afectar a las preferencias de otros usuarios.
Nota
~/
y
$HOME
son atajos al directorio principal («
home
») del usuario, por lo general
/home/
nombredeusuario
/
El signo
~
se obtiene pulsando
Alt Gr
+
ñ
en la distribución del teclado español
Archivos comunes de intérprete de órdenes
Bash y otros intérpretes de órdenes compatibles con Bourne, como
Zsh
, también los archivos de origen dependiendo de si el intérprete de órdenes es un
intérprete de órdenes de inicio de sesión
o un
intérprete de órdenes interactivo
. Véase
Bash (Español)#Archivos de configuración
y
Zsh#Startup/Shutdown files
para obtener más detalles.
Ejemplos de pseudovariables en el código
Algunos bloques de código pueden contener las denominadas
pseudo-variables
, que, como su nombre lo indica, no son variables reales utilizadas en el código. En su lugar, son marcadores de posición genéricos y deben ser reemplazados manualmente por elementos de configuración específicos del sistema
antes
de que el código pueda ejecutarse o analizarse. Los intérpretes de órdenes comunes como
bash
y
zsh
proporcionan
tab-completion
para completar automáticamente parámetros para órdenes comunes como
systemctl
.
En los artículos que cumplen con las pautas de
Help:Style/Formatting and punctuation (Español)
, las
pseudovariables
irán puestas en cursiva. Por ejemplo:
Active
el servicio
dhcpcd@
nombre_de_la_interfaz
.service
para la interfaz de red identificada en la salida de la orden
ip link
.
En este caso
nombre_de_la_interfaz
e usa como un marcador de posición
pseudovariable
en una unidad de plantilla systemd. Todas las unidades de plantilla systemd, identificables por el signo
@
, sign, requieren un elemento de configuración específico del sistema como argumento. Véase
Systemd (Español)#Utilizar las unidades
.
La orden
dd if=
data_source
of=/dev/sd
X
bs=
sector_size
count=
sector_number
seek=
partitions_start_sector
se puede ejecutar como root para borrar una partición con los parámetros específicos.
En este caso las
pseudovariable
se utilizan para describir los parámetros que deben sustituirse por ellas. Los detalles sobre cómo reunirlos se detallan en la sección
Securely wipe disk#Calculate blocks to wipe manually
, cuyas opciones presenta la orden.
En el caso de ejemplos de archivos, pegar pseudovariables en archivos de configuración real puede romper los programas que los utilizan.
Puntos suspensivos
En la mayoría de los casos, los puntos suspensivos (
...
) no son parte del contenido real del archivo o salida del código, y en su lugar representan texto omitido u opcional que no es relevante para el tema discutido.
Por ejemplo
HOOKS="... encrypt ... filesystems ..."
o:
/etc/X11/xorg.conf.d/50-synaptics.conf
Section "InputClass"
    ...
    Option      "CircularScrolling"          "on"
    Option      "CircScrollTrigger"          "0"
    ...
EndSection
Tenga en cuenta que, en algunos casos, los puntos suspensivos pueden ser una parte significativa de la sintaxis del código: los usuarios atentos podrán reconocer fácilmente estos casos por el contexto.