Help:Reading (فارسی)

Related articles
Help:Browsing
Help:Style
از آنجایی که اکثریت قریب به اتفاق ارچ ویکی حاوی نشانه هایی است که ممکن است برای کاربرانی که تازه با ارچ لینوکس (یا گنو/لینوکس به طور کلی) نیاز به توضیح دارند، این خلاصه از رویه های اساسی هم برای جلوگیری از سردرگمی در یکسان سازی مقالات و هم برای جلوگیری از تکرار در خود محتوا نوشته شده است.
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/sd
X
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.