Help:Reading (Español)
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): foobarAUR
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.
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 :
# 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 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 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 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 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.
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 foobarAUR.
Esto quiere decir, generalmente es necesario seguir el enlace foobarAUR, descargar el archivo comprimido con el PKGBUILD, extraerlo, verificar el contenido y finalmente en el mismo directorio ejecutar:
$ makepkg -si
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 .
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.
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 , 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 .
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.
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.servicepara la interfaz de red identificada en la salida de la orden .
En este caso 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 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 o:
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.