summaryrefslogtreecommitdiff
path: root/docs/typ/setup.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/setup.typ')
-rw-r--r--docs/typ/setup.typ33
1 files changed, 15 insertions, 18 deletions
diff --git a/docs/typ/setup.typ b/docs/typ/setup.typ
index cc5b5552..df99a45f 100644
--- a/docs/typ/setup.typ
+++ b/docs/typ/setup.typ
@@ -3,8 +3,6 @@
// works best. Each snippet says in one line why it is there.
#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs
-pardes runs as it is; a few lines elsewhere make it fit.
-
= Install <install>
#include "install.typ"
@@ -61,17 +59,16 @@ fi
= A pager <pager>
-`pardes -` reads its standard input into the directory's one `+Pager`
-pane, colours kept, and returns. With #word("Pager") `pardes` (the default) a
-terminal's shell gets `PAGER`, `GIT_PAGER` and `SYSTEMD_PAGER` set to it,
-and `SYSTEMD_PAGERSECURE=0`, each only where your environment does not set
-it. So `git log`, `journalctl` or `man` output arrives as a pane to search
-and click in, a diff drawn as one; command panes page through `cat`. `man`
-reads `MANPAGER` first, which pardes never sets. Any pager of your own wins;
-#word("Pager") `off` in the startup file keeps them all yours, for terminals started
-after it. git colours what it pages by default (`color.pager`); ask other
-programs for colour outright (`ls --color=always | pardes -`), and put
-#word("PagerColor") `off` in the init file for plain text.
+#cmd("ls --color=always | pardes - # into the directory's +Pager, colours kept")
+
+With #word("Pager") `pardes` (the default) a terminal's shell gets
+`PAGER`, `GIT_PAGER` and `SYSTEMD_PAGER` set to it (and
+`SYSTEMD_PAGERSECURE=0`) wherever your environment leaves them unset, so
+`git log`, `journalctl` and `man` arrive as a pane, a diff drawn as one;
+command panes page through `cat`. `man` reads `MANPAGER` first, which
+pardes never sets. #word("Pager") `off` in the startup file leaves them all
+yours, for terminals started after it; #word("PagerColor") `off` makes the
+text plain.
= yazi in a terminal pane <yazi>
@@ -105,9 +102,7 @@ script on that `PATH` is a word you can click.
= Language servers <language-servers>
-pardes starts a language server for a file it knows, finding the program
-on `PATH`; `PARDES_LSP_<LANG>` names another, and an empty value turns it
-off.
+pardes starts a language server for a file it knows, from `PATH`:
#pairs(
[`.zig`], [`zls` (`PARDES_LSP_ZIG`)],
@@ -118,14 +113,16 @@ off.
[`.py`], [`pyright-langserver --stdio` (`PARDES_LSP_PY`)],
)
+#cmd("PARDES_LSP_ZIG=$HOME/src/zls/zig-out/bin/zls pardes # another zls\nPARDES_LSP_PY= pardes # none for .py")
+
#word("Lspinfo") (#key("SPC l i")) says what is running.
= Fonts and themes <fonts-and-themes>
The terminal build uses your terminal's font. The SDL window carries
Adwaita Mono and finds others in `/usr/share/fonts`,
-`/usr/local/share/fonts`, `~/.local/share/fonts` and `~/.fonts`; `Font
-name:size` picks one. `Theme <name>` and `ThemeFile` are in the themes
+`/usr/local/share/fonts`, `~/.local/share/fonts` and `~/.fonts`; #word("Font")
+`Iosevka:16` picks one. #word("Theme") `<name>` and #word("ThemeFile") are in the themes
chapter (#doc("themes")).
= plan9port <plan9port>