Commit 0e6b6a240bc071dc3d74ae21eac24799361199a0

Authored by Jay Berkenbilt
1 parent c9d54fda

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
... ... @@ -13,7 +13,7 @@ Basic Invocation
13 13  
14 14 When running qpdf, the basic invocation is as follows:
15 15  
16   -::
  16 +.. code-block:: text
17 17  
18 18 qpdf [ options ] { infilename | --empty } outfilename
19 19  
... ... @@ -456,7 +456,7 @@ Encryption Options
456 456 To change the encryption parameters of a file, use the --encrypt flag.
457 457 The syntax is
458 458  
459   -::
  459 +.. code-block:: text
460 460  
461 461 --encrypt user-password owner-password key-length [ restrictions ] --
462 462  
... ... @@ -620,7 +620,7 @@ selecting pages from one or more input files. Whatever file is given as
620 620 the primary input file is used as the starting point, but its pages are
621 621 replaced with pages as specified.
622 622  
623   -::
  623 +.. code-block:: text
624 624  
625 625 --pages input-file [ --password=password ] [ page-range ] [ ... ] --
626 626  
... ... @@ -761,7 +761,7 @@ copying all of that from the first file. For example, to take pages 1
761 761 through 5 from a :file:`infile.pdf` while preserving
762 762 all metadata associated with that file, you could use
763 763  
764   -::
  764 +.. code-block:: text
765 765  
766 766 qpdf infile.pdf --pages . 1-5 -- outfile.pdf
767 767  
... ... @@ -769,7 +769,7 @@ If you wanted pages 1 through 5 from
769 769 :file:`infile.pdf` but you wanted the rest of the
770 770 metadata to be dropped, you could instead run
771 771  
772   -::
  772 +.. code-block:: text
773 773  
774 774 qpdf --empty --pages infile.pdf 1-5 -- outfile.pdf
775 775  
... ... @@ -778,7 +778,7 @@ If you wanted to take pages 1 through 5 from
778 778 :file:`file2.pdf` in reverse, taking document-level
779 779 metadata from :file:`file2.pdf`, you would run
780 780  
781   -::
  781 +.. code-block:: text
782 782  
783 783 qpdf file2.pdf --pages file1.pdf 1-5 . 15-11 -- outfile.pdf
784 784  
... ... @@ -787,11 +787,13 @@ file called :file:`encrypted.pdf` with password
787 787 ``pass`` and repeat it twice in an output file, and if you wanted to
788 788 drop document-level metadata but preserve encryption, you would use
789 789  
790   -::
  790 +.. code-block:: text
791 791  
792   - qpdf --empty --copy-encryption=encrypted.pdf --encryption-file-password=pass
793   - --pages encrypted.pdf --password=pass 1 ./encrypted.pdf --password=pass 1 --
794   - outfile.pdf
  792 + qpdf --empty --copy-encryption=encrypted.pdf \
  793 + --encryption-file-password=pass \
  794 + --pages encrypted.pdf --password=pass 1 \
  795 + ./encrypted.pdf --password=pass 1 -- \
  796 + outfile.pdf
795 797  
796 798 Note that we had to specify the password all three times because giving
797 799 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
823 825 other files onto the output generated by qpdf. Specify overlay or
824 826 underlay as follows:
825 827  
826   -::
  828 +.. code-block:: text
827 829  
828 830 { --overlay | --underlay } file [ options ] --
829 831  
... ...
manual/conf.py
... ... @@ -11,7 +11,7 @@ project = 'QPDF'
11 11 copyright = '2005-2021, Jay Berkenbilt'
12 12 author = 'Jay Berkenbilt'
13 13 release = '10.4.0'
14   -html_theme = 'agogo'
  14 +html_theme = 'nature'
15 15 html_theme_options = {
16 16 "body_max_width": None,
17 17 }
... ...
manual/installation.rst
... ... @@ -75,7 +75,7 @@ Build Instructions
75 75  
76 76 Building qpdf on UNIX is generally just a matter of running
77 77  
78   -::
  78 +.. code-block:: text
79 79  
80 80 ./configure
81 81 make
... ...