How to configure zsh prompt so that its length is proportional to terminal width
Zsh's prompt expansion behaviour is defined in man zshmisc
. Regarding setting custom values for prompt length it says:
%<string<
%>string>
%[xstring]
Specifies truncation behaviour for the remainder of the prompt
string. The third, deprecated, form is equivalent to
`%xstringx', i.e. x may be `<' or `>'. The string will be dis‐
played in place of the truncated portion of any string; note
this does not undergo prompt expansion.
The numeric argument, which in the third form may appear immedi‐
ately after the `[', specifies the maximum permitted length of
the various strings that can be displayed in the prompt. In the
first two forms, this numeric argument may be negative, in which
case the truncation length is determined by subtracting the
absolute value of the numeric argument from the number of char‐
acter positions remaining on the current prompt line. If this
results in a zero or negative length, a length of 1 is used. In
other words, a negative argument arranges that after truncation
at least n characters remain before the right margin (left mar‐
gin for RPROMPT).
The forms with `<' truncate at the left of the string, and the
forms with `>' truncate at the right of the string. For exam‐
ple, if the current directory is `/home/pike', the prompt
`%8<..<%/' will expand to `..e/pike'. In this string, the ter‐
minating character (`<', `>' or `]'), or in fact any character,
may be quoted by a preceding `\'; note when using print -P, how‐
ever, that this must be doubled as the string is also subject to
standard print processing, in addition to any backslashes
removed by a double quoted string: the worst case is therefore
`print -P "%<\\\\<<..."'.
If the string is longer than the specified truncation length, it
will appear in full, completely replacing the truncated string.
The part of the prompt string to be truncated runs to the end of
the string, or to the end of the next enclosing group of the
`%(' construct, or to the next truncation encountered at the
same grouping level (i.e. truncations inside a `%(' are sepa‐
rate), which ever comes first. In particular, a truncation with
argument zero (e.g., `%<<') marks the end of the range of the
string to be truncated while turning off truncation from there
on. For example, the prompt `%10<...<%~%<<%# ' will print a
truncated representation of the current directory, followed by a
`%' or `#', followed by a space. Without the `%<<', those two
characters would be included in the string to be truncated.
Note that `%-0<<' is not equivalent to `%<<' but specifies that
the prompt is truncated at the right margin.
Truncation applies only within each individual line of the
prompt, as delimited by embedded newlines (if any). If the
total length of any line of the prompt after truncation is
greater than the terminal width, or if the part to be truncated
contains embedded newlines, truncation behavior is undefined and
may change in a future version of the shell. Use
`%-n(l.true-text.false-text)' to remove parts of the prompt when
the available space is less than n.
From that you can infer
PROMPT="%/ "
will give you a working directoryPROMPT='%10<..<%/ '
will give you a working directory - if the working directory string is longer than 10 chars it will be truncated on the left edge, and where the truncation occurs, the..
pattern will be displayed (to indicate trimmed value)
The terminal width can be obtained with $COLUMNS
, so if you want a prompt constrained at 25% of the terminal width replace the 10
with a variable:
width=$(($COLUMNS / 4))
i.e.
PROMPT="%${width}<..<%/ %% "
This is what I eventually ended up writing.
# this variable can be changed later to change the fraction of the line
export PROMPT_PERCENT_OF_LINE=20
# make a function, so that it can be evaluated repeatedly
function myPromptWidth() {
echo $(( ${COLUMNS:-80} * PROMPT_PERCENT_OF_LINE / 100 ))
}
# for some reason you can't put a function right in PROMPT, so make an
# intermediary variable
width_part='$(myPromptWidth)'
# use ${} to evaluate the variable containing function
PROMPT="%F{106}%${width_part}<…<%3~%f%(?..%{$fg[red]%} %?%{$reset_color%})%(1j.%{$fg[cyan]%} %j%{$reset_color%}.)%# "
This will recalculate the width immediately on terminal resize.