## يدويًا

ينطبق أي مما يلي:

- استخدام سكربت التثبيت:
    ```sh
    # تحقق دائمًا من محتوى السكربت قبل تشغيله!
    $ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/skim-rs/skim/releases/latest/download/skim-installer.sh | sh
    ```
- استخدام الملف الثنائي: ببساطة [قم بتنزيل ملف sk القابل للتنفيذ](https://github.com/skim-rs/skim/releases) مباشرة.
- التثبيت من [crates.io](https://crates.io/): `cargo install skim`
- البناء يدويًا:
    ```sh
    $ git clone --depth 1 [email protected]:skim-rs/skim.git ~/.skim
    $ cd ~/.skim
    $ cargo build --release
    $ # أضف الملف القابل للتنفيذ الناتج `target/release/sk` إلى PATH الخاص بك
    ```

ستتمكن بعد ذلك من الوصول إلى:

- صفحة الدليل (man page)، والتي يمكنك إما كتابتها إلى المسار الصحيح أو تشغيل `man --local-file <(sk --man)`
- إكمالات الصدفة (والاختصارات الاختيارية)، باستخدام `source <(sk --shell \<shell> \[--shell-bindings])`، انظر أدناه للتفاصيل

# الاستخدام

يمكن استخدام Skim إما كمرشح عام (مشابه لـ `grep`) أو كواجهة
تفاعلية لتشغيل الأوامر.

## كإضافة Vim (على neovim، راجع [fzf-lua](https://github.com/ibhagwan/fzf-lua) مع ملف تعريف skim)

عبر vim-plug (موصى به):

قم بتثبيت skim، ثم:```vim
Plug 'skim-rs/skim'

يتيح لك هذا الأمر الأخير تحديد الملفات ذات الامتداد ".rs" ويفتح
تحديداتك في Vim - وهو توفير كبير للوقت للمطورين!

## كواجهة تفاعلية

يمكن لـ `skim` استدعاء أوامر أخرى ديناميكيًا. عادةً ما سترغب في
دمجه مع [grep](https://www.gnu.org/software/grep/) أو
[ack](https://github.com/petdance/ack2) أو
[ag](https://github.com/ggreer/the_silver_searcher) أو
[rg](https://github.com/BurntSushi/ripgrep) للبحث عن المحتويات في
دليل المشروع:```sh
# works with grep
sk --ansi -i -c 'grep -rI --color=always --line-number {q} .'
# works with ack
sk --ansi -i -c 'ack --color {q}'
# works with ag
sk --ansi -i -c 'ag --color {q}'
# works with rg
sk --ansi -i -c 'rg --color=always --line-number {q}'

#### الخيار 2: الحفظ في ملف ليتم تحميله تلقائيًا عند بدء تشغيل الصدفة```sh
# For bash, add to ~/.bashrc
echo 'source <(sk --shell bash)' >> ~/.bashrc  # Or save to ~/.bash_completion

# For zsh, add to ~/.zshrc
sk --shell zsh > ~/.zfunc/_sk  # Create ~/.zfunc directory and add to fpath in ~/.zshrc

# For fish, add to ~/.config/fish/completions/
sk --shell fish > ~/.config/fish/completions/sk.fish

يمكنك التبديل إلى وضع `regex` ديناميكيًا بالضغط على `Ctrl-R` (وضع التدوير).

## رمز الخروج

| رمز الخروج | المعنى                             |
|-----------|-------------------------------------|
| 0         | خرج بشكل طبيعي                     |
| 1         | لم يتم العثور على تطابق                      |
| 130       | تم الإنهاء بواسطة Ctrl-C/Ctrl-G/ESC/إلخ... |

# الأدوات المتوافقة مع `skim`

هذه الأدوات متوافقة أو تهدف إلى أن تكون متوافقة مع `skim`:

## [إضافة fzf-lua لـ neovim](https://github.com/ibhagwan/fzf-lua)

إضافة [neovim](https://neovim.io) تتيح استخدام fzf و skim للتنقل في الكود الخاص بك.

قم بتثبيتها باستخدام مدير الحزم الخاص بك، باتباع ملف README. على سبيل المثال، مع `lazy.nvim`:```lua
{
  "ibhagwan/fzf-lua",
  -- enable `sk` support instead of the default `fzf`
  opts = {'skim'}
}

## [امتداد sqlite](https://github.com/tzachar/sqlite_skim)

وحدة قابلة للتحميل في `sqlite` تتيح استخدام دالة `skim_score` في استعلامات SQL.

# التخصيص

المستند هنا مجرد معاينة، يرجى مراجعة صفحة الدليل (`man sk`) للحصول على قائمة كاملة بالخيارات.

## خريطة المفاتيح

حدد الارتباطات بأزواج مفصولة بفواصل (بدون مسافات مسموحة). على سبيل المثال:```sh
sk --bind 'alt-a:select-all,alt-d:deselect-all'

كما يحترم Skim متغير البيئة `NO_COLOR`. اضبطه على أي قيمة وسيقوم `sk` (والعديد من تطبيقات الطرفية الأخرى) بتعطيل جميع المخرجات الملونة. راجع [no-color.org](https://no-color.org/) لمزيد من التفاصيل.

### مخططات الألوان الأساسية المتاحة

يأتي Skim مع عدة مخططات ألوان مدمجة يمكنك استخدامها كنقطة انطلاق:```sh
sk --color=dark      # Default dark theme (256 colors)
sk --color=light     # Light theme (256 colors)
sk --color=16        # Simple 16-color theme
sk --color=bw        # Minimal black & white theme (no colors, just styles)
sk --color=none      # Minimal black & white theme (no colors, no styles)
sk --color=molokai   # Molokai-inspired theme (256 colors)

يمكن تحديد الألوان بعدة طرق:

- ألوان ANSI (0-255): `sk --color=fg:232,bg:255`
- قيم RGB السداسية: `sk --color=fg:#FF0000` (نص أحمر)

### خيارات تخصيص الألوان المتاحة

يمكن تخصيص عناصر الواجهة التالية:

| العنصر               | الوصف                                        | المثال                           |
|----------------------|----------------------------------------------|----------------------------------|
| `fg`                 | لون النص العادي الأمامي                      | `--color=fg:232`                 |
| `bg`                 | لون خلفية النص العادي                        | `--color=bg:255`                 |
| `matched`            | النص المطابق في نتائج البحث                  | `--color=matched:108`            |
| `matched_bg`         | خلفية النص المطابق                           | `--color=matched_bg:0`           |
| `current`            | لون السطر الحالي الأمامي                     | `--color=current:254`            |
| `current_bg`         | لون خلفية السطر الحالي                       | `--color=current_bg:236`         |
| `current_match`      | النص المطابق في السطر الحالي                 | `--color=current_match:151`      |
| `current_match_bg`   | خلفية النص المطابق في السطر الحالي           | `--color=current_match_bg:236`   |
| `spinner`            | لون مؤشر التقدم                              | `--color=spinner:148`            |
| `info`               | لون سطر المعلومات                            | `--color=info:144`               |
| `prompt`             | لون المطالبة                                 | `--color=prompt:110`             |
| `cursor`             | لون المؤشر                                   | `--color=cursor:161`             |
| `selected`           | لون علامة العنصر المحدد                      | `--color=selected:168`           |
| `header`             | لون نص الترويسة                              | `--color=header:109`             |
| `border`             | لون الحدود للمعاينة/التخطيط                  | `--color=border:59`              |

### أمثلة```sh
# Use light theme but change the current line background
sk --color=light,current_bg:24

# Custom theme with multiple colors
sk --color=dark,matched:#00FF00,current:#FFFFFF,current_bg:#000080

# High contrast theme
sk --color=fg:232,bg:255,matched:160,current:255,current_bg:20

### كيف يعمل؟

![كيف يعمل الوضع التفاعلي في Skim](https://assets.kitploit.com/production/public/readmes/54416/5895df8cd6dbe8dfe20cafd1bf0b23fd690191710c00f811e110aba228b32a35/a7b995846d08eb2aa7f351371b38a9a35261eb393632363f62c6a67785f4038e-display-v1.webp)

- يقبل Skim نوعين من المصادر: مخرجات الأوامر أو الإدخال المُمرَّر عبر الأنابيب
- لدى Skim نوعان من المطالبات: مطالبة استعلام لتحديد نمط البحث ومطالبة
    أوامر لتحديد "وسائط" الأمر
- يُستخدم `-c` لتحديد الأمر الذي سيتم تنفيذه، وقيمته الافتراضية هي `SKIM_DEFAULT_COMMAND`
- يخبر `-i` برنامج Skim بفتح مطالبة الأوامر عند بدء التشغيل، والتي ستُظهر `c>` افتراضيًا.

لتضييق نطاق النتائج التي يُرجعها الأمر بشكل أكبر، اضغط
`Ctrl-Q` لتبديل الوضع التفاعلي.

## تنفيذ برامج خارجية

يمكنك تكوين روابط المفاتيح لبدء عمليات خارجية دون مغادرة Skim (`execute`, `execute-silent`).```sh
# Press F1 to open the file with less without leaving skim
# Press CTRL-Y to copy the line to clipboard and aborts skim (requires pbcopy)
sk --bind 'f1:execute(less -f {}),ctrl-y:execute-silent(echo {} | pbcopy)+abort'

(لاحظ أن [preview.sh](https://github.com/junegunn/fzf.vim/blob/master/bin/preview.sh) هو سكربت لطباعة السياق مع إعطاء اسم الملف:الأسطر:الأعمدة)

ستحصل على نتائج مثل هذه:

![معاينة تجريبية](https://assets.kitploit.com/production/public/readmes/54416/b89dd1e40297ffc3fa4684c4a6d5dc9506c0eafdb881d4cea079ff843f1a271a/84156872f39354a97241078491506fee9f9962eda6628161f94f6f36ec2c79f9-display-v1.webp)

### كيف يعمل؟

إذا تم إعطاء أمر المعاينة عبر خيار `--preview`، فسيقوم skim باستبدال
`{}` بالسطر المميز حاليًا والمحاط بعلامات اقتباس مفردة، ثم يستدعي
الأمر للحصول على المخرجات، ويطبع المخرجات في نافذة المعاينة.

أحيانًا لا تحتاج إلى السطر بأكمله لاستدعاء الأمر. في هذه الحالة
يمكنك استخدام `{}` أو `{1..}` أو `{..3}` أو `{1..5}` لتحديد الحقول. يتم
شرح الصيغة في قسم [دعم الحقول](#filds-support).

أخيرًا، قد ترغب في تكوين موضع نافذة المعاينة باستخدام `--preview-window`:
- `--preview-window up:30%` لوضع النافذة في الموضع العلوي بارتفاع
    30% من الارتفاع الكلي لـ skim.
- `--preview-window left:10:wrap` لتحديد أن `wrap` يسمح لنافذة المعاينة
    بلف مخرجات أمر المعاينة.
- `--preview-window wrap:hidden` لإخفاء نافذة المعاينة عند بدء التشغيل، ويمكن
    إظهارها لاحقًا بواسطة الإجراء `toggle-preview`.

## دعم الحقول

عادةً لا يحتاج سوى مستخدمي الإضافات إلى فهم هذا.

على سبيل المثال، لديك مصدر بيانات بالتنسيق:```sh
<filename>:<line number>:<column number>

_ملاحظة حول الميزات_:
    - ميزة `cli` مطلوبة لاستخدام skim كأداة سطر أوامر، ويُفترض ألا تكون ضرورية عند استخدامها كمكتبة.

### الاستخدام الأساسي

ثم جرّب تشغيل هذا المثال البسيط:```rust
extern crate skim;
use skim::prelude::*;
use std::io::Cursor;

pub fn main() {
    let options = SkimOptionsBuilder::default()
        .height("50%")
        .multi(true)
        .build()
        .unwrap();

    let input = "aaaaa\nbbbb\nccc".to_string();

    // `SkimItemReader` is a helper to turn any `BufRead` into a stream of `SkimItem`
    // `SkimItem` was implemented for `AsRef<str>` by default
    let item_reader = SkimItemReader::default();
    let items = item_reader.of_bufread(Cursor::new(input));

    // `run_with` would read and show items from the stream
    let selected_items = Skim::run_with(&options, Some(items))
        .map(|out| out.selected_items)
        .unwrap_or_else(|| Vec::new());

    for item in selected_items.iter() {
        println!("{}", item.output());
    }
}

يمكنك وضعها في ملف `.bashrc` أو `.zshrc` إذا كنت تريدها كإعداد افتراضي.

## بعض الملفات لا تظهر في إضافة Vim

إذا كنت تستخدم إضافة Vim وتنفّذ الأمر `:SK`، فقد تجد أن بعض
ملفاتك لا تظهر.

كما هو موضح في [#3](https://github.com/skim-rs/skim/issues/3)، في إضافة
Vim، يتم تعيين `SKIM_DEFAULT_COMMAND` إلى الأمر افتراضيًا:```vim
let $SKIM_DEFAULT_COMMAND = "git ls-tree -r --name-only HEAD || rg --files || ag -l -g \"\" || find ."

داخل الجهاز الافتراضي، يتم تثبيت جذر المشروع في `C:\vagrant`:```powershell
cd C:\vagrant
cargo build
cargo test

# استكشاف الأخطاء وإصلاحها

لاستكشاف ما يحدث، يمكنك تعيين متغير البيئة `SKIM_LOG` أو العلامة `--log-level` إلى `debug` أو حتى `trace`، وتعيين متغير البيئة `SKIM_LOG_FILE` أو العلامة `--log-file` إلى مسار. يمكنك بعد ذلك قراءة هذه السجلات أثناء أو بعد التنفيذ لفهم ما يحدث بشكل أفضل. لا تتردد في إضافة هذه السجلات إلى مشكلة (issue) إذا كنت بحاجة إلى مساعدة.

## مشكلات عدم وجود سطر جديد مع nix وFreeBSD وtermux

إذا واجهت مشكلات في العرض مثل:```bash
$ for n in {1..10}; do echo "$n"; done | sk
  0/10 0/0.> 10/10  10  9  8  7  6  5  4  3  2> 1

# المعايير

## المعيار التفاعلي (`cli`)

يقيس معيار `cli` أداء skim (أو أي برنامج ثنائي متوافق) مقابل إصدارات أخرى أو fzf من خلال تشغيل الواجهة التفاعلية داخل جلسة tmux والاستعلام عن سطر الحالة حتى يستقر عدد التطابقات. هذا ليس بأي حال قياساً دقيقاً أو مضموناً، لكن له فائدة إضافية تتمثل في قياس الأداء مقابل `fzf` وتوفير مقاييس الموارد (ذروة RSS وCPU).```sh
cargo bench --bench cli -- run                              # defaults: sk, 1 M items, query "test"
cargo bench --bench cli -- run sk -n 500000 -q foo              # bare name resolved via $PATH
cargo bench --bench cli -- run ./old/sk ./new/sk -r 5           # compare two binaries, 5 runs each
cargo bench --bench cli -- run sk -f input.txt -q search        # use an existing file
cargo bench --bench cli -- generate -f testdata.txt -n 2000000       # generate input file and exit
cargo bench --bench cli -- run sk --perf                            # record perf data (auto-named file)
cargo bench --bench cli -- run sk --strace                            # record strace data (auto-named file)
cargo bench --bench cli -- run sk -p perf.data                 # record perf data to perf.data
cargo bench --bench cli -- run sk -j                            # JSON output
cargo bench --bench cli -- run sk -r 3 -- --tiebreak=index     # pass extra flags to sk