Befehlszeilen-Snippet-Manager

Sie können den QOwnNotes-Befehlszeilen-Snippet-Manager verwenden, um Befehlsschnipsel, die in Notizen in QOwnNotes gespeichert sind, über die Befehlszeile auszuführen.

Sie können Notizen mit einem speziellen Schlagwort verwenden, um Befehls-Snippets zu speichern, die Sie **über den Befehlszeilen-Snippet-Manager ausführen ** können.

Installation

Besuchen Sie die Seite mit der neuesten Version und laden Sie die gewünschte Version herunter.

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

Abhängigkeiten

fzf (fuzzy search) oder peco (älter, aber eher standardmäßig installiert) müssen installiert sein, wenn in der Befehlszeile nach Befehlen gesucht werden soll.

Setup

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.

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

Und fügen Sie das Sicherheitstoken in das Attribut token ein:

[QOwnNotes]
token = "yourtokenhere"

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 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- 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

# Befehlsausschnitte suchen und drucken
qc-Suche

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

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