summaryrefslogtreecommitdiffstats
path: root/docs/README.md
blob: 431d1b814fbeb7969f3025aeddc48e7fd310c411 (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
# Building Documents

These instructions show how documentation sources are built.

To build your files, you can either Create a Virtual Environment using
virtualenv, which installs all the required applications for you.

# Create a Virtual Environment using virtualenv

For more information on how to use the Python virtual environment check
out <https://packaging.python.org/guides/installing-using-pip-and-virtualenv>

# Get the Documents

For example start with a clone of the hicn.

```bash
$ git clone <https://gerrit.fd.io/r/hicn>
$ cd hicn
```

# Install the virtual environment

```bash
$ python3 -m pip install --user virtualenv
$ python3 -m virtualenv env
$ source env/bin/activate
$ pip install -r docs/etc/requirements.txt
$ cd docs
```

Which installs all the required applications into its own, isolated,
virtual environment, so as to not interfere with other builds that may
use different versions of software.

# Build the html files

Be sure you are in your hicn/docs directory, since that is where Sphinx will
look for your conf.py file, and build the documents into an index.html file

```bash
$ make html
```

# View the results

If there are no errors during the build process, you should now have an
index.html file in your hicn/docs/build/html directory, which you can
then view in your browser.