Rstcheck config, update, and features (#473)

* Move rstcheck configuration to file

* Update rstcheck and enable additional features

Author: mmerklinger

Makefile

@@ -20,11 +20,7 @@ venv: $(NITROKEY_SDK_PY)
 
 .PHONY: check-syntax
 check-syntax: venv
-	# ignore-messages is needed due to links being used in directives, which
-	# are not visible by rstcheck as these directives are ignored (mostly faq)
-	venv/bin/rstcheck --recursive --ignore-directives card,tabs,faq,product-table \
-		--ignore-messages "faq(.*)Hyperlink target(.*)is not referenced" \
-		source
+	venv/bin/rstcheck --config rstcheck.toml --recursive source
 
 .PHONY: check-hyperlinks
 check-hyperlinks: venv docs

requirements.txt

@@ -12,7 +12,7 @@ MarkupSafe==3.0.2
 packaging==24.2
 Pygments==2.18.0
 requests==2.32.3
-rstcheck==6.2.4
+rstcheck [sphinx,toml] ==6.2.5
 snowballstemmer==2.2.0
 soupsieve==2.6
 Sphinx==8.1.3

rstcheck.toml

@@ -0,0 +1,11 @@
+[tool.rstcheck]
+ignore_directives = [
+    "card",
+    "tabs",
+    "faq",
+    "product-table",
+]
+# ignore-messages is needed due to links being used in directives, which
+# are not visible by rstcheck as these directives are ignored (mostly faq)
+ignore_messages = "faq(.*)Hyperlink target(.*)is not referenced"
+