From 0a8423d792bda91ab74c9c8b0021c9a9388cbd46 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 30 Jun 2023 18:23:02 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=94=A8=20Enable=20linenums=20in=20MkDocs?=
 =?UTF-8?q?=20Material=20during=20local=20live=20development=20to=20simpli?=
 =?UTF-8?q?fy=20highlighting=20code=20(#9769)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/mkdocs.maybe-insiders.yml |  3 +++
 docs/en/mkdocs.yml                | 20 ++++++++++----------
 scripts/docs.py                   |  2 ++
 3 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/docs/en/mkdocs.maybe-insiders.yml b/docs/en/mkdocs.maybe-insiders.yml
index 8e6271334..37fd9338e 100644
--- a/docs/en/mkdocs.maybe-insiders.yml
+++ b/docs/en/mkdocs.maybe-insiders.yml
@@ -1,3 +1,6 @@
 # Define this here and not in the main mkdocs.yml file because that one is auto
 # updated and written, and the script would remove the env var
 INHERIT: !ENV [INSIDERS_FILE, '../en/mkdocs.no-insiders.yml']
+markdown_extensions:
+  pymdownx.highlight:
+    linenums: !ENV [LINENUMS, false]
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 21300b9dc..64dc40372 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -169,24 +169,24 @@ nav:
 - contributing.md
 - release-notes.md
 markdown_extensions:
-- toc:
+  toc:
     permalink: true
-- markdown.extensions.codehilite:
+  markdown.extensions.codehilite:
     guess_lang: false
-- mdx_include:
+  mdx_include:
     base_path: docs
-- admonition
-- codehilite
-- extra
-- pymdownx.superfences:
+  admonition:
+  codehilite:
+  extra:
+  pymdownx.superfences:
     custom_fences:
     - name: mermaid
       class: mermaid
       format: !!python/name:pymdownx.superfences.fence_code_format ''
-- pymdownx.tabbed:
+  pymdownx.tabbed:
     alternate_style: true
-- attr_list
-- md_in_html
+  attr_list:
+  md_in_html:
 extra:
   analytics:
     provider: google
diff --git a/scripts/docs.py b/scripts/docs.py
index 20838be6a..968dd9a3d 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -258,6 +258,8 @@ def live(
     Takes an optional LANG argument with the name of the language to serve, by default
     en.
     """
+    # Enable line numbers during local development to make it easier to highlight
+    os.environ["LINENUMS"] = "true"
     if lang is None:
         lang = "en"
     lang_path: Path = docs_path / lang