summaryrefslogtreecommitdiffstats
path: root/docs/install/index.rst
blob: 6dd9f72a97a75300aef554d6fc2217db3cb49009 (plain) (blame)
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
.. highlight:: shell

Installation
------------

On a Debian based distribution, do::

  $ sudo apt-get install python-pip

On GNU Guix, do::

  $ guix package -i python-pip


Install globally
~~~~~~~~~~~~~~~~

::

   $ sudo pip install lpschedule-generator


Install locally using virtualenv
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First get ``virtualenv``.

On a Debian based distribution, do::

  $ sudo apt-get install python-virtualenv

On GNU Guix, do::

  $ guix package -i python-virtualenv

Make a separate ``lpschedule-generator`` directory and initialize the
virtual environment in it::

  $ mkdir lpschedule-generator
  $ cd lpschedule-generator

  $ virtualenv -p python3 .
  $ source bin/activate

Install ``lpschedule-generator`` inside this directory using ``pip``::

  $ pip install lpschedule-generator

Activating virtual environment
``````````````````````````````

Always activate the virtual environment before using the ``lps_gen``
command::

   $ cd path/to/lpschedule-generator
   $ source bin/activate


Test
~~~~

Do::

  $ lps_gen --help

.. highlight:: text

You must get::

  usage: lps_gen [-h] [-sc | -sp] [--ical ICAL] [--version] lp_md

  positional arguments:
    lp_md            Path to the LP markdown.

  optional arguments:
    -h, --help       show this help message and exit
    -sc, --schedule  Generate LP schedule
    -sp, --speakers  Generate LP speakers
    --ical ICAL      Specify LP year as argument; generates iCal
    --version        Show version number and exit.

If the ``lps_gen`` command is installed, move to the :ref:`next
section <lps-doc-sec-schedule>`; otherwise ask for
:ref:`lps-doc-sec-help`.