blob: 4815e495bd8aad03fc459f382332fb6861f3188f (
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
|
This is a playground for a new VyOS documentation starting for VyOS 1.2 (Crux)
release.
# Build
## Native
To build the manual run the following commands inside the `docs` folder:
* `make html` for a HTML manual
* `make latexpdf` for a LaTeX rendered PDF
Required Debian Packages:
* `python-sphinx`
* `python-sphinx-rtd-theme`
* `latexmk`
* `texlive-latex-recommended`
* `texlive-fonts-recommended`
* `texlive-latex-extra`
### sphinx-autobuild
Required extra setup procedure on Debian:
```bash
sudo apt-get install python-pip
sudo pip install sphinx-autobuild
```
To build and run a webeserver, inside the `docs` folder:
* `make livehtml` and browse to http://localhost:8000
## Docker
Using our [Dockerfile](docker/Dockerfile) you create your own Docker container
that is used to build a VyOS documentation.
## Setup
```bash
$ docker build -t vyos-docu docker
```
### Build
Linux
```bash
$ docker run --rm -it -v "$(pwd)":/vyos -w /vyos/docs -e GOSU_UID=$(id -u) -e GOSU_GID=$(id -g) vyos-docu make html
# sphinx autobuild
$ docker run --rm -it -p 8000:8000 -v "$(pwd)":/vyos -w /vyos/docs -e GOSU_UID=$(id -u) -e GOSU_GID=$(id -g) vyos-docu make livehtml
```
Windows
```powershell
docker run --rm -it -v "$(pwd):/vyos" -w /vyos/docs vyos-docu make html
# sphinx autobuild
docker run --rm -it -p 8000:8000 -v "$(pwd):/vyos" -w /vyos/docs vyos-docu vyos-docu make livehtml
```
|
