Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 60459774 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet
Browse files

docs-rst: improve output for .. notes:: on LaTeX

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: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent caee5cde
Loading
Loading
Loading
Loading
+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
     '''
}