LaTeX: fix 5.1.0 bugs related to topic and contents boxes (#11102)

* Fix #11095 (PDF wrong placement of shadow of topic boxes since 5.1.0)

* Fix #11096 (LaTeX shadowsize regression at 5.1.0)

* Fix #11099 (shadowrule legacy sphinxsetup key vanished at 5.1.0)

* Fix #11101 (LaTeX div.topic_padding of sphinxsetup had wrong name)

* Add some checks that various sphinxsetup keys do not break PDF build

* Update LaTeX docs

* Update CHANGES

* Can not use :dudir:`contents` has it links to wrong place

1 files changed, 72 insertions, 0 deletions

diff --git a/tests/roots/test-root/conf.py b/tests/roots/test-root/conf.py
index 6583fbb80..154d4d120 100644
--- a/tests/roots/test-root/conf.py
+++ b/tests/roots/test-root/conf.py
@@ -38,6 +38,78 @@ html_last_updated_fmt = '%b %d, %Y'
 html_context = {'hckey': 'hcval', 'hckey_co': 'wrong_hcval_co'}
 
 latex_additional_files = ['svgimg.svg']
+# some random pdf layout parameters to check they don't break build
+latex_elements = {
+    'sphinxsetup': """
+  verbatimwithframe,
+  verbatimwrapslines,
+  verbatimforcewraps,
+  verbatimmaxoverfull=1,
+  verbatimmaxunderfull=5,
+  verbatimhintsturnover=true,
+  verbatimcontinuesalign=l,
+  VerbatimColor={RGB}{242,242,242},
+  VerbatimBorderColor={RGB}{32,32,32},
+  VerbatimHighlightColor={RGB}{200,200,200},
+  pre_box-decoration-break=slice,
+  pre_border-top-left-radius=20pt,
+  pre_border-top-right-radius=0pt,
+  pre_border-bottom-right-radius=20pt,
+  pre_border-bottom-left-radius=0pt,
+  verbatimsep=1pt,
+  pre_padding=5pt,% alias to verbatimsep
+  pre_border-top-width=5pt,
+  pre_border-right-width=10pt,
+  pre_border-bottom-width=15pt,
+  pre_border-left-width=20pt,
+  pre_border-width=3pt,% overrides all previous four
+  verbatimborder=2pt,% alias to pre_border-width
+%
+  shadowrule=1pt,
+  shadowsep=10pt,
+  shadowsize=10pt,
+  div.topic_border-width=2pt,% alias to shadowrule 
+  div.topic_padding=6pt,% alias to shadowsep
+  div.topic_box-shadow=5pt,% overrides/alias shadowsize
+%
+  noteBorderColor={RGB}{204,204,204},
+  hintBorderColor={RGB}{204,204,204},
+  importantBorderColor={RGB}{204,204,204},
+  tipBorderColor={RGB}{204,204,204},
+%
+  noteborder=5pt,
+  hintborder=5pt,
+  importantborder=5pt,
+  tipborder=5pt,
+%
+  warningborder=3pt,
+  cautionborder=3pt,
+  attentionborder=3pt,
+  errorborder=3pt,
+%
+  dangerborder=3pt,
+  div.danger_border-width=10pt,
+  div.danger_background-TeXcolor={rgb}{0,1,0},
+  div.danger_border-TeXcolor={rgb}{0,0,1},
+  div.danger_box-shadow=20pt -20pt,
+  div.danger_box-shadow-TeXcolor={rgb}{0.5,0.5,0.5},
+%
+  warningBorderColor={RGB}{255,119,119},
+  cautionBorderColor={RGB}{255,119,119},
+  attentionBorderColor={RGB}{255,119,119},
+  dangerBorderColor={RGB}{255,119,119},
+  errorBorderColor={RGB}{255,119,119},
+  warningBgColor={RGB}{255,238,238},
+  cautionBgColor={RGB}{255,238,238},
+  attentionBgColor={RGB}{255,238,238},
+  dangerBgColor={RGB}{255,238,238},
+  errorBgColor={RGB}{255,238,238},
+%
+  TableRowColorHeader={rgb}{0,1,0},
+  TableRowColorOdd={rgb}{0.5,0,0},
+  TableRowColorEven={rgb}{0.1,0.1,0.1},
+""",
+}
 
 coverage_c_path = ['special/*.h']
 coverage_c_regexes = {'function': r'^PyAPI_FUNC\(.*\)\s+([^_][\w_]+)'}