Help:Reading (Magyar)

Fordítás állapota: Ez a cikk a(z) Help:Reading lefordított változata. Utolsó fordítás dátuma: 2025.10.30. Ha az angol változatban történtek módosítások, akkor Ön segíthet a fordítás szinkronizálásában.

Mivel az ArchWiki túlnyomó része olyan utalásokat tartalmaz, amely utasítások tisztázásra szorulhatnak az új Arch Linux felhasználók számára (vagy általában a GNU/Linux felhasználók számára), ezért elkészült ez az alapvető eljárásokat bemutató összefoglaló, így elkerülvén a cikkek feldolgozása során felmerülő félreértéseket, és megelőzve az ismétlődést a tartalomban.

Szervezés

A legtöbb cikk az ArchWiki weboldalon nem törekszik arra, hogy átfogó bevezetést nyújtson egyetlen témához. Ehelyett a "Ne ismételje önmagát" elv alapján íródnak, annak feltételezésével, hogy az olvasó megkeresi és elolvassa azokat a kiegészítő anyagokat, amelyeket még nem ért. Ahol lehetséges, ott az ilyen kiegészítő anyagok a cikkben speciális formázással vannak jelölve. Erről tekintse meg a #Formázás leírást.

Az ArchWiki ilyen szervezése miatt előfordulhat, hogy több kapcsolódó forrást is át kell tekintenie ahhoz, hogy teljes mértékben megértse egy adott cikk tartalmát. Különösen az Arch operációs rendszerrel (vagy általában a GNU/Linux-szal) most ismerkedő felhasználóknak számítaniuk kell arra, hogy még egyszerű problémák megoldása során is nagyszámú cikket kell elolvasniuk. Rendkívül fontos, hogy Ön a kiegészítő anyagokat tanulmányozza, mielőtt további segítséget kérne más felhasználóktól.

Formázás

Hivatkozás az aktuális cikk egy szakaszára: #Szervezés
Hivatkozás egy másik ArchWiki-cikkre
Hivatkozás egy külső weboldalra
Hivatkozás egy man súgóra: intro(1)
Kizárólag offline elérhető man súgó: foo(1)
Hivatkozás egy szoftvercsomagra a hivatalos szoftvercsomag-tárolókban: foobar
Hivatkozás egy szoftvercsomagra az AUR szoftvercsomag-tárolóban: foobar^AUR

Root felhasználó, normál felhasználó vagy másik felhasználó

Néhány sor így van leírva:

# mkinitcpio -p linux

Más soroknak eltérő előtagjuk van:

$ makepkg -s

