Add sitemap + canonical URLs, fix repo/edit buttons, enable edit button

- Add html_baseurl (canonical <link> tags for SEO) and sphinx_sitemap
  to generate sitemap.xml; pin sphinx-sitemap
- Fix latent bug: the manual html_theme_options block overrode Jukyter
  Book's generated theme options, so the repository/issues buttons never
  rendered. Move repository_url/branch + button flags into the block.
- Enable the "edit this page" button (use_edit_page_button); path_to_docs
  set to "" for clean /edit/master/<file> links
- Tidy a duplicate linkcheck comment

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mariaob1201

_config.yml

@@ -14,7 +14,7 @@ exclude_patterns: [README.md, CONTRIBUTING.md]
 html:
   use_issues_button: true
   use_repository_button: true
-  use_edit_page_button: false
+  use_edit_page_button: true
   home_page_in_navbar: false
   extra_footer: |
     <p>Licensed under the <a href="https://opensource.org/licenses/Apache-2.0">Apache 2.0 License</a>.
@@ -50,11 +50,20 @@ sphinx:
     - ablog
     - sphinxext.opengraph
     - notfound.extension
+    - sphinx_sitemap
   config:
     html_theme: "sphinx_book_theme"
     html_show_sourcelink: false
     html_favicon: "_static/open-lambda.png"
 
+    # Canonical site URL — emits <link rel="canonical"> tags (SEO) and is
+    # required by sphinx_sitemap.
+    html_baseurl: "https://open-lambda.github.io/"
+
+    # ---- Sitemap (sphinx_sitemap) ----
+    # No language/version path segments on this site, so use a flat scheme.
+    sitemap_url_scheme: "{link}"
+
     # ---- Open Graph / social-card metadata ----
     ogp_site_url: "https://open-lambda.github.io/"
     ogp_site_name: "OpenLambda"
@@ -66,8 +75,6 @@ sphinx:
     notfound_urls_prefix: "/"
 
     # ---- Link checking ----
-    # usenix.org returns 403 to automated checkers (bot protection) but the
-    # links resolve fine in a browser, so skip them in linkcheck.
     linkcheck_ignore:
       # usenix.org returns 403 to automated checkers but works in-browser.
       - "https://www\\.usenix\\.org/.*"
@@ -79,6 +86,15 @@ sphinx:
     linkcheck_retries: 1
     linkcheck_rate_limit_timeout: 30
     html_theme_options:
+      # Repository buttons. These must live here: a manually-defined
+      # html_theme_options block overrides the options Jupyter Book would
+      # otherwise generate from the top-level html:/repository: blocks.
+      repository_url: "https://github.com/open-lambda/open-lambda.github.io"
+      repository_branch: "master"
+      path_to_docs: ""
+      use_repository_button: true
+      use_issues_button: true
+      use_edit_page_button: true
       use_download_button: false
       navigation_depth: 2
       show_navbar_depth: 1

requirements.txt

@@ -8,3 +8,4 @@ sphinx-copybutton==0.5.2
 ablog==0.11.13
 sphinxext-opengraph==0.9.1
 sphinx-notfound-page==1.0.4
+sphinx-sitemap==2.9.0