summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
authorEd Santiago <santiago@redhat.com>2022-09-15 13:49:03 -0600
committerEd Santiago <santiago@redhat.com>2022-09-15 14:35:06 -0600
commite2573b734efa17c476afac54a98c50aac62cb5c6 (patch)
tree03a4a2772d1e1a82836c4467b0fde79da2bc8e4a /docs/source
parent750726e62c13941a739ef70040a1ec0d745cdb43 (diff)
downloadpodman-e2573b734efa17c476afac54a98c50aac62cb5c6.tar.gz
podman-e2573b734efa17c476afac54a98c50aac62cb5c6.tar.bz2
podman-e2573b734efa17c476afac54a98c50aac62cb5c6.zip
Fix broken titles on readthedocs
Followup to #15621, which (correctly) removed parentheses from md files. Turns out, a hidden part of our readthedocs process depended on those parentheses. Update that step so it handles the new, correct, <space><section-number> format. Also update local-testing documentation in README, and clean it up a little. Fixes: #15822 Signed-off-by: Ed Santiago <santiago@redhat.com>
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/conf.py4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/source/conf.py b/docs/source/conf.py
index b58bb3f46..345e289e1 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -86,12 +86,12 @@ def convert_markdown_title(app, docname, source):
if docpath.endswith(".md"):
# Convert pandoc title line into eval_rst block for myst_parser
#
- # Remove the ending "(1)" to avoid it from being displayed
+ # Remove the ending " 1" (section) to avoid it from being displayed
# in the web tab. Often such a text indicates that
# a web page got an update. For instance GitHub issues
# shows the number of new comments that have been written
# after the user's last visit.
- source[0] = re.sub(r"^% (.*)(\(\d\))", r"```{title} \g<1>\n```", source[0])
+ source[0] = re.sub(r"^% (.*)\s(\d)", r"```{title} \g<1>\n```", source[0])
def setup(app):
app.connect("source-read", convert_markdown_title)