Close #7849: html: Add html_codeblock_linenos

CHANGES

@@ -13,6 +13,8 @@ Deprecated
 Features added
 --------------
 
+* #7849: html: Add :confval:`html_codeblock_linenos` to change the style of
+  line numbers for code-blocks
 * #7853: C and C++, support parameterized GNU style attributes.
 
 Bugs fixed

sphinx/builders/html/__init__.py

@@ -26,7 +26,7 @@
 from sphinx import package_dir, __display_version__
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
-from sphinx.config import Config
+from sphinx.config import Config, ENUM
 from sphinx.deprecation import RemovedInSphinx40Warning
 from sphinx.domains import Domain, Index, IndexEntry
 from sphinx.environment.adapters.asset import ImageAdapter
@@ -1226,6 +1226,7 @@ def setup(app: Sphinx) -> Dict[str, Any]:
     app.add_config_value('html_search_scorer', '', None)
     app.add_config_value('html_scaled_image_link', True, 'html')
     app.add_config_value('html_baseurl', '', 'html')
+    app.add_config_value('html_codeblock_linenos', 'table', 'html', ENUM('table', 'inline'))
     app.add_config_value('html_math_renderer', None, 'env')
     app.add_config_value('html4_writer', False, 'html')
 

sphinx/writers/html.py

@@ -445,6 +445,9 @@ def visit_literal_block(self, node: Element) -> None:
         else:
             opts = {}
 
+        if linenos and self.builder.config.html_codeblock_linenos:
+            linenos = self.builder.config.html_codeblock_linenos
+
         highlighted = self.highlighter.highlight_block(
             node.rawsource, lang, opts=opts, linenos=linenos,
             location=(self.builder.current_docname, node.line), **highlight_args

sphinx/writers/html5.py

@@ -397,6 +397,9 @@ def visit_literal_block(self, node: Element) -> None:
         else:
             opts = {}
 
+        if linenos and self.builder.config.html_codeblock_linenos:
+            linenos = self.builder.config.html_codeblock_linenos
+
         highlighted = self.highlighter.highlight_block(
             node.rawsource, lang, opts=opts, linenos=linenos,
             location=(self.builder.current_docname, node.line), **highlight_args