Gestore dei frammenti di comandi

Puoi usare il Gestore dei frammenti di comandi QOwnNotes (opens new window) per eseguire frammenti di comandi memorizzati nelle note in QOwnNotes tramite la linea di comando.

Puoi usare note con etichette speciali per memorizzare frammenti di comandi che puoi eseguire dal gestore dei frammenti di comandi.

Installazione

Visita la pagina dell'ultimo rilascio (opens new window) e scarica la versione di cui hai bisogno.

TIP

Se hai installato jq (opens new window) puoi usarlo per scaricare e installare, per esempio l'ultima AppImage di Linux AMD64 in /usr/local/bin/qc:

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

Dipendenze

fzf (opens new window) (fuzzy search) or peco (opens new window) (più vecchio, ma più probabile che sia installato per impostazione predefinita) deve essere installato per cercare i comandi sulla riga di comando.

TIP

Per impostazione predefinita viene utilizzato fzf per la ricerca, ma puoi utilizzare peco impostandolo con qc configure.

Preparazione

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.

Quindi devi mostrare il token di sicurezza (3) e copiarlo (4).

Ora apri il file di configurazione dello snippet manager con:

# Configura il gestore degli snippet
qc configure

E inserisci il token di sicurezza nell'attributo token:

[QOwnNotes]
token = "yourtokenhere"

TIP

Nelle impostazioni di QOwnNotes puoi anche impostare quale tag nota deve essere utilizzato per cercare i comandi nelle note. Per impostazione predefinita, viene utilizzato il tag commands.

Sintassi dei frammenti di comando

Puoi utilizzare elenchi non ordinati con blocchi di codice in linea per memorizzare frammenti di comando. Tutte le note con il tag comandi vengono cercate per frammenti di comando.

Se aggiungi un cmd: prima del blocco di codice in linea, il comando si troverà anche nella nota corrente indipendentemente dai tag della nota.

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

I blocchi di codice bash o shell, preceduti da un'intestazione 2 o superiore come descrizione, possono essere utilizzati anche per frammenti di comando. I tag sono supportati anche se si trovano tra l'intestazione e il blocco di codice.

## Fallo con un blocco di codice "bash".

- questo testo verrà ignorato
- ma si possono usare i tag: #tag1 #tag2

```bash
echo fai questo
 echo fai quest'altro
```


## Fai qualcos'altro con un blocco di codice "sh".

```sh
echo fare qualcos'altro
 echo fai qualcos'altro
```

L'esempio precedente risulterà in due frammenti di comando, il primo con i due tag tag1 e tag2.

Come si usa

# Cerca ed esegui frammenti di comando
qc exec

# Cerca e visualizza frammenti di comando
qc search

Configurazione

Esegui qc configure.

[General]
  editor = "vim"            # il tuo editor di testo preferito
  column = 40               # numero di colonne per la lista comandi
  selectcmd = "fzf"         # selettore per modificare il comando (fzf o peco)
  sortby = ""               # specifica come i frammenti saranno ordinati (recency (predefinito), -recency, description, -description, command, -command, output, -output)

[QOwnNotes]
  token = "MvTagHXF"        # il tuo token API QOwnNotes
  websocket_port = 22222    # porta websocket di QOwnNotes

Completamento console

Puoi generare il codice per il completamento da console per la tua shell con qc completion <shell>.

Per esempio, per la Fish shell puoi usare:

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