fix: fixed several warnings when building docs

src/examples/querying-data.rst

@@ -25,7 +25,7 @@ In a query you start by getting events from a bucket and assign that collection
 After that you assign what you want to receive from the request to the RETURN variable.
 
 Magic Variables:
-    There is a magic variable `__CATEGORIES__` you can use in the web UI's Query Explorer to include your configured categories in your query.
+    There is a magic variable ``__CATEGORIES__`` you can use in the web UI's Query Explorer to include your configured categories in your query.
 
     Here's an example of using this variable to find all events categorized as "Web Browsing"
 
@@ -86,7 +86,7 @@ Example fetching raw events from the "aw-watcher-window_" bucket:
     This is an example that you can run in a Python to fetch raw events posted by the window watcher.
     The scripts sums the time spent on each window title and showcases a data redaction use case.
 
-    .. literalinclude:: raw_events.py    
-    
+    .. literalinclude:: raw_events.py
+
 
 .. TODO `Bucket REST API <./rest.html#get-events>`_

src/examples/writing-watchers.rst

@@ -69,5 +69,5 @@ This example will describe how to:
 
 .. literalinclude:: client.rs
 
-It is recommend to follow conventions and use the `aw-watcher-<name>` naming scheme for your watcher.
-It is also recommended for watchers to accept a `--testing` flag and a `--port <port>` flag to allow users to specify the port to connect to.
+It is recommend to follow conventions and use the ``aw-watcher-<name>`` naming scheme for your watcher.
+It is also recommended for watchers to accept a ``--testing`` flag and a ``--port <port>`` flag to allow users to specify the port to connect to.

src/faq.rst

@@ -47,8 +47,9 @@ This is a good idea, any application shouldn't just give that privacy-sensitive
 Unfortunately, in Wayland compositors like Gnome's Mutter there is no way at all to get the current window, this leaves the window watcher completely disabled in Wayland.
 
 *Solutions:*
+
 - Switch to using X11.
-- Try an alternative AFK and window :ref:`watcher <other-watchers>` which supports Wayland.
+- Try an alternative AFK and window :ref:`watcher <window-watchers>` which supports Wayland.
 
 You can see the general status of the ability of `getting the active window in Wayland on StackOverflow <https://stackoverflow.com/questions/45465016/how-do-i-get-the-active-window-on-gnome-wayland>`_ or follow `the issue for ActivityWatch tracking the problem <https://github.com/ActivityWatch/activitywatch/issues/92>`_.
 

src/getting-started.rst

@@ -63,13 +63,13 @@ Autostart
 
    .. group-tab:: macOS
       You can automatically start ActivityWatch when you log in by [adding it to your Login Items](https://support.apple.com/guide/mac-help/open-items-automatically-when-you-log-in-mh15189/mac).
-      
+
    .. group-tab:: Arch Linux
 
       .. note::
          Autostart is set up automatically for Arch Linux by the AUR package, if your desktop environment supports `XDG Autostart <https://wiki.archlinux.org/index.php/XDG_Autostart>`_.
-         
-         You can set up autostart in other environments by adding [`dex`](https://archlinux.org/packages/extra/any/dex/) (to enable XDG autostart) or simply `aw-qt` to whatever place you put your startup applications (i3 config, etc).
+
+         You can set up autostart in other environments by adding [``dex``](https://archlinux.org/packages/extra/any/dex/) (to enable XDG autostart) or simply ``aw-qt`` to whatever place you put your startup applications (i3 config, etc).
 
    .. group-tab:: Ubuntu
 

src/remote-server.rst

@@ -65,9 +65,8 @@ Opening the server to the network
 
 .. warning:: This is unsafe! (unless you *really* know what you are doing)
 
-If you decide to not heed our warning, you can open the server to the network by setting the following `configuration`:
+If you decide to not heed our warning, you can open the server to the network by setting the following :doc:`configuration`:
 
-.. highlight:: toml
 aw-server.toml::
 
     [server]

src/watchers.rst

@@ -11,6 +11,8 @@ ActivityWatch comes with two watchers enabled by default:
 These default watchers are collecting some of the most important data.
 But there is more to collect, so here are some other watchers that let you do so.
 
+.. _window-watchers:
+
 Window watchers
 ---------------