fix: much better pdf (#2604)

* docs: fix PDF build by adding unicode mappings

* fix: better PDF

* fix: html build issue

docs/conf.py

@@ -238,12 +238,23 @@ htmlhelp_basename = "pybind11doc"
 latex_elements = {
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
     # The paper size ('letterpaper' or 'a4paper').
     # 'papersize': 'letterpaper',
     # 'papersize': 'letterpaper',
+    #
     # The font size ('10pt', '11pt' or '12pt').
     # The font size ('10pt', '11pt' or '12pt').
     # 'pointsize': '10pt',
     # 'pointsize': '10pt',
+    #
     # Additional stuff for the LaTeX preamble.
     # Additional stuff for the LaTeX preamble.
+    # remove blank pages (between the title page and the TOC, etc.)
+    "classoptions": ",openany,oneside",
     "preamble": r"""
     "preamble": r"""
+\usepackage{fontawesome}
+\usepackage{textgreek}
 \DeclareUnicodeCharacter{00A0}{}
 \DeclareUnicodeCharacter{00A0}{}
-\DeclareUnicodeCharacter{2194}{<->}
+\DeclareUnicodeCharacter{2194}{\faArrowsH}
+\DeclareUnicodeCharacter{1F382}{\faBirthdayCake}
+\DeclareUnicodeCharacter{1F355}{\faAdjust}
+\DeclareUnicodeCharacter{0301}{'}
+\DeclareUnicodeCharacter{03C0}{\textpi}
+
 """,
 """,
     # Latex figure (float) alignment
     # Latex figure (float) alignment
     # 'figure_align': 'htbp',
     # 'figure_align': 'htbp',

docs/index.rst

+.. only:: latex
+
+   Intro
+   =====
+
 .. include:: ../README.rst
 .. include:: ../README.rst
 
 
-.. only: not latex
+.. only:: not latex
 
 
     Contents:
     Contents: