apply replacements to rstcheck

Signed-off-by: Dave Dykstra <[email protected]>

.github/workflows/pull_request.yml

@@ -38,7 +38,10 @@ jobs:
 
       - name: Lint rst
         run: |
-          rstcheck --ignore-language c,c++ --report warning *.rst
+          set -x
+          python3 copyreplace.py *.rst
+          rstcheck --ignore-language c,c++ --report warning *.rep
+          rm -f *.rep
 
       - name: Build web documentation
         run: |

contributing.rst

@@ -29,8 +29,7 @@ help out other users!
 ======================
 
 Many of our users come to Slack for quick help with an issue. You can
-find us at `apptainer
-<https://apptainer.slack.com/>`_.
+join through the `apptainer help page <https://apptainer.org/help/>`_.
 
 .. _contributing-to-documentation:
 

copyreplace.py

@@ -0,0 +1,16 @@
+#
+# This copies all files given in argv to the same file name with a '.rep'
+#  extension, replacing all the strings defined in replacements.py.
+#  This is intended for use in conjunction with rstcheck which runs
+#  independently of the variable replacement that sphinx does.
+#
+from replacements import *
+import sys
+
+for f in sys.argv[1:]:
+    with open(f, 'r', encoding='utf-8') as fdin:
+        data = fdin.read()
+        for key in variable_replacements:
+            data = data.replace(key, variable_replacements[key])
+        with open(f + '.rep', 'w', encoding='utf-8') as fdout:
+            fdout.write(data)