Various fixes (#485)

* Fix Google Analytics token. Currently it's using the one from spack.readthedocs.io, which means the analytics from our docs are unreliable
* Ensure conf.py is in sync with spack/spack
* Use the same formatter as in spack/spack
* Fix a typo
* Fix Python/YAML style, and fix a few syntax errors related to it
* Fix includes of build system modules
* Fix include of a command output
* Enable warning = error to avoid issues in the future...

Author: haampie

.github/workflows/style.yml

@@ -14,6 +14,8 @@ jobs:
         with:
           python-version: '3.13'
 
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
       - name: Run RST Formatter
-        run: |
-          bin/format_rst_file.py --check *.rst
+        run: ./bin/format_rst_file.py $(git ls-files '*.rst')

.gitmodules

@@ -2,3 +2,7 @@
 	path = _spack_root
 	url = https://github.com/spack/spack.git
 	branch = releases/v1.0
+[submodule "_spack_packages"]
+	path = _spack_packages
+	url = https://github.com/spack/spack-packages
+	branch = releases/v2025.07

.readthedocs.yaml

@@ -15,14 +15,17 @@ build:
     # golang: "1.20"
   apt_packages:
     - graphviz
+  jobs:
+    post_checkout:
+      - git fetch --unshallow || true  # get accurate "Last updated on" info
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
   configuration: conf.py
   # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
   # builder: "dirhtml"
   # Fail on all warnings to avoid broken references
-  # fail_on_warning: true
+  fail_on_warning: true
 
 # We need to include the _spack_root submodule to get the logo image
 submodules:

_spack_packages

@@ -2,12 +2,12 @@
 
 {%- block extrahead %}
   <!-- Google tag (gtag.js) -->
-  <script async src="https://www.googletagmanager.com/gtag/js?id=G-S0PQ7WV75K"></script>
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-3N7XQV9Z1J"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments);}
     gtag('js', new Date());
-    gtag('config', 'G-S0PQ7WV75K');
+    gtag('config', 'G-3N7XQV9Z1J');
   </script>
   {%- if READTHEDOCS %}
   <meta name="readthedocs-addons-api-version" content="1">