fix pdf doc build

Author: bckohan

.gitignore

@@ -162,3 +162,4 @@ cython_debug/
 poetry.lock
 .vscode
 django_typer/tests/dj_params.json
+**/.DS_Store

doc/source/_static/commands.css

@@ -0,0 +1,8 @@
+.big {
+    font-size: 24px;  /* Or any size you prefer */
+    font-weight: bold; /* If you want it bold */
+}
+.extrabig {
+    font-size: 36px;  /* Or any size you prefer */
+    font-weight: bold; /* If you want it bold */
+}

doc/source/_static/img/closepoll_example.png

@@ -2,10 +2,10 @@
 Change Log
 ==========
 
-.. v1.0.0
-.. ======
+v1.0.0
+======
 
-.. * Initial production/stable release.
+* Initial production/stable release.
 
 v0.6.1b
 =======

doc/source/_static/img/django_typer_upstream.pdf

@@ -78,9 +78,11 @@
 
 todo_include_todos = True
 
-def add_page_class(app, pagename, templatename, context, doctree):
-    from sphinx.builders.html._assets import _CascadingStyleSheet
-    context['css_files'] += [_CascadingStyleSheet(f'_static/{pagename}.css')]
+latex_engine = "xelatex"
+
+# def add_page_class(app, pagename, templatename, context, doctree):
+#     from sphinx.builders.html._assets import _CascadingStyleSheet
+#     context['css_files'] += [_CascadingStyleSheet(f'_static/{pagename}.css')]
 
 def setup(app):
     # Register a sphinx.ext.autodoc.between listener to ignore everything
@@ -89,5 +91,5 @@ def setup(app):
         'autodoc-process-docstring',
         between('^.*[*]{79}.*$', exclude=True)
     )
-    app.connect('html-page-context', add_page_class)
+    # app.connect('html-page-context', add_page_class)
     return app

doc/source/_static/style.css

@@ -1,8 +1,11 @@
 .. include:: ./refs.rst
+.. role:: big
+.. role:: extrabig
+
+.. we use big role instead of index because a TOC on this page screws up the latex page generation
+
+:extrabig:`Django Typer`
 
-============
-Django Typer
-============
 
 Use Typer_ to define the CLI for your Django_ management commands. Provides a TyperCommand class
 that inherits from BaseCommand_ and allows typer-style annotated parameter types. All of the
@@ -22,9 +25,7 @@ BaseCommand functionality is preserved, so that TyperCommand can be a drop in re
    * Refactor existing management commands into TyperCommands because TyperCommand is interface
      compatible with BaseCommand.
 
-
-Installation
-------------
+:big:`Installation`
 
 1. Clone django-typer from GitHub_ or install a release off PyPI_ :
 
@@ -50,8 +51,7 @@ Installation
         ]
 
 
-Basic Example
--------------
+:big:`Basic Example`
 
 For example TyperCommands can be a very simple drop in replacement for BaseCommands. All of the
 documented features of BaseCommand_ work!
@@ -70,8 +70,7 @@ documented features of BaseCommand_ work!
 
 |
 
-Multiple Subcommands Example
-----------------------------
+:big:`Multiple Subcommands Example`
 
 Or commands with multiple subcommands can be defined:
 
@@ -90,8 +89,7 @@ Or commands with multiple subcommands can be defined:
 |
 
 
-Grouping and Hierarchies Example
---------------------------------
+:big:`Grouping and Hierarchies Example`
 
 Or more complex groups and subcommand hierarchies can be defined. For example this command
 defines a group of commands called math, with subcommands divide and multiply. The group

doc/source/changelog.rst

@@ -6,8 +6,15 @@
 Shell Tab-Completions
 =====================
 
-.. image:: /_static/img/closepoll_example.gif
-   :align: center
+.. only:: html
+
+    .. image:: /_static/img/closepoll_example.gif
+        :align: center
+
+.. only:: latex
+
+    .. image:: /_static/img/closepoll_example.png
+        :align: center
 
 |
 

doc/source/conf.py

@@ -11,8 +11,15 @@ to define the command's command line interface instead of argparse_ as BaseComma
 Upstream Libraries
 ------------------
 
-.. image:: /_static/img/django_typer_upstream.svg
-   :align: right
+.. only:: html
+
+    .. image:: /_static/img/django_typer_upstream.svg
+        :align: right
+
+.. only:: latex
+
+    .. image:: /_static/img/django_typer_upstream.pdf
+        :align: right
 
 django-typer_ merges the Django_ BaseCommand_ interface with the Typer_ interface and Typer_ itself
 is built on top of click_. This means when using django-typer_ you will encounter interfaces and
@@ -410,5 +417,12 @@ closepoll command looks like:
                     poll.delete()
 
 
-.. image:: /_static/img/closepoll_example.gif
-   :align: center
+.. only:: html
+
+    .. image:: /_static/img/closepoll_example.gif
+        :align: center
+
+.. only:: latex
+
+    .. image:: /_static/img/closepoll_example.png
+        :align: center