Help:Reading (فارسی) - ArchWiki

Jump to content

# Help: Reading (فارسی)

From ArchWiki

Related articles

- Help:Browsing
- Help:Style

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

## Organization

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

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

## Formatting

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

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

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

    # 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)، چیزی شبیه به این خواهید خواند:

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

این یعنی به‌طورکلی شما باید لینک foobarAUR را دنبال کنید، آرشیو 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.

Category:

- Help (فارسی)

Hidden category:

- Pages or sections flagged with Template:Expansion

Help: Reading (فارسی)
Add topic