docs: migrate to automatic preference listing with markdown

Author: minijackson

docs/source/conf.py

@@ -30,6 +30,7 @@
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
+    "myst_parser",
     "preferences_listing",
 ]
 
@@ -187,6 +188,22 @@ def find_phoebus_version() -> str:
 htmlhelp_basename = 'Phoebusdoc'
 
 
+# -- Options for MyST's markdown -----------------------------------------------
+# https://myst-parser.readthedocs.io/en/latest/configuration.html
+
+myst_enable_extensions = [
+    "amsmath",
+    "colon_fence",
+    "deflist",
+    "dollarmath",
+    "fieldlist",
+    "html_image",
+    "replacements",
+    "smartquotes",
+    "strikethrough",
+    "tasklist",
+]
+
 # -- Options for LaTeX output --------------------------------------------------
 
 latex_elements = {

docs/source/preference_properties.md

@@ -0,0 +1,16 @@
+(preference_settings)=
+# Preferences Listing
+
+The following preference settings are available for the various application features.
+To use them in your settings file, remember to prefix each setting with the package name.
+
+For example,
+for the `drop_failed_archives` preference in the `trends.databrowser3` section
+(package name `org.csstudio.trends.databrowser3`) add a line like:
+
+```properties
+org.csstudio.trends.databrowser3/drop_failed_archives=true
+```
+
+```{prefs:listing}
+```

docs/source/preference_properties.rst

@@ -1,2 +1,3 @@
 sphinx==8.2.3
 sphinx_rtd_theme==3.0.2
+myst-parser==4.0.1