نام (NAME)

lsd - نسخه ارتقایافته و مدرن دستور ls (LSDeluxe)

خلاصه دستور (SYNOPSIS)

lsd [FLAGS] [OPTIONS] [--] [FILE]...

توضیحات (DESCRIPTION)

دستور lsd نسخه‌ای از دستور ls است که با رنگ‌های زیبا و قابلیت‌های فراوان دیگر، تجربه مشاهده و فهرست‌کردن محتوای دایرکتوری‌ها را غنی‌تر و بهبود می‌بخشد.

گزینه‌ها (OPTIONS)

-a, --all: ورودی‌هایی را که با . آغاز می‌شوند نادیده نمی‌گیرد (نمایش همه فایل‌ها).
-A, --almost-all: دایرکتوری‌های ضمنی . و .. را فهرست نمی‌کند.
--classic: فعال‌سازی حالت کلاسیک (بدون رنگ یا آیکون).
-L, --dereference: هنگام نمایش اطلاعات فایل برای یک پیوند نمادین (symlink)، اطلاعات فایلی را که پیوند به آن اشاره می‌کند نمایش می‌دهد، نه اطلاعات خود پیوند را.
-d, --directory-only: نمایش خود دایرکتوری‌ها به جای محتویات آن‌ها (در صورت استفاده به همراه –tree، به‌صورت بازگشتی عمل می‌کند).
-X, --extensionsort: مرتب‌سازی بر اساس پسوند فایل.
--git: نمایش وضعیت git. وضعیت git برای دایرکتوری‌ها حاصل تجمیع وضعیت فایل‌های درون آن است (به‌صورت بازگشتی).
--help: چاپ اطلاعات راهنما.
-h, --human-readable: تنها برای سازگاری با ls؛ در حال حاضر به‌صورت پیش‌فرض فعال است.
--ignore-config: نادیده‌گرفتن فایل پیکربندی.
--config-file <path>: بارگذاری فایل پیکربندی از یک مسیر دلخواه.
-F, --classify: افزودن شناسه (یکی از کاراکترهای */=>@|) به انتهای نام فایل‌ها.
-i, --inode: نمایش شماره اندیس (inode) هر فایل.
-l, --long: نمایش فراداده‌های تفصیلی فایل در قالب یک جدول.
--no-symlink: عدم نمایش مقصد پیوندهای نمادین (symlink).
-1, --oneline: نمایش یک ورودی در هر سطر.
-R, --recursive: پیمایش بازگشتی در دایرکتوری‌ها.
-r, --reverse: معکوس کردن ترتیب مرتب‌سازی.
-S, --sizesort: مرتب‌سازی بر اساس اندازه فایل.
-t, --timesort: مرتب‌سازی بر اساس زمان ویرایش.
--total-size: نمایش اندازه کل دایرکتوری‌ها.
--tree: پیمایش بازگشتی در دایرکتوری‌ها و نمایش نتیجه در قالب یک ساختار درختی.
-V, --version: چاپ اطلاعات نسخه برنامه.
-v, --versionsort: مرتب‌سازی طبیعی شماره‌های (نسخه) درون متن.
--blocks <blocks>...: مشخص کردن بلوک‌هایی که نمایش داده می‌شوند و ترتیب قرارگیری آن‌ها [مقادیر ممکن: permission، user، group، size، date، name، inode، git]
--color <color>...: تعیین زمان استفاده از رنگ‌ها در ترمینال [پیش‌فرض: auto] [مقادیر ممکن: always، auto، never]
--date <date>...: نحوه نمایش تاریخ [مقادیر ممکن: date، locale، relative، +date-time-format] [پیش‌فرض: date]
--depth <num>...: توقف پیمایش بازگشتی دایرکتوری‌ها پس از رسیدن به عمق مشخص‌شده.
--group-dirs <group-dirs>...: مرتب‌سازی دایرکتوری‌ها و سپس فایل‌ها [پیش‌فرض: none] [مقادیر ممکن: none، first، last]
--group-directories-first: دسته‌بندی دایرکتوری‌ها در بالا، قبل از فایل‌ها. معادل --group-dirs=first
--hyperlink <hyperlink>...: پیوست کردن ابرپیوند (hyperlink) به نام فایل‌ها [پیش‌فرض: never] [مقادیر ممکن: always، auto، never]
--icon <icon>...: زمان نمایش آیکون‌ها [پیش‌فرض: auto] [مقادیر ممکن: always، auto، never]
--icon-theme <icon-theme>...: انتخاب بین آیکون‌های فانتزی یا یونیکد [پیش‌فرض: fancy] [مقادیر ممکن: fancy، unicode]
-I, --ignore-glob <pattern>...: عدم نمایش فایل‌ها/دایرکتوری‌هایی که نام آن‌ها با الگوی glob مطابقت دارد. می‌توان با تکرار این آرگومان بیش از یک الگو را مشخص کرد [پیش‌فرض: خالی]
--permission <permission>...: نحوه نمایش دسترسی‌ها [پیش‌فرض: rwx برای لینوکس، attributes برای ویندوز] [مقادیر ممکن: rwx، octal، attributes، disable]
--size <size>...: نحوه نمایش اندازه [پیش‌فرض: default] [مقادیر ممکن: default، short، bytes]
--sort <WORD>...: مرتب‌سازی بر اساس کلمه کلیدی به جای نام [مقادیر ممکن: size، time، version، extension، git]
-U, --no-sort: عدم مرتب‌سازی. ورودی‌ها به همان ترتیبی که در دایرکتوری هستند فهرست می‌شوند.
-Z --context: نمایش بافت امنیتی (security context) سامانه SELinux یا SMACK.
--header: نمایش سرستون‌های هر بلوک.
-N --literal: چاپ نام ورودی‌ها بدون علامت نقل‌قول.
--truncate-owner-after: کوتاه‌سازی نام کاربر و گروه در صورتی که تعداد کاراکترهای آن‌ها از حد مشخصی فراتر رود.
--truncate-owner-marker: نشانگر کوتاه‌سازی که به انتهای نام کوتاه‌شده کاربر یا گروه افزوده می‌شود.

آرگومان‌ها (ARGS)

<FILE>...: فایل یا دایرکتوری مورد نظر برای فهرست‌کردن [پیش‌فرض: .]

مثال‌ها (EXAMPLES)

lsd: نمایش فهرست محتویات دایرکتوری جاری
lsd /etc: نمایش فهرست محتویات دایرکتوری /etc
lsd -la: نمایش فهرست محتویات دایرکتوری جاری، شامل فایل‌هایی که با . آغاز می‌شوند و همچنین ورودی خود دایرکتوری جاری.

محیط (ENVIRONMENT)

LS_COLORS: برای تعیین رنگ نمایش نام فایل‌ها استفاده می‌شود. ببینید: dir_colors.
XDG_CONFIG_HOME: برای یافتن فایل پیکربندی اختیاری استفاده می‌شود. اگر XDG_CONFIG_HOME مقداردهی شده باشد، از $XDG_CONFIG_HOME/lsd/config.yaml استفاده می‌شود، در غیر این صورت از $HOME/.config/lsd/config.yaml استفاده خواهد شد.
SHELL_COMPLETIONS_DIR یا OUT_DIR: برای مشخص کردن دایرکتوری تولید فایل کامل‌سازی پوسته (shell completions) استفاده می‌شود. اگر هیچ‌یک تنظیم نشده باشند، فایل کامل‌سازی تولید نخواهد شد. این دایرکتوری در صورت عدم وجود ساخته خواهد شد.