aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2021-12-18 19:37:11 +0100
committerJay Berkenbilt <ejb@ql.org>2021-12-18 19:37:11 +0100
commit0e6b6a240bc071dc3d74ae21eac24799361199a0 (patch)
tree226617407762d7b1195d49cc5b9fe4fae2c694b4
parentc9d54fda518db58f7f610c6af5a69e316c07a52d (diff)
downloadqpdf-0e6b6a240bc071dc3d74ae21eac24799361199a0.tar.zst
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.
-rw-r--r--manual/cli.rst24
-rw-r--r--manual/conf.py2
-rw-r--r--manual/installation.rst2
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