summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2019-04-28 21:38:05 +0200
committerGitHub <noreply@github.com>2019-04-28 21:38:05 +0200
commitf9a3754b0d5ae41dade03f61532c1ceedf44cd69 (patch)
tree8cc619ff8d9e342be5b14750d3e16d1e479a3fe0 /README.md
parentfebde3b40d3a68de63ee458b6fdafa75011a6f64 (diff)
parent46ea8e770b23d9aac83fc21a7656355045cc0630 (diff)
downloadvyos-documentation-f9a3754b0d5ae41dade03f61532c1ceedf44cd69.tar.gz
vyos-documentation-f9a3754b0d5ae41dade03f61532c1ceedf44cd69.zip
Merge pull request #41 from kmpm/features/autobuild
Add sphinx-autobuild to docker
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
index 87484405..009cdbc7 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,17 @@ Required Debian Packages:
* `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
@@ -34,4 +45,16 @@ $ docker build -t vyos-docu docker
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 make livehtml
+```
+