File: Installation.rst

package info (click to toggle)
pdfposter 0.7.post1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster
  • size: 400 kB
  • sloc: python: 521; makefile: 23
file content (93 lines) | stat: -rw-r--r-- 3,007 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

Download & Installation
=========================

Instructions for Windows Users
-----------------------------------

1. |pdfposter| requires Python. If you don't have Python installed already,
   download and install Python 3.6 from https://python.org/download/3.6/

   During installation, make sure to check "Include into PATH".

2. If you already have Python installed, please check that your Python
   directory (normally :file:`C:\\Python36` for python 3.6) and the Python
   Scripts directory (normally :file:`C:\\Python36\\Scripts`) are in the system
   path. If not, just add them in :menuselection:`My Computer --> Properties
   --> Advanced --> Environment Variables` to the :envvar:`Path` system
   variable.

3. Install |pdfposter| by running ::

     pip install pdftools.pdfposter

   Then run the console command ``pdfposter --help`` to get detailed help.

   If the command ``pip`` is unknown to you system, please refer to the
   `pip homepage <https://pip.pypa.io/en/stable/installing/>`_ for help.


Instructions for GNU/Linux and other Operating Systems
--------------------------------------------------------

Most current GNU/Linux distributions provide packages for |pdfposter|.
Simply search your distribution's software catalog.

Also many vendors provide Python, and some even provide |pdfposter|.
Please check your vendor's software repository.

If your distribution or vendor does not provide a current version of
|pdfposter| please read on.

If your vendor does not provide :command:`python`
please download Python 3.6 from https://www.python.org/download/ and
follow the installation instructions there.

If you distribution or vendor missed providing :command:`pip`,
alongside :command:`python`,
please check your vendor's or distribution's software repository
for a package called `pip` or `python-pip`.
If this is not provided, please refer to the
`pip homepage <https://pip.pypa.io/en/stable/installing/>`_ for help.


Optionally you might want to install `PyPDF2`
- which is a requirement for |pdfposter| -
provided by your distribution or vendor
so at least this package will be maintained by your distribution.
Check for a package named ``python-pypdf2`` or that like.

Then continue with :ref:`installing pdfposter` below.


.. _installing pdfposter:

Installing |pdfposter| using :command:`pip`
---------------------------------------------

After installing `Python` (and optionally `PyPDF2`), just run::

  sudo pip install pdftools.pdfposter

to install |pdfposter| for all users.
For installing |pdfposter| for yourself only, run::

  pip install --user pdftools.pdfposter

If your system does not have network access
  
- download |pdfposter| from https://pypi.org/project/pdftools.pdfposter/,

- downlaod `PyPDF2` from https://pypi.org/project/PyPDF2/, and

- run ::

    sudo pip install pdftools.pdfposter-*.tar.gz PyPDF2-*.tar.gz

  respective ::

    pip install --user pdftools.pdfposter-*.tar.gz PyPDF2-*.tar.gz


.. include:: _common_definitions.txt