docs-rst: improve output for .. notes:: on LaTeX (60459774) · Commits · 戴 / test

The output for those notes are bad in pdf, as they're not in a box with a different color. Also, it causes the output to not build if the note is inside a table. Change its implementation to avoid the above troubles. The logic there came from: https://stackoverflow.com/questions/606746/how-to-customize-an-existing-latex-environment-without-interfering-with-other-en Signed-off-by:

Documentation/conf.py

+23 −0

Original line number	Diff line number	Diff line
		@@ -258,6 +258,29 @@ latex_elements = {
		'preamble': '''
		% Allow generate some pages in landscape
		\\usepackage{lscape}

		% Put notes in gray color and let them be inside a table

		\\definecolor{MyGray}{rgb}{0.80,0.80,0.80}

		\\makeatletter\\newenvironment{graybox}{%
		\\begin{lrbox}{\\@tempboxa}\\begin{minipage}{\\columnwidth}}{\\end{minipage}\\end{lrbox}%
		\\colorbox{MyGray}{\\usebox{\\@tempboxa}}
		}\\makeatother

		\\makeatletter
		\\renewenvironment{notice}[2]{
		\\begin{graybox}
		\\bf\\it
		\\def\\py@noticetype{#1}
		\\par\\strong{#2}
		\\csname py@noticestart@#1\\endcsname
		}
		{
		\\csname py@noticeend@\\py@noticetype\\endcsname
		\\end{graybox}
		}
		\\makeatother
		'''
		}