# Command-line Snippet Manager

Sie k├Ânnen den QOwnNotes-Befehlszeilen-Snippet-Manager (opens new window) verwenden, um Befehlsschnipsel, die in Notizen in QOwnNotes gespeichert sind, ├╝ber die Befehlszeile auszuf├╝hren.

qc

Sie k├Ânnen Notizen mit einem speziellen Tag verwenden, um Befehls-Snippets zu speichern, die Sie ├╝ber den Befehlszeilen-Snippet-Manager ausf├╝hren k├Ânnen.

commands

# Installation

Besuchen Sie die Seite Neueste Version (opens new window) und laden Sie die gew├╝nschte Version herunter.

TIP

Wenn Sie jq (opens new window) installiert haben, k├Ânnen Sie dieses Snippet auch verwenden, um beispielsweise das neueste Linux AMD64 AppImage unter /usr/local/bin/qc herunterzuladen und zu installieren:

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
1
2
3
4
5
6
7

# Abh├Ąngigkeiten

fzf (opens new window) (fuzzy search) or peco (opens new window) (├Ąlter, aber eher standardm├Ą├čig installiert) notwendig zu installieren, wenn nach Befehlen in der Befehlszeile gesucht werden soll.

TIP

Standardm├Ą├čig wird fzf f├╝r die Suche verwendet, aber Sie k├Ânnen peco verwenden, indem Sie es mit qc configure einstellen.

# Aufstellen

socket-server-token

Bevor Sie den Snippet-Manager verwenden, m├╝ssen Sie den Web-Socket-Server (2) in den Einstellungen Browsererweiterung / Befehlsschnipsel (1) in QOwnNotes aktivieren.

Dann m├╝ssen Sie das Sicherheitstoken vorzeigen (3) und kopieren (4).

├ľffnen Sie nun die Konfigurationsdatei des Snippet-Managers mit:

# Konfigurieren Sie den Snippet-Manager
qc configure
1
2

Und f├╝gen Sie das Sicherheitstoken in das Attribut token ein:

[QOwnNotes]
token = "yourtokenhere"
1
2

TIP

In den QOwnNotes-Einstellungen k├Ânnen Sie auch festlegen, welches Notiz-Tag verwendet werden soll, um in Notizen nach Befehlen zu suchen. Standardm├Ą├čig wird das Tag commands verwendet.

# Syntax von Befehlsschnipseln

Sie k├Ânnen ungeordnete Listen mit Inline-Codebl├Âcken verwenden, um Befehlsausschnitte zu speichern. Alle Notizen mit dem Tag commands werden nach Befehlsschnipseln durchsucht.

Wenn Sie vor dem Inline-Codeblock ein cmd: hinzuf├╝gen, wird der Befehl auch in der aktuellen Notiz gefunden, unabh├Ąngig von Notiz-Tags.

- `Echo Ich bin ein Befehl` Ich bin eine Beschreibung #tag1 #tag2 #tag3
* `Echo Ich bin auch ein Befehl` Ich bin eine Beschreibung #tag3 #tag4 #tag5
- cmd: `echo I wird in der aktuellen Notiz gefunden` Dieser Befehl wird in der aktuellen Notiz unabh├Ąngig von Notiz-Tags gefunden

<!-- Beispiel f├╝r das Abfragen von Benutzereingaben -->

- `read -p "PR ID: " id && git holt den Ursprung pull/$id/head:pull-$id && git checkout pull-$id` Fragen Sie nach der Pull-Request-ID und Checkout-Pull-Request
1
2
3
4
5
6
7

Bash- oder Shell-Codebl├Âcke, denen eine ├ťberschrift 2 oder h├Âher als Beschreibung vorangestellt ist, k├Ânnen auch f├╝r Befehlsschnipsel verwendet werden. Tags werden auch unterst├╝tzt, wenn sie sich zwischen der ├ťberschrift und dem Codeblock befinden.

## Tun Sie dies mit einem "Bash" -Codeblock

- dieser Text wird ignoriert Text
- aber Tags k├Ânnen verwendet werden: #tag1 #tag2

```bash
Echo mach das
 Echo mach das
```


## Mach etwas anderes mit einem "sh" Codeblock

```sh
Echo mach was anderes
 echo mach was anderes
```

Das obige Beispiel f├╝hrt zu zwei Befehlsschnipseln, dem ersten mit den beiden Tags tag1 und tag2.

# Verwendung

# Befehlsschnipsel suchen und ausf├╝hren
qc exec
1
2
# Befehlsausschnitte suchen und drucken
qc-Suche
1
2

# Aufbau

F├╝hren Sie qc configure aus.

[General]
  editor = "vim"            # Ihr Lieblingstexteditor
  column = 40               # Spaltengr├Â├če f├╝r Listenbefehl
  selectcmd = "fzf"         # Selektorbefehl f├╝r Editierbefehl (fzf oder peco)
  sortby = ""               # Geben Sie an, wie Snippets sortiert werden (recency (default), -recency, description, -description, command, -command, output, -output)

[QOwnNotes]
  token = "MvTagHXF"        # your QOwnNotes API token
  websocket_port = 22222    # websocket port in QOwnNotes
1
2
3
4
5
6
7
8
9

# Shell-Vervollst├Ąndigung

Sie k├Ânnen Shell-Vervollst├Ąndigungscode f├╝r Ihre Shell mit qc-Vervollst├Ąndigung <shell> generieren.

F├╝r die Fischschale k├Ânnen Sie beispielsweise verwenden:

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