Help:Reading (فارسی)

از آنجایی که اکثریت قریب به اتفاق ارچ ویکی حاوی نشانه هایی است که ممکن است برای کاربرانی که تازه با ارچ لینوکس (یا گنو/لینوکس به طور کلی) نیاز به توضیح دارند، این خلاصه از رویه های اساسی هم برای جلوگیری از سردرگمی در یکسان سازی مقالات و هم برای جلوگیری از تکرار در خود محتوا نوشته شده است.

Organization

اکثر مقالات در ارچ ویکی سعی در ارائه مقدمه ای جامع برای یک موضوع واحد ندارند. آنها در عوض با رعایت اصل "Don't Repeat Yourself" نوشته شده اند، با این فرض که کاربر هر گونه مطلب پشتیبانی را که هنوز متوجه نشده است جستجو می کند و می خواند. در صورت امکان، چنین مطالب پشتیبانی در مقاله از طریق قالب بندی خاص نشان داده شده است، به #Formatting مراجعه کنید.

به دلیل این سازماندهی، ممکن است برای درک کامل مقاله ارچ ویکی نیاز به بررسی چندین منبع مرتبط باشد. به طور خاص، کاربرانی که تازه با ارچ (یا به طور کلی گنو/لینوکس) آشنا شده اند باید انتظار داشته باشند که در نهایت تعداد زیادی مقاله را حتی در هنگام حل مشکلات ساده بخوانند. مطالعه مطالب پشتیبان قبل از درخواست کمک اضافی از سایر کاربران بسیار مهم است.

Formatting

پیوند به بخشی در مقاله فعلی: #Organization
لینک به مقاله دیگر ارچ ویکی
لینک به یک صفحه وب خارجی
لینک به یک man page: intro(1)
یک صفحه man که به صورت افلاین دردسترس است: foo(1)
لینک به یک بسته در مخازن رسمی: foobar
لینک به یک بسته در AUR: foobar^AUR

روت، کاربر معمولی یا کاربر دیگر

برخی از خطوط به این صورت نوشته شده است:

# mkinitcpio -p linux

دیگران پیشوند دیگری دارند:

$ makepkg -s

