Support containers in LaTeX output.

sphinx/texinputs/sphinx.sty

@@ -270,6 +270,11 @@
 \input{sphinxlatexshadowbox.sty}
 
 
+%% CONTAINERS
+%
+\input{sphinxlatexcontainers.sty}
+
+
 %% PYGMENTS
 % stylesheet for highlighting with pygments
 \RequirePackage{sphinxhighlight}

sphinx/texinputs/sphinxlatexcontainers.sty

@@ -0,0 +1,17 @@
+%% CONTAINER DIRECTIVES
+%
+% change this info string if making any custom modification
+\ProvidesFile{sphinxlatexcontainers.sty}[2021/05/03 containers]
+
+% The purpose of this file is to provide a dummy environment sphinxclass
+% which will be inserted for each class in each container directive. The class
+% name will be passed as the argument to the environment. User-defined
+% formatting of directives can be achieved by renewing the definition of this
+% environment, and branching on the value of the argument.
+
+\ifx\sphinxclass\undefined % poor man's "provideenvironment"
+    \newenvironment{sphinxclass}[1]{
+        \def\sphinxClassFunctionName{sphinxCLASS#1}%
+        \csname \sphinxClassFunctionName \endcsname}%
+    {\csname end\sphinxClassFunctionName \endcsname}%
+\fi

sphinx/writers/latex.py

@@ -1975,10 +1975,14 @@ def depart_compound(self, node: Element) -> None:
         pass
 
     def visit_container(self, node: Element) -> None:
-        pass
+        classes = node.get('classes', [])
+        for c in classes:
+            self.body.append('\n\\begin{sphinxclass}{%s}' % c)
 
     def depart_container(self, node: Element) -> None:
-        pass
+        classes = node.get('classes', [])
+        for c in classes:
+            self.body.append('\n\\end{sphinxclass}')
 
     def visit_decoration(self, node: Element) -> None:
         pass

tests/roots/test-latex-container/index.rst

@@ -0,0 +1,4 @@
+.. container:: classname
+
+    text
+

tests/test_build_latex.py

@@ -1599,3 +1599,11 @@ def test_latex_elements_extrapackages(app, status, warning):
 def test_latex_nested_tables(app, status, warning):
     app.builder.build_all()
     assert '' == warning.getvalue()
+
+
+@pytest.mark.sphinx('latex', testroot='latex-container')
+def test_latex_container(app, status, warning):
+    app.builder.build_all()
+    result = (app.outdir / 'python.tex').read_text()
+    assert r'\begin{sphinxclass}{classname}' in result
+    assert r'\end{sphinxclass}' in result