مدیر تکه کد خط فرمان

با استفاده از مدیر تکه کد خط فرمان QOwnNotes می توانید تکه کدهای دستوری ذخیره شده در یادداشت ها را در QOwnNotes و از طریق خط فرمان اجرا کنید.

با استفاده از یادداشت های دارای برچسب خاص می توانید تکه کدهای دستوری را ذخیره کرده و از مدیر تکه کد خط فرمان اجرا کنید.

نصب

صفحه جدیدترین انتشار را ملاحظه کرده و نسخه مورد نیاز خود را بارگیری کنید.

curl https://api.github.com/repos/qownnotes/qc/releases/latest | \
jq '.assets[] | select(.browser_download_url | endswith("_linux_amd64.tar.gz")) | .browser_download_url' | \
xargs curl -Lo /tmp/qc.tar.gz && \
tar xfz /tmp/qc.tar.gz -C /tmp && \
rm /tmp/qc.tar.gz && \
sudo mv /tmp/qc /usr/local/bin/qc && \
/usr/local/bin/qc --version

متعلقات

fzf (جستجوی فازی) یا peco (نسخه قدیمی تر اما به احتمال بیشتر نصب شده به صورت پیش فرض) برای جستجوی دستورات در خط فرمان باید نصب شده باشد.

تنظیمات

Before you are using the snippet manager you need to enable the Web socket server (2) in the Browser extension / command snippets (1) settings in QOwnNotes.

سپس باید توکن امنیتی را نشان داده (3) و از آن رونوشت برداری کنید (4).

اکنون از طریق دستور پیشرو پرونده پیکربندی مدیر تکه کد را باز کنید:

# پیکربندی مدیر تکه کد
qc configure

و توکن امنیتی را در مکان مشخص توکن قرار دهید:

[QOwnNotes]
token = "yourtokenhere"

چیدمان تکه کدهای دستوری

شما می توانید از لیست های نامرتب با کد بلوک های هم تراز برای ذخیره سازی تکه کدهای دستوری استفاده کنید. همه یادداشت های دارای برچسب دستورات برای تکه کدهای دستوری مورد جستجو قرار می گیرند.

در صورت افزودن cmd: قبل از کد بلوک هم تراز، دستور نیز بدون توجه به برچسب یادداشت در یادداشت کنونی دریافت خواهد شد.

- `echo I am a command` I am a description #tag1 #tag2 #tag3

* `echo I am also a command` I am a description #tag3 #tag4 #tag5

- cmd: `echo I will be found in the current note` This command will be found in the current note regardless of note tags

<!-- Example for asking for user input -->

- `read -p "PR ID: " id && git fetch origin pull/$id/head:pull-$id && git checkout pull-$id` Ask for pull request ID and checkout pull request

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

## انجام این کار با کد بلوک «بش»

- این متن نادیده گرفته می شود
- اما این برچسب ها قابل استفاده هستند: #tag1 #tag2

```bash
echo do this
echo do that
```

## کار دیگری با کد بلوک «sh» انجام دهید

```sh
echo do something else
echo do something other
```

مثال فوق منجر به دو تکه کد دستوری خواهد شد که مورد نخست دارای دو برچسب tag1 و tag2 می باشد.

کاربرد

# جستجو و اجرای تکه کدهای دستوری
qc exec

# جستجو و چاپ تکه کدهای دستوری
qc search

پیکربندی

qc configure را اجرا کنید.

[General]
  editor = "vim"            # your favorite text editor
  column = 40               # column size for list command
  selectcmd = "fzf"         # selector command for edit command (fzf or peco)
  sortby = ""               # specify how snippets get sorted (recency (default), -recency, description, -description, command, -command, output, -output)

[QOwnNotes]
  token = "MvTagHXF"        # your QOwnNotes API token
  websocket_port = 22222    # websocket port in QOwnNotes

تکمیل پوسته

شما می توانید کد تکمیل پوسته مربوط را با qc completion <shell> ایجاد کنید.

برای مثال برای پوسته ماهی می توانید از این دستور استفاده کنید:

qc completion fish > ~/.config/fish/completions/qc.fish