aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
blob: 1f1bb63e75825d15b0cffe61d01db24d2bc9c970 (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
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
========
SleepMap
========

This is the source code repository for https://sleepmap.de

|nikola| is used to generate the static content from this source code
repository. Have a look at its |handbook| for more information.

Installing nikola
#################

To install nikola, either use your distributions package manager:

  .. code:: bash

    # Arch Linux example
    pacman -S nikola

    # Ubuntu/Debian example
    apt-get install nikola

Alternatively, you can install it via pip3:

  .. code:: bash

    pip3 install --user nikola

If installing through pip, make sure to add *~/.local/bin* to your **$PATH**
afterwards (if that's not already the case):

  .. code:: bash

    # ~/.bash_profile
    export PATH="${HOME}/.local/bin:${PATH}"


Working with the code base
##########################

Build the website:

  .. code:: bash

    nikola build

To run the website locally:

  .. code:: bash

    nikola serve

To deploy the website to its webserver destination:

  .. code:: bash

    nikola deploy

| You need to have a valid ssh key on the remote host machine.
| Please make sure to add the latest deploy and push it to the repository:

  .. code:: bash

    git add state_data.json
    git commit -m "state_data.json: Deployed website."
    git push


.. |nikola| raw:: html

  <a href="https://getnikola.com/" target="_blank">Nikola</a>

.. |handbook| raw:: html

  <a href="https://getnikola.com/handbook.html" target="_blank">handbook</a>