From 0e6b6a240bc071dc3d74ae21eac24799361199a0 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sat, 18 Dec 2021 13:37:11 -0500
Subject: [PATCH] Change html theme again, fix code blocks

The agogo theme doesn't do very well on narrow screens. The code
blocks were used for shell commands but were using Python syntax
highlighting.
---
 manual/cli.rst          | 24 +++++++++++++-----------
 manual/conf.py          |  2 +-
 manual/installation.rst |  2 +-
 3 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/manual/cli.rst b/manual/cli.rst
index 93dcf454..56af6a9c 100644
--- a/manual/cli.rst
+++ b/manual/cli.rst
@@ -13,7 +13,7 @@ Basic Invocation
 
 When running qpdf, the basic invocation is as follows:
 
-::
+.. code-block:: text
 
    qpdf [ options ] { infilename | --empty } outfilename
 
@@ -456,7 +456,7 @@ Encryption Options
 To change the encryption parameters of a file, use the --encrypt flag.
 The syntax is
 
-::
+.. code-block:: text
 
    --encrypt user-password owner-password key-length [ restrictions ] --
 
@@ -620,7 +620,7 @@ selecting pages from one or more input files. Whatever file is given as
 the primary input file is used as the starting point, but its pages are
 replaced with pages as specified.
 
-::
+.. code-block:: text
 
    --pages input-file [ --password=password ] [ page-range ] [ ... ] --
 
@@ -761,7 +761,7 @@ copying all of that from the first file. For example, to take pages 1
 through 5 from a :file:`infile.pdf` while preserving
 all metadata associated with that file, you could use
 
-::
+.. code-block:: text
 
    qpdf infile.pdf --pages . 1-5 -- outfile.pdf
 
@@ -769,7 +769,7 @@ If you wanted pages 1 through 5 from
 :file:`infile.pdf` but you wanted the rest of the
 metadata to be dropped, you could instead run
 
-::
+.. code-block:: text
 
    qpdf --empty --pages infile.pdf 1-5 -- outfile.pdf
 
@@ -778,7 +778,7 @@ If you wanted to take pages 1 through 5 from
 :file:`file2.pdf` in reverse, taking document-level
 metadata from :file:`file2.pdf`, you would run
 
-::
+.. code-block:: text
 
    qpdf file2.pdf --pages file1.pdf 1-5 . 15-11 -- outfile.pdf
 
@@ -787,11 +787,13 @@ file called :file:`encrypted.pdf` with password
 ``pass`` and repeat it twice in an output file, and if you wanted to
 drop document-level metadata but preserve encryption, you would use
 
-::
+.. code-block:: text
 
-   qpdf --empty --copy-encryption=encrypted.pdf --encryption-file-password=pass
-   --pages encrypted.pdf --password=pass 1 ./encrypted.pdf --password=pass 1 --
-   outfile.pdf
+   qpdf --empty --copy-encryption=encrypted.pdf \
+        --encryption-file-password=pass \
+        --pages encrypted.pdf --password=pass 1 \
+              ./encrypted.pdf --password=pass 1 -- \
+        outfile.pdf
 
 Note that we had to specify the password all three times because giving
 a password as :samp:`--encryption-file-password` doesn't
@@ -823,7 +825,7 @@ Starting with qpdf 8.4, it is possible to overlay or underlay pages from
 other files onto the output generated by qpdf. Specify overlay or
 underlay as follows:
 
-::
+.. code-block:: text
 
    { --overlay | --underlay } file [ options ] --
 
diff --git a/manual/conf.py b/manual/conf.py
index be8357d6..32800305 100644
--- a/manual/conf.py
+++ b/manual/conf.py
@@ -11,7 +11,7 @@ project = 'QPDF'
 copyright = '2005-2021, Jay Berkenbilt'
 author = 'Jay Berkenbilt'
 release = '10.4.0'
-html_theme = 'agogo'
+html_theme = 'nature'
 html_theme_options = {
     "body_max_width": None,
 }
diff --git a/manual/installation.rst b/manual/installation.rst
index 568c2e20..470e6858 100644
--- a/manual/installation.rst
+++ b/manual/installation.rst
@@ -75,7 +75,7 @@ Build Instructions
 
 Building qpdf on UNIX is generally just a matter of running
 
-::
+.. code-block:: text
 
    ./configure
    make