A kettős kereszt (#) azt jelzi, hogy a parancsot rendszergazdaként (root felhasználóként) kell futtatni, míg a dollárjel ($) azt mutatja, hogy a parancsot rendes felhasználóként kell végrehajtani.

Megjegyzés A # előtaggal ellátott parancsokat root parancssorból kell végrehajtani, amely például könnyen elérhető a sudo -i parancs futtatásával. A sudo parancs futtatása egy nem privilegizált parancssorból a legtöbb esetben szintén működik, de vannak kivételek, mint például az átirányítás és a parancshelyettesítés, amelyek szigorúan root parancssort igényelnek. Részletekért tekintse meg a sudo#Login shell leírást.

Amikor a parancsokat egy adott felhasználóként kell futtatni, akkor a felhasználónév szögletes zárójelben szerepel előtagként, például:

[postgres]$ initdb -D /var/lib/postgres/data

Ez azt jelenti, hogy egy jogosultságemelő parancsot kell használnia, például a sudo parancsot:

$ sudo -u postgres initdb -D /var/lib/postgres/data

Egy figyelemreméltó kivétel, amire ügyelni kell:

# Ez az alias kiszínezi a listát az ls által.
alias ls='ls --color=auto'

Ebben a példában a kettős kereszt azt jelzi, hogy a kettős kereszt után lévő rész nem a számítógépnek van szánva, nem parancsként értelmezendő. Kizárólag egy szövegfájlban lévő szerkeszthető szöveg, ami az emberi felhasználóknak szól. Tehát ebben az esetben a kettős kereszt egy megjegyzést jelöl. A megjegyzés lehet magyarázó szöveg, amit a számítógép a program futásakor nem értelmez. A Bash szkriptekben a megjegyzések jelölése véletlenül egybeesik a rendszergazda PS1 környezeti változójának a jelölésmódjával. Véletlenül mind a kettőt ugyanúgy írják.

After further examination, "give away" signs include the uppercase character following the # sign. Usually, Unix commands are not written this way and most of the time they are short abbreviations instead of full-blown English words (e.g., Copy becomes cp).

Regardless, most articles make this easy to discern by notifying the reader:

Append to ~/path/to/file:

# This alias makes ls colorize the listing
alias ls='ls --color=auto'

Hozzáfűzés, hozzáadás, létrehozás, szerkesztés

When prompted to append to, add to, create, or edit one or more files, it is implied that you should use one of the following methods.

To create or modify multiline files, it is suggested to use a text editor. For example, using the nano command to edit the file /etc/bash.bashrc is:

# nano /etc/bash.bashrc

Megjegyzés Text files must end with a newline because a line is terminated with a newline. Most text editors insert an ending newline by default.

To create or overwrite a file from a string, it may be simpler to use output redirection. The following example creates or overwrites the contents of the file /etc/hostname with the text myhostname.

# echo myhostname > /etc/hostname

Output redirection can also be used to append a string to a file. The following example appends the text [custom-repo] to the file /etc/pacman.conf.

# echo "[custom-repo]" >> /etc/pacman.conf

When prompted to create directories, use the mkdir command:

# mkdir /mnt/boot

Make executable

After creating a file, if it is meant to be run as a script (whether manually or called by another program), it needs to be set as executable, for example with:

$ chmod +x script

See chmod. Some applications such as file managers may provide graphical interfaces to do the same.

Source

Some applications, notably command-line shells, use scripts for their configuration: after modifying them, they must be sourced in order for the changes to be applied. In the case of bash, for example, this is done by running (you can also replace source with .):

$ source ~/.bashrc

When the wiki suggests modifying such a configuration script, it will not explicitly remind you to source the file, and only in some cases will it point to this section with a reminder link.

Szoftvercsomagok telepítése

When an article invites you to install some packages in the conventional way, it will not indicate the detailed instructions to do so; instead, it will simply mention the names of the packages to be installed.

Megjegyzés Frequently, the install or installed links are used to point to this article section. However, JavaScript has to be enabled for these links to work.

The subsections below give an overview of the generic installation procedures depending on the package type.

Hivatalos szoftvercsomagok

A hivatalos szoftvercsomag-tárolók szoftvercsomagjai esetében valami ilyesmit fog olvasni:

Telepítse a szoftvercsomagneve szoftvercsomagot.

Ez azt jelenti, hogy Önnek futtatnia kell a következő parancsot:

# pacman -S szoftvercsomagneve

A pacman cikk részletes magyarázatokat tartalmaz az Arch Linux szoftvercsomag-kezelésének szakszerű használatához.

Arch User Repository

For packages from the Arch User Repository (AUR), you will read something like:

Install the foobar^AUR package.

This means that in general you have to follow the foobar^AUR link, download the PKGBUILD archive, extract it, verify the content and finally run, in the same folder:

$ makepkg -si

Megjegyzés The base-devel meta package is required to build packages from the AUR or with the Arch build system.

The Arch User Repository article contains all the detailed explanations and best practices to deal with AUR packages.

A systemd unitok vezérlése

When an article invites to start, enable, etc., some systemd unit (e.g. a service), it will not indicate the detailed instructions to do so, but instead you will read something like:

Start example.service.

This means that you have to run:

# systemctl start example.service

A notable command that does not follow this exact pattern is systemctl daemon-reload which will be called without arguments.

The systemd#Using units section contains structured list of available actions (like start, enable, enable and start, etc.) with their corresponding systemctl commands.

System-wide versus user-specific configuration

It is important to remember that there are two different kinds of configurations on a GNU/Linux system. System-wide configuration affects all users. Since system-wide settings are generally located in the /etc directory, root privileges are required in order to alter them. For example, to apply a Bash setting that affects all users, /etc/bash.bashrc should be modified.

User-specific configuration affects only a single user. Dotfiles are used for user-specific configuration. For example, the file ~/.bashrc is the user-specific configuration file. The idea is that each user can define their own settings, such as aliases, functions and other interactive features like the prompt, without affecting other users' preferences.

Megjegyzés ~/ and $HOME are shortcuts for the user's home directory, usually /home/username/.

Common shell files

Bash and other Bourne-compatible shells, such as Zsh, also source files depending on whether the shell is a login shell or an interactive shell. See Bash#Configuration files and Zsh#Startup/Shutdown files for details.

Pseudo-variables in code examples

Some code blocks may contain so-called pseudo-variables, which, as the name says, are not actual variables used in the code. Instead they are generic placeholders and have to be manually replaced with system-specific configuration items before the code may be run or parsed. Common shells such as bash and zsh provide tab-completion to auto-complete parameters for common commands such as systemctl.

In the articles that comply with Help:Style/Formatting and punctuation, pseudo-variables are formatted in italics. For example:

Enable the dhcpcd@interface_name.service for the network interface identified from the output of the ip link command.

In this case interface_name is used as a pseudo-variable placeholder in a systemd template unit. All systemd template units, identifiable by the @ sign, require a system-specific configuration item as argument. See systemd#Using units.

The command dd if=data_source of=/dev/sdX bs=sector_size count=sector_number seek=partitions_start_sector can be run as root to wipe a partition with the specific parameters.

In this case the pseudo-variables are used to describe the parameters that must be substituted for them. Details on how to gather them are elaborated on in the section Securely wipe disk#Calculate blocks to wipe manually, which features the command.

This article or section needs expansion.

Reason: Mention other examples, ideally from other device categories (e.g. storage), with links to background articles. The examples are meant to avoid duplicating existing explanations in other articles. (Discuss in Help talk:Reading (Magyar))

In case of file examples, pasting pseudo-variables in real configuration files might break the programs that use them.

Ellipses

In most cases, ellipses (...) are not part of the actual file content or code output, and instead represent omitted or optional text that is not relevant for the discussed subject.

For example HOOKS="... encrypt ... filesystems ..." or:

/etc/X11/xorg.conf.d/50-synaptics.conf

Section "InputClass"
    ...
    Option      "CircularScrolling"          "on"
    Option      "CircScrollTrigger"          "0"
    ...
EndSection

Be aware though that, in a few instances, ellipses may be a meaningful part of the code syntax: attentive users should be able to recognize these cases by the context.