docs: add common problems docs page

BrewingWeasel · Sep 5, 2024 · 803f441 · 803f441
1 parent 486559d
commit 803f441
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/docs/common_problems.md b/docs/common_problems.md
@@ -0,0 +1,13 @@
+# Common Problems
+
+## Unable to connect to Anki
+
+If you have AnkiConnect installed and are unable to connect to Anki (even after restarting Anki and Kalba), AnkiConnect may be configured to use a different port.
+To fix this, go to Tools -> Add-ons -> AnkiConnect -> Config in Anki and check the number after "webBindPort."
+You can then update Kalba to connect to this same port in Settings -> Anki -> AnkiConnect Port.
+
+## Missing minimize and maximize buttons (GNOME)
+
+The Minimize and Maximize buttons may be missing from the window title bar in GNOME.
+To fix this, make sure you have GNOME Tweaks installed, and then enable the Minimize and Maximize buttons under Gnome Tweaks -> Windows -> Titlebar Buttons.
+![Screenshot from 2024-09-04 16-05-09](https://github.com/user-attachments/assets/b1acf26f-7894-4d6a-8688-9809ad1c43c8)
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -27,4 +27,6 @@ nav:
   - "Advanced Configuration":
       - "Writing a spyglys parser": "spyglys_parser.md"
       - Backups: "backups.md"
+  - "Help":
+      - "Common Problems": "common_problems.md"
 theme: readthedocs