## मैन्युअल रूप से

निम्नलिखित में से कोई भी लागू होता है:

- इंस्टॉल स्क्रिप्ट का उपयोग करके:
    ```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 --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

आप `Ctrl-R` (Rotate Mode) दबाकर डायनामिक रूप से `regex` मोड पर स्विच कर सकते हैं।

## exit code

| Exit Code | Meaning                             |
|-----------|-------------------------------------|
| 0         | Exited normally                     |
| 1         | No Match found                      |
| 130       | Aborted by Ctrl-C/Ctrl-G/ESC/etc... |

# `skim` के साथ संगत उपकरण

ये उपकरण `skim` के साथ संगत हैं या होने का लक्ष्य रखते हैं:

## [fzf-lua neovim plugin](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` लोड करने योग्य मॉड्यूल जो SQL क्वेरी में `skim_score` फ़ंक्शन को सक्षम करता है।

# अनुकूलन

यहाँ दिया गया दस्तावेज़ केवल एक पूर्वावलोकन है, विकल्पों की पूरी सूची के लिए कृपया मैन पेज (`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` (लाल टेक्स्ट)

### उपलब्ध रंग अनुकूलन विकल्प

निम्नलिखित UI तत्वों को अनुकूलित किया जा सकता है:

| Element            | Description                                 | Example                        |
|--------------------|---------------------------------------------|--------------------------------|
| `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) एक स्क्रिप्ट है जो filename:lines:columns दिए जाने पर संदर्भ प्रिंट करती है)

आपको ऐसी चीज़ें मिलती हैं:

![preview demo](https://assets.kitploit.com/production/public/readmes/54416/b89dd1e40297ffc3fa4684c4a6d5dc9506c0eafdb881d4cea079ff843f1a271a/84156872f39354a97241078491506fee9f9962eda6628161f94f6f36ec2c79f9-display-v1.webp)

### यह कैसे काम करता है?

यदि preview कमांड `--preview` विकल्प द्वारा दी गई है, तो skim `{}` को वर्तमान हाइलाइट की गई पंक्ति से बदल देगा, जो single quotes से घिरी होती है, कमांड को कॉल करके आउटपुट प्राप्त करता है, और आउटपुट को preview विंडो पर प्रिंट करता है।

कभी-कभी आपको कमांड को लागू करने के लिए पूरी पंक्ति की आवश्यकता नहीं होती है। इस मामले में आप फ़ील्ड चुनने के लिए `{}`, `{1..}`, `{..3}` या `{1..5}` का उपयोग कर सकते हैं। सिंटैक्स को [Fields Support](#filds-support) अनुभाग में समझाया गया है।

अंत में, आप `--preview-window` के साथ preview विंडो की स्थिति कॉन्फ़िगर करना चाह सकते हैं:
- `--preview-window up:30%` विंडो को ऊपर की स्थिति में रखने के लिए, जिसकी ऊँचाई skim की कुल ऊँचाई का 30% हो।
- `--preview-window left:10:wrap` यह निर्दिष्ट करने के लिए कि `wrap` preview विंडो को preview कमांड के आउटपुट को लपेटने की अनुमति देता है।
- `--preview-window wrap:hidden` स्टार्टअप पर preview विंडो को छिपाने के लिए, बाद में इसे `toggle-preview` एक्शन द्वारा दिखाया जा सकता है।

## Fields support

सामान्यतः केवल प्लगइन उपयोगकर्ताओं को इसे समझने की आवश्यकता होती है।

उदाहरण के लिए, आपके पास निम्न प्रारूप वाला डेटा स्रोत है:```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 ."

अंदर VM में, प्रोजेक्ट रूट `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