From 1eb00d8d1484324a94e52d671d2fca5f829947e2 Mon Sep 17 00:00:00 2001 From: Stefan Haller Date: Tue, 25 Mar 2025 09:32:00 +0100 Subject: [PATCH] Add newlines for correct markdown See https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md#md031---fenced-code-blocks-should-be-surrounded-by-blank-lines --- docs/Config.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/Config.md b/docs/Config.md index 421fbab53..53c6c8176 100644 --- a/docs/Config.md +++ b/docs/Config.md @@ -649,32 +649,39 @@ os: ``` ## Custom Command for Opening a Link + ```yaml os: openLink: 'bash -C /path/to/your/shell-script.sh {{link}}' ``` + Specify the external command to invoke when opening URL links (i.e. creating MR/PR in GitLab, BitBucket or GitHub). `{{link}}` will be replaced by the URL to be opened. A simple shell script can be used to further mangle the passed URL. ## Custom Command for Copying to and Pasting from Clipboard + ```yaml os: copyToClipboardCmd: '' ``` + Specify an external command to invoke when copying to clipboard is requested. `{{text}` will be replaced by text to be copied. Default is to copy to system clipboard. If you are working on a terminal that supports OSC52, the following command will let you take advantage of it: + ```yaml os: copyToClipboardCmd: printf "\033]52;c;$(printf {{text}} | base64 -w 0)\a" > /dev/tty ``` For tmux you need to wrap it with the [tmux escape sequence](https://github.com/tmux/tmux/wiki/FAQ#what-is-the-passthrough-escape-sequence-and-how-do-i-use-it), and enable passthrough in tmux config with `set -g allow-passthrough on`: + ```yaml os: copyToClipboardCmd: printf "\033Ptmux;\033\033]52;c;$(printf {{text}} | base64 -w 0)\a\033\\" > /dev/tty ``` For the best of both worlds, we can let the command determine if we are running in a tmux session and send the correct sequence: + ```yaml os: copyToClipboardCmd: > @@ -686,10 +693,12 @@ os: ``` A custom command for reading from the clipboard can be set using + ```yaml os: readFromClipboardCmd: '' ``` + It is used, for example, when pasting a commit message into the commit message panel. The command is supposed to output the clipboard content to stdout. ## Configuring File Editing @@ -960,6 +969,7 @@ In situations where certain naming pattern is used for branches, this can be use Example: Some branches: + - jsmith/AB-123 - cwilson/AB-125