مدير قصاصات سطر الأوامر

يمكنك استخدام مدير قصاصات سطر أوامر 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

ثم ضع رمز الأمان في خاصية token:

[QOwnNotes]
token = "رمز الأمان الخاص بك هنا"

::: تلميح داخل إعدادات QOwnNotes بإمكانك أيضا وضع وسم الملاحظة الذي يجب إستعماله من أجل البحث عن الأوامر داخل الملاحظات. بشكل تلقائي يتم إستعمال الوسم commands. :::

صيغة قصاصات الأوامر

يمكنك استخدام قائمة منقوطة عناصرها أكواد مضمّنة في السطر لتخزين قصاصات الأوامر. سيتم البحث عن قصاصات الأوامر في جميع الملاحظات الموسومة بالوسم commands.

وإذا أضفت 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

يمكن استخدام **كتل أكواد bash أو shell ** لقصاصات الأوامر، على أن تُسبق بعنوان من المستوى الثاني أو أعلى، والذي سيستخدم لوصفها. الوسوم مدعومة إذا كانت بين العنوان وكتلة الكود.

## افعل شيئا بكتلة كود باش: bash

- سيتم تجاهل هذا النص
- لكن يمكن استخدام الوسوم: #وسم١ #وسم٢

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

## افعل شيئا آخر بكتلة كود شل: sh

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

سيُنتج هذا المثال قصاصتي أوامر: أولاهما موسومة بالوسمين وسم١ و وسم٢.

الاستخدام

# ابحث عن قصاصات أوامر ونفذها
qc exec

# ابحث عن قصاصات أوامر واعرضها
qc search

التهيئة

نفّذ qc configure.

[General]
  editor = "vim"            # محرر النصوص المفضل لديك
  column = 40               # عرض العمود في أمر السرد
  selectcmd = "fzf"         # برنامج التحديد من أجل أمر التحرير (fzf أو peco)
  sortby = ""               # تعيين طريقة ترتيب القصاصات؛ القيم المقبولة هي:
      # recency = بالأحدث (القيمة الافتراضية)
      # -recency = بالأحدث، ترتيب عكسي
      # description = بالوصف
      # -description = بالوصف، ترتيب عكسي
      # command = بالأمر
      # -command = بالأمر، ترتيب عكسي
      # output = بالناتج
      # -output = بالناتج، ترتيب عكسي

[QOwnNotes]
  token = "MvTagHXF"        # رمز الأمان
  websocket_port = 22222    # منفذ مقبس الويب في التطبيق

إكمال الصَدفة

يمكنك توليد كود إكمال الصدفة المناسب لصدفتك بالأمر qc completion <اسم_صدفتك>.

مثلا لصدفة Fish، يمكنك تنفيذ الأمر:

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