From 8a2e1006b3b272126332aa064f3ad95387129544 Mon Sep 17 00:00:00 2001
From: Biswakalyan Bhuyan <biswa@surgot.in>
Date: Thu, 13 Feb 2025 14:13:49 +0530
Subject: new dot files
---
.../zsh/oh-my-zsh/plugins/shrink-path/README.md | 116 +++++++++++++++++++++
1 file changed, 116 insertions(+)
create mode 100644 .config/zsh/oh-my-zsh/plugins/shrink-path/README.md
(limited to '.config/zsh/oh-my-zsh/plugins/shrink-path/README.md')
diff --git a/.config/zsh/oh-my-zsh/plugins/shrink-path/README.md b/.config/zsh/oh-my-zsh/plugins/shrink-path/README.md
new file mode 100644
index 0000000..71a242b
--- /dev/null
+++ b/.config/zsh/oh-my-zsh/plugins/shrink-path/README.md
@@ -0,0 +1,116 @@
+# shrink-path
+
+A plugin to shrink directory paths for brevity and pretty-printing.
+
+To use it, add `shrink-path` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... shrink-path)
+```
+
+## Examples
+
+For this directory tree:
+```
+/home/
+ me/
+ f o o/ # The prefix f is ambiguous between "f o o" and "f i g".
+ bar/
+ quux/
+ biz/ # The prefix b is ambiguous between bar and biz.
+ f i g/
+ baz/
+```
+here are the results of calling `shrink_path <option> /home/me/foo/bar/quux`:
+```
+Option Result
+<none> /h/m/f o/ba/q
+-l|--last /h/m/f o/ba/q
+-s|--short /h/m/f/b/q
+-t|--tilde ~/f o/ba/q
+-f|--fish ~/f/b/quux
+-g|--glob /h*/m*/f o*/ba*/q*
+-3 /hom/me/f o/bar/quu
+-e '$' -3 /hom$/me/f o$/bar/quu$
+-q /h/m/f\ o/ba/q
+-g -q /h*/m*/f\ o*/ba*/q*
+-x /home/me/foo/bar/quux
+```
+
+## Usage
+
+For a fish-style working directory in your command prompt, add the following to
+your theme or zshrc:
+
+```zsh
+setopt prompt_subst
+PS1='%n@%m $(shrink_path -f)>'
+```
+
+The following options are available:
+
+```
+ -f, --fish fish simulation, equivalent to -l -s -t.
+ -g, --glob Add asterisk to allow globbing of shrunk path (equivalent to -e "*")
+ -l, --last Print the last directory's full name.
+ -s, --short Truncate directory names to the number of characters given by -. Without
+ -s, names are truncated without making them ambiguous.
+ -t, --tilde Substitute ~ for the home directory.
+ -T, --nameddirs Substitute named directories as well.
+ -# Truncate each directly to at least this many characters inclusive of the
+ ellipsis character(s) (defaulting to 1).
+ -e SYMBOL Postfix symbol(s) to indicate that a directory name had been truncated.
+ -q, --quote Quote special characters in the shrunk path
+ -x, --expand Print the full path. This takes precedence over the other options
+```
+
+The long options can also be set via zstyle, like
+```zsh
+zstyle :prompt:shrink_path fish yes
+```
+
+Note: Directory names containing two or more consecutive spaces are not yet
+supported.
+
+
+## Trick: toggle shrinking with a keyboard shortcut
+
+You can use the `expand` option to disable the path shrinking. You can combine that
+with a key binding widget to toggle path shrinking on and off.
+
+```zsh
+# Toggle off path shrinking
+zstyle ':prompt:shrink_path' expand true
+# Toggle on path shrinking
+zstyle -d ':prompt:shrink_path' expand
+```
+
+Combined with a widget:
+
+```zsh
+# Widget definition
+shrink-path-toggle() {
+ zstyle -t ':prompt:shrink_path' expand \
+ && zstyle -d ':prompt:shrink_path' expand \
+ || zstyle ':prompt:shrink_path' expand true
+ zle reset-prompt
+}
+zle -N shrink-path-toggle
+# Key binding to ALT+SHIFT+S
+bindkey "^[S" shrink-path-toggle
+```
+
+## License
+
+Copyright (C) 2008 by Daniel Friesel <derf@xxxxxxxxxxxxxxxxxx>
+Copyright (C) 2018-2020 by Pavel N. Krivitsky
+
+License: WTFPL <http://www.wtfpl.net>
+
+Ref: https://www.zsh.org/mla/workers/2009/msg00415.html
+ https://www.zsh.org/mla/workers/2009/msg00419.html
+
+
+## Misc
+
+Keywords: prompt directory truncate shrink collapse fish
--
cgit v1.2.3-59-g8ed1b