Skip to content

Commit

Permalink
doc: about zathura with WSL on Windows
Browse files Browse the repository at this point in the history
  • Loading branch information
jeangeorge authored and jeangeorge committed Jul 4, 2023
1 parent 91fbb48 commit 169365e
Showing 1 changed file with 30 additions and 2 deletions.
32 changes: 30 additions & 2 deletions doc/vimtex.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5775,8 +5775,8 @@ https://pwmt.org/projects/zathura/
Zathura is, like MuPDF, a very fast and minimalistic viewer. Compared to
MuPDF, it allows more user configuration. Zathura has full support for both
forward and inverse search. Zathura should be straightforward to install and
use on Linux with Xorg. It should also work on macOS, but users may want to
read |vimtex-faq-zathura-macos|.
use on Linux with Xorg. It should also work on macOS and WSL, but users may
want to read |vimtex-faq-zathura-macos| or |vimtex-faq-zathura-windows-wsl|.

Configuration: >vim
" Main variant with xdotool
Expand Down Expand Up @@ -6083,6 +6083,7 @@ Contents:
* |vimtex-faq-wsl|
* |vimtex-faq-sumatrapdf-wsl|
* |vimtex-faq-zathura-macos|
* |vimtex-faq-zathura-windows-wsl|
* |vimtex-faq-texshopviewer|
* |vimtex-faq-treesitter|

Expand Down Expand Up @@ -6373,6 +6374,33 @@ A: Yes, it should work. The following recipe has been reported to work [0],
[2]: https://github.com/lervag/vimtex/issues/2391#issuecomment-1127678531
[3]: https://github.com/zegervdv/homebrew-zathura/issues/99

------------------------------------------------------------------------------
*vimtex-faq-zathura-windows-wsl*
Q: Does Zathura + VimTeX work on WSL2 ?
A: Yes, but `systemd` or `D-Bus` must be enabled in particular to make inverse
search work properly.

1. `systemd` is the default for version of Ubuntu 23.04 running on WSL 2.
In this case, there is nothing to do : Zathura and VimTeX should work
fine.

2. Otherwise, if WSL version is 0.67.6 or newer, enable `systemd` by adding
the following content to the config file `/etc/wsl.conf`
(create the file if it doesn't exist). >
[boot]
systemd=true
<
Then close WSL and use the command `wsl.exe --shutdown` in PowerShell to
restart all WSL instances [0].

3. Another approach which also works with older version of WSL consists in
setting up `D-Bus` daemons that can be shared in all your WSL consoles.
These steps are described in [1].

[0]: https://learn.microsoft.com/en-us/windows/wsl/systemd
[1]: https://x410.dev/cookbook/wsl/sharing-dbus-among-wsl2-consoles/

------------------------------------------------------------------------------
*vimtex-faq-treesitter*
Q: How does VimTeX compare to Tree-sitter?
Expand Down

0 comments on commit 169365e

Please sign in to comment.