summaryrefslogtreecommitdiff
path: root/docs/source/conf.py
diff options
context:
space:
mode:
authorRob Cowsill <42620235+rcowsill@users.noreply.github.com>2021-05-06 23:14:49 +0100
committerRob Cowsill <42620235+rcowsill@users.noreply.github.com>2021-05-06 23:14:49 +0100
commit800a2e2d35f6799603d71beb38563afb87e7084b (patch)
tree8ad6340a0db1bf052d84533d70157aad655b3a80 /docs/source/conf.py
parent034470e5be8cfeef8ce0e0d2f47587a660682219 (diff)
downloadpodman-800a2e2d35f6799603d71beb38563afb87e7084b.tar.gz
podman-800a2e2d35f6799603d71beb38563afb87e7084b.tar.bz2
podman-800a2e2d35f6799603d71beb38563afb87e7084b.zip
[CI:DOCS] Stop conversion of `--` into en dash
In the documentation source `--` is only used in long option names or console output. Currently any unescaped `--` that's not in a code block/inline gets converted into a single "en dash". This is confusing to the reader because long options start with two dashes, not one. This switches off the dash transformation in Sphinx. Quotation marks, apostrophes and ellipses are still transformed as before. It also switches off all smart transforms in the podman-remote windows documentation build. This matches the Linux man page build, which doesn't use smart transforms. Signed-off-by: Rob Cowsill <42620235+rcowsill@users.noreply.github.com>
Diffstat (limited to 'docs/source/conf.py')
-rw-r--r--docs/source/conf.py4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 52869baf4..7a180e5ef 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -44,6 +44,10 @@ exclude_patterns = []
master_doc = "index"
+# Configure smartquotes to only transform quotes and ellipses, not dashes
+smartquotes_action = "qe"
+
+
# -- Options for HTML output -------------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for