summaryrefslogtreecommitdiff
path: root/INSTALL
blob: a8d6138d66fa79860d4b4a5e02be22d7c41a436e (plain)
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
# Quick Start

## Installing Plinth

Install the python-cheetah package, pandoc, python-augeas, and
bjsonrpc:

apt-get install python-cheetah pandoc python-augeas python-bjsonrpc python-cherrypy3 python-simplejson

Unzip and untar the source into a directory.  Change to the directory
containing the program. Run:

    $ make

To start Plinth, run:

    $ ./start.sh

and point your web browser at `localhost:8000`. The default username is "admin"
and the default password is "secret".

## Dependencies

* cherrypy - python web engine v3+

* cheetah - Debian has python-cheetah package

* python - tested with version 2.6.6

* *GNU Make* is used to build the templates and such.

* bjsonrpc - used for configuration management layer

* python-augeas and augeas - used for configuration management

The documentation has some dependencies too.

* *Markdown* is used to format and style docs.

* *Pandoc* converts the markdown to different formats.

* *PDFLatex* generates pdf versions of the documentation.

* *GNU Make* processes /doc/Makefile.

## Building the Documentation

Documentation has been collected into a pdf that can be built using
`make doc`.  It also gets built into smaller files and other formats,
including one suitable for install as a man page.