summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorPeter Magnusson <peter@wselcon.se>2019-04-24 15:46:47 +0200
committerPeter Magnusson <peter@wselcon.se>2019-04-24 15:46:47 +0200
commit51224704728993f9825d538a0d50f5dd9312b22e (patch)
treef01a1cffb9fe2776f61ba6cfc82c3bae87bc152b /README.md
parentf5008037d4d0ebd479944d05f8f26bd01cbf6767 (diff)
downloadvyos-documentation-51224704728993f9825d538a0d50f5dd9312b22e.tar.gz
vyos-documentation-51224704728993f9825d538a0d50f5dd9312b22e.zip
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..4815e495 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 vyos-docu make livehtml
+```
+