Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

doc: about zathura with WSL on Windows #2752

Merged
merged 1 commit into from
Jul 5, 2023
Merged

doc: about zathura with WSL on Windows #2752

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 30 additions & 2 deletions doc/vimtex.txt
View file
Open in desktop
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 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 by using 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