علامت عددی یا هش (#) نشان می دهد که دستور باید به صورت root اجرا شود، در حالی که علامت دلار ($) نشان می دهد که دستور باید به عنوان یک کاربر معمولی اجرا شود.

Note دستورات با پیشوند # در نظر گرفته شده است که از root shell اجرا شوند، که برای مثال می توان به راحتی با sudo -i به آن دسترسی داشت. اجرای دستور sudo command از یک پوسته غیرمجاز به جای command از یک پوسته ریشه نیز در اکثر موارد کار خواهد کرد، با برخی استثناهای قابل توجه مانند تغییر مسیر و command substitution، که به شدت به پوسته ریشه نیاز دارند. به پوسته sudo#Login shell مراجعه کنید.

هنگامی که دستورات باید به عنوان یک کاربر خاص اجرا شوند، با نام کاربری در پرانتز پیشوند می شوند، به عنوان مثال:

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

این بدان معنی است که شما باید از یک ابزار privilege elevation ابزار استفاده کنید، به عنوان مثال. با sudo:

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

یک استثنای قابل توجه که باید مراقب آن بود:

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

در این مثال، زمینه احاطه کننده علامت عددی نشان می دهد که این نباید به عنوان یک دستور اجرا شود. به جای آن باید در یک فایل ویرایش شود. بنابراین در این مورد، علامت عدد نشان دهنده یک نظر است. یک نظر می تواند متن توضیحی باشد که توسط برنامه مرتبط تفسیر نمی شود. نشان دادن اسکریپت های Bash برای نظرات اتفاقاً با ریشه PS1 منطبق است.

پس از بررسی بیشتر، علائم «بخشش» شامل کاراکتر بزرگ بعد از علامت # است. معمولاً دستورات یونیکس به این صورت نوشته نمی‌شوند و بیشتر اوقات به جای کلمات انگلیسی کامل، مخفف‌های کوتاه هستند (مثلاً کپی تبدیل بهCopy cp می‌شود).

صرف نظر از این، اکثر مقالات با اطلاع دادن به خواننده، تشخیص این موضوع را آسان می کنند:

الحاق به ~/path/to/file:

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

الحاق کردن، اضافه کردن، ایجاد، ویرایش

هنگامی که از شما خواسته می شود یک یا چند فایل را به آن اضافه کنید، به آن الحاق کنید، ایجاد یا ویرایش کنید، به این معنی است که باید از یکی از روش های زیر استفاده کنید.

برای ایجاد یا تغییر فایل های چند خطی، پیشنهاد می شود از یک ویرایشگر متن استفاده کنید. به عنوان مثال، استفاده از دستور nano برای ویرایش فایل /etc/bash.bashrc به صورت زیر است:

# nano /etc/bash.bashrc

Note فایل های متنی باید با یک خط جدید خاتمه یابد زیرا یک خط با یک خط جدید خاتمه می یابد. اکثر ویرایشگرهای متن یک خط جدید پایانی را به طور پیش فرض درج می کنند.

برای ایجاد یا بازنویسی یک فایل از یک رشته، ممکن است استفاده از تغییر مسیر خروجی ساده تر باشد. مثال زیر محتویات فایل etc/hostname/ را با متن myhostname ایجاد یا بازنویسی می کند.

# echo myhostname > /etc/hostname

تغییر مسیر خروجی همچنین می تواند برای الحاق یک رشته به یک فایل استفاده شود. مثال زیر متن [custom-repo] را به فایل etc/pacman.conf/ اضافه می کند.

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

هنگامی که از شما خواسته شد تا دایرکتوری ها ایجاد کنید، از دستور mkdir استفاده کنید:

# mkdir /mnt/boot

اجرایی کردن

پس از ایجاد یک فایل، اگر قرار است به عنوان یک اسکریپت اجرا شود (چه به صورت دستی و چه توسط برنامه دیگری فراخوانی شود)، باید آن را به عنوان اجرایی تنظیم کنید، به عنوان مثال با:

$ chmod +x script

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

Source

برخی از برنامه‌ها، به ویژه پوسته‌های خط فرمان، از اسکریپت‌ها برای پیکربندی خود استفاده می‌کنند: پس از تغییر آنها، برای اعمال تغییرات باید منبع آنها مشخص شود. به عنوان مثال، در مورد bash، این کار با اجرای دستور زیر انجام می‌شود (همچنین می‌توانید source را با . جایگزین کنید):

$ source ~/.bashrc

وقتی ویکی پیشنهاد اصلاح چنین اسکریپت پیکربندی را می‌دهد، صریحاً به شما یادآوری نمی‌کند که فایل را سورس کنید و فقط در برخی موارد با یک پیوند یادآوری به این بخش اشاره می‌کند.

نصب بسته ها

وقتی مقاله‌ای شما را به نصب برخی بسته‌ها به روش مرسوم دعوت می‌کند، دستورالعمل‌های دقیق برای انجام این کار را ذکر نمی‌کند؛ در عوض، به سادگی نام بسته‌هایی را که باید نصب شوند ذکر می‌کند.

Note اغلب، از پیوندهای نصب یا نصب‌شده برای اشاره به این بخش مقاله استفاده می‌شود.

برای کار کردن این لینک‌ها، جاوا اسکریپت باید فعال باشد.
Lynx که رسماً توسط راهنمای نصب پشتیبانی می‌شود، از جاوا اسکریپت پشتیبانی نمی‌کند.

بسته‌های رسمی

برای بسته‌های موجود در مخازن رسمی، چیزی شبیه به این خواهید خواند:

بسته foobar را نصب کنید.

این یعنی شما باید دستور زیر را اجرا کنید:

# pacman -S foobar

مقاله پکمن و صفحه راهنمای pacman(8) شامل توضیحات مفصلی برای مدیریت ماهرانه بسته‌ها در آرچ لینوکس است.

مخزن کاربران آرچ

برای بسته‌های موجود در مخزن کاربران آرچ (AUR)، چیزی شبیه به این خواهید خواند:

بسته foobar^AUR را نصب کنید.

این یعنی به‌طورکلی شما باید لینک foobar^AUR را دنبال کنید، آرشیو PKGBUILD را دانلود کنید، آن را استخراج کنید، محتوا را تأیید کنید و در نهایت، در همان پوشه اجرا کنید:

$ makepkg -si

Note بسته‌ی جامع base-devel برای ساخت بسته‌ها از AUR یا با سیستم ساخت ارچ مورد نیاز است.

مقاله مخزن کاربران آرچ شامل تمام توضیحات مفصل و بهترین شیوه‌ها برای کار با بسته‌های AUR است.

Control of systemd units

وقتی مقاله‌ای شما به توصیه ی شروع، فعال‌سازی و غیره، یک واحد systemd (مثلاً یک سرویس) را می کنید، دستورالعمل‌های دقیق برای انجام این کار را نشان نمی‌دهد، بلکه چیزی شبیه به این خواهید خواند:

example.service را شروع کنید.

این یعنی شما باید دستور زیر را اجرا کنید:

# systemctl start example.service

یک دستور قابل توجه که دقیقاً از این الگو پیروی نمی‌کند، systemctl daemon-reload است که بدون آرگومان فراخوانی می‌شود.

بخش systemd (فارسی)#Using units شامل لیست ساختاریافته‌ای از اقدامات موجود (مانند شروع، فعال کردن، فعال کردن و شروع و غیره) به همراه دستورات systemctl مربوطه است.

System-wide versus user-specific configuration

مهم است به خاطر داشته باشید که دو نوع پیکربندی مختلف در یک سیستم گنو/لینوکس وجود دارد. پیکربندی در سطح سیستم بر همه کاربران تأثیر می‌گذارد. از آنجایی که تنظیمات در سطح سیستم عموماً در دایرکتوری etc/ قرار دارند، برای تغییر آنها به امتیازات root نیاز است. به عنوان مثال، برای اعمال یک تنظیم Bash که بر همه کاربران تأثیر می‌گذارد، باید etc/bash.bashrc/ اصلاح شود.

پیکربندی مختص کاربر فقط روی یک کاربر تأثیر می‌گذارد. Dotfile ها برای پیکربندی مختص کاربر استفاده می‌شوند. برای مثال، فایل .bashrc/~ فایل پیکربندی مختص کاربر است. ایده این است که هر کاربر بتواند تنظیمات خود، مانند نام‌های مستعار، توابع و سایر ویژگی‌های تعاملی مانند پرامت، را بدون تأثیر بر تنظیمات سایر کاربران تعریف کند.

Note ~/ و $HOME میانبرهایی برای دایرکتوری خانه کاربر هستند، که معمولاً ‎/home/نام کاربر/ است.

فایل‌های شل رایج

Bash و سایر شل های سازگار با بورن، مانند Zsh، بسته به اینکه پوسته یک پوسته ورود (login shell) به سیستم یا یک پوسته تعاملی (interactive shell) باشد، فایل‌های منبع نیز دارند. برای جزئیات بیشتر به Bash#Configuration files و Zsh#Startup/Shutdown files مراجعه کنید.

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 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 (فارسی))

